Kort sagt: Appen fungerade – Docker försökte skriva sin CLI-konfiguration till ZimaOS skrivskyddade rot
Compose-stacken fungerade redan på en annan maskin. På ZimaOS misslyckades den med mkdir /root/.docker: read-only file system. Genom att ange DOCKER_CONFIG till en skrivbar plats löstes det verkliga problemet.
För en tillfällig app använder du en skrivbar sökväg för Docker-konfigurationen
sudo -i
mkdir -p /var/lib/docker/.docker
export DOCKER_CONFIG=/var/lib/docker/.docker
docker compose up -dKommandot fungerade i det verkliga fallet eftersom Docker inte längre försökte skapa /root/.docker på apparatens rotfilsystem. Docker dokumenterar miljövariabeln DOCKER_CONFIG i sin Docker CLI-konfiguration.
För en återanvändbar ZimaOS-app paketerar du Compose-filen korrekt
Aktuella ZimaOS använder vanlig Docker Compose för körningsinställningar och ett toppnivåblock med x-casaos för appbutikens metadata. ZimaOS appmetadata definierar de aktuella v2-fälten.
Det uppströms Docker Compose-schemat är fortfarande den auktoritativa källan för körningen.
Varför gränssnittet inte kunde använda den lokalt uppladdade avbildningen
Installationsflödet i appbutiken förväntar sig en avbildningsreferens som det kan hitta via appdefinitionen. En manuellt inläst lokal avbildning kan finnas i Docker utan att ändå uppfylla appbutikens installationsflöde. För en privat app i hemmet är direkt Compose enklare; för distribution publicerar du avbildningen i ett register eller bygger ett korrekt ZimaOS-apppaket.
Förvara applikationsdata på skrivbar lagring
Mappa databaser, uppladdningar och konfiguration till beständiga värdsökvägar. Portainer-kraven är ett alternativ för manuellt hanterade Docker-arbetsbelastningar.
Använd butiksprotokollet endast när du behöver butiksfunktioner
Om målet är en enkel app för familjens inköpslista räcker direkt Compose. Om målet är distribution via en installerbar katalog med ikoner, metadata och uppdateringar använder du den aktuella appbutiksstrukturen för ZimaOS v2. ZimaOS appkrav ger distributionskontexten.
