Obțineți COD Collabora care rulează pe ARM64 cu imaginea corectă

Un container CODE Collabora care se închide imediat pe o gazdă ARM64 folosește adesea platforma de imagine greșită, dar ARM64 în sine nu este în mod inerent neacceptat. Începeți prin a verifica numărul de biți al gazdei, manifestul publicat al etichetei exacte a imaginii și orice suprascriere a platformei Compose înainte de a modifica permisiunile sau a reconstrui imaginea. Conform verificării din 10 octombrie 2026, imaginea CODE oficială include versiuni ARM64; Docker Hub listează eticheta 26.04.4.2.1pentru linux/arm64.

1. Identificați arhitectura gazdă și eroarea exactă de pornire

Executați aceste comenzi pe gazda Docker, nu în interiorul containerului Collabora oprit. Înlocuiți collaboradacă serviciul dvs. Compose folosește un alt nume:

uname -m
docker info --format '{{.Architecture}}'
docker compose ps -a
docker compose logs --tail=100 collabora

O gazdă ARM Linux pe 64 de biți raportează de obicei aarch64de la uname -m. O valoare precum armv7lidentifică de obicei o platformă de kernel ARM pe 32 de biți, care este diferită de linux/arm64. Eticheta de arhitectură a Docker poate folosi o altă ortografie, așadar comparați tipul de gazdă, configurația Compose și manifestul imaginii, în loc să potriviți mecanic un șir de caractere.

Citiți primul mesaj fatal și starea de ieșire. „No matching manifest for linux/arm64” înseamnă că eticheta selectată nu are o variantă potrivită pentru platforma solicitată. „Exec format error” sugerează o nepotrivire de arhitectură sau o platformă externă forțată explicit. O eroare de permisiune sau o închidere din cauza memoriei insuficiente are o cauză diferită; nu tratați fiecare buclă de repornire ca o eroare de compatibilitate ARM.

2. Confirmați că eticheta publică o imagine ARM64

Verificați eticheta din registru înainte de a schimba gazda:

docker buildx imagetools inspect collabora/code:26.04.4.2.1

Căutați linux/arm64în lista de platforme. Pe 10 octombrie 2026, lista oficială de etichete Docker Hub arăta platforma pentru ambele latestși . Pagina de COD26.04.4.2.1 a Collabora identifică x86-64, ppc64 și arm64 ca arhitecturi gazdă acceptate. Eticheta versionată este mai ușor de reprodus în timpul depanării. Etichetele și manifestele se pot schimba, așa că inspectați versiunea exactă pe care intenționați să o implementați în loc să presupuneți că fiecare etichetă istorică are aceleași arhitecturi.

Docker selectează automat o variantă potrivită atunci când eticheta este multi-platformă și nicio suprascriere nu modifică ținta. Comanda de inspecție a imaginii din Docker afișează platformele publicate pentru o imagine de registry.

3. Eliminați o suprascriere AMD64 și extrageți varianta nativă

Verificați serviciul Compose rezolvat, inclusiv fișierele de suprascriere, pentru o eroare forțată platform: linux/amd64. Variabila Docker CLI DOCKER_DEFAULT_PLATFORMpoate seta, de asemenea, platforma implicită pentru comenzile care acceptă un indicator de platformă. platformCâmpul Compose selectează explicit sistemul de operare și arhitectura țintă, așadar eliminați o suprascriere incorectă sau setați-o la ARM64. Dacă aveți [număr de eroare] jq, inspectați setările îmbinate fără a afișa valori de mediu fără legătură: [număr de eroare] docker compose config --format json | jq '.services.collabora | {image, platform}'. Referința serviciului Compose definește acest câmp. [număr DOCKER_DEFAULT_PLATFORMde eroare] este documentată în referința Docker CLI .

services:
  collabora:
    image: collabora/code:26.04.4.2.1
    platform: linux/arm64

Acesta este un fragment: îmbinați liniile de imagine și platformă în serviciul existent și păstrați setările necesare. Dacă Docker selectează deja corect manifestul ARM64 nativ, platformlinia este opțională. Înlocuiți collaboraîn comenzile de mai jos dacă serviciul dvs. Compose are un alt nume.

docker compose pull collabora
docker compose up -d --force-recreate collabora

Folosește eticheta fixată așa cum se arată sau o altă versiune al cărei manifest tocmai l-ai verificat. latest-arm64Eticheta este, de asemenea, listată de Docker Hub, dar conținutul său se modifică pe măsură ce versiunile se modifică. Fixarea unei versiuni face ca o revenire la versiune și o comparație ulterioară să fie mai previzibile. Evită să forțezi emularea linux/amd64sub versiune ca primă soluție atunci când este disponibilă o imagine ARM64 nativă; emularea adaugă costuri suplimentare și face ca diagnosticarea la pornire să fie mai puțin directă.

4. Diagnosticați erorile care nu țin de arhitectură, apoi verificați pornirea

Dacă imaginea nativă există în continuare, utilizați jurnalul și starea în loc să extindeți privilegiile containerului:

Folosește numele sau ID-ul containerului afișat de docker compose ps -apentru a inspecta starea sa de ieșire:

docker inspect --format 'status={{.State.Status}} exit={{.State.ExitCode}} oom={{.State.OOMKilled}} error={{.State.Error}}' CONTAINER

Docker documentează inspecția containerelor și jurnalele containerelor pentru aceste verificări. Nu ștergeți volumele persistente și nu acordați privilegii întregului container doar pentru a testa o problemă de arhitectură.

Verificați imaginea extrasă și serviciul care rulează

Confirmați că imaginea locală raportează arhitectura țintă:

docker image inspect collabora/code:26.04.4.2.1 --format '{{.Os}}/{{.Architecture}}'

Valoarea așteptată este linux/arm64. Apoi, verificați docker compose ps -adacă starea de funcționare este stabilă și examinați cele mai recente jurnale pentru erori fatale de pornire. După ce containerul este conectat la platforma de stocare sau la proxy-ul invers, solicitați /hosting/discoveryprin URL-ul Collabora configurat și deschideți un document de test. Verificați din nou lista de etichete a registrului înainte de actualizări, deoarece versiunile disponibile și manifestele platformei se pot modifica.