sh: can't create /usr/share/nginx/html/nou.html: Read-only file system
Folderul în care scrii e montat doar pentru citire: un bind mount sau volum cu :ro, --mount ...,readonly sau un container pornit cu --read-only. Scrie fișierul pe calculator, în folderul montat (modificarea apare imediat în container), sau montează fără :ro dacă scrierea din container chiar e necesară.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la sistemul de operare din container: scrierea a fost refuzată nu din cauza permisiunilor utilizatorului (asta ar fi Permission denied), ci pentru că tot sistemul de fișiere de la acea cale e montat doar pentru citire. Nici root nu poate scrie acolo.
În Docker, asta apare în trei situații: ai montat un folder cu -v sursa:destinatie:ro (sau readonly la --mount), containerul rulează cu --read-only (tot sistemul de fișiere al containerului e doar citire, mai puțin volumele și --tmpfs), ori folosești un volum montat :ro în compose.yaml.
De obicei montarea doar pentru citire e intenționată, pentru siguranță: serverul web nu are de ce să-și modifice fișierele. Atunci reparația corectă nu e să scoți :ro, ci să modifici fișierele la sursă (pe calculator) sau să dai aplicației un loc separat, scriibil, pentru datele ei (un volum sau --tmpfs /tmp).
De ce apare: cauzele frecvente
1Scrii într-un bind mount montat :ro
docker run -d -v ~/site:/usr/share/nginx/html:ro nginx
docker exec web sh -c 'echo nou > /usr/share/nginx/html/nou.html'echo '<p>nou</p>' > ~/site/nou.html
curl -s localhost:8080/nou.htmlFolderul e același pe calculator și în container. Scrii pe calculator, unde nu e restricționat, iar nginx vede fișierul imediat.
2Container pornit cu --read-only fără loc pentru fișiere temporare
docker run -d --read-only magazin-api:1.0
# EROFS: read-only file system, open '/tmp/sesiune'docker run -d --read-only --tmpfs /tmp magazin-api:1.0--tmpfs montează un folder în memorie, scriibil, doar pentru calea de care aplicația are nevoie.
3Aplicația chiar trebuie să scrie în folder
docker run -d -v ~/incarcari:/app/uploads:ro magazin-api:1.0docker run -d -v ~/incarcari:/app/uploads magazin-api:1.0Dacă folderul e pentru încărcări sau date ale aplicației, nu-l monta :ro.
Repară eroarea, direct în pagină
Serverul site servește folderul ~/site montat doar pentru citire (:ro) în nginx, pe portul 8080. Încercarea de a adăuga pagina promotii.html din container a dat Read-only file system. Păstrează montarea :ro și publică totuși pagina promotii.html cu textul Reduceri de iarnă, astfel încât curl localhost:8080/promotii.html s-o afișeze.
Indiciu
Un bind mount e același folder pe calculator și în container: scrie fișierul în ~/site.
Reparația
Scrie fișierul pe calculator, în folderul montat:
echo '<h1>Reduceri de iarnă</h1>' > ~/site/promotii.html
curl -s localhost:8080/promotii.html<h1>Reduceri de iarnă</h1>Montarea rămâne :ro: containerul tot nu poate modifica fișierele site-ului.
De ce merge
Montarea :ro blochează orice scriere din container, inclusiv ca root, și e o protecție bună pentru fișierele unui site. Un bind mount nu copiază însă fișierele: containerul vede chiar folderul ~/site de pe calculator. Când creezi promotii.html acolo, unde nu există restricția, nginx îl servește imediat, fără să schimbi containerul.
Alte forme ale mesajului
touch: /date/a.txt: Read-only file systemError: EROFS: read-only file system, open '/app/logs/app.log'OSError: [Errno 30] Read-only file system: '/app/cache'
Cum o eviți pe viitor
Separă clar ce e cod sau configurare (montat :ro sau copiat în imagine) de ce sunt date scrise de aplicație (volume dedicate, scriibile). Când pornești containere cu --read-only pentru siguranță, adaugă de la început --tmpfs /tmp și volume pentru folderele de date. docker inspect -f '{{json .Mounts}}' nume îți arată ce e montat și cu ce mod ("RW": false înseamnă doar citire).
Întrebări frecvente
E la fel cu Permission denied?
Nu. Permission denied înseamnă că utilizatorul din container n-are drepturi pe fișier, deși sistemul de fișiere e scriibil (se rezolvă cu chown/USER/-u). Read-only file system înseamnă că nimeni nu poate scrie la acea cale, nici root.
Pot scoate :ro dintr-un container care rulează?
Nu, montările se stabilesc la crearea containerului. Ca să schimbi modul, recreezi containerul cu altă opțiune -v.
Erori înrudite
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.47/containers/json": dial unix /var/run/docker.sock: connect: permission denied Daemon-ul rulează, dar utilizatorul tău nu are voie să scrie în socket-ul /var/run/docker.sock. Adaugă-te în grupul docker cu sudo usermod -aG docker $USER, apoi deloghează-te și loghează-te din nou (sau rulează newgrp docker). docker: Error response from daemon: unable to find user app: no matching entries in passwd file. Utilizatorul dat la -u sau la USER în Dockerfile nu există în /etc/passwd al imaginii. Creează-l în Dockerfile (RUN addgroup -S app && adduser -S -G app app) înainte de USER, sau folosește un utilizator existent (node, nobody) ori un uid numeric. curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server Pe calculator nu ascultă nimic pe portul 8080: containerul nu publică portul (lipsește -p 8080:80), e oprit sau portul din dreapta nu e cel pe care ascultă aplicația. Verifică cu docker ps coloana PORTS și recreează containerul cu -p 8080:80. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
