...
Eroare Kubernetes · ConfigMap, Secret, namespace-uri și cote

sh: can't create /config/stare: Read-only file system

Pe scurt

Aplicația încearcă să scrie într-un folder montat dintr-un ConfigMap sau Secret, care e întotdeauna doar pentru citire. Scrie fișierele de lucru într-un volum separat (emptyDir sau PVC) și lasă ConfigMap-ul doar pentru configurare.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Volumele de tip ConfigMap, Secret, downwardAPI și projected sunt montate read-only: conținutul lor vine din API server și nu poate fi schimbat din container. Orice scriere (creare de fișier, modificare, ștergere) eșuează cu Read-only file system (EROFS). Mesajul exact depinde de program: sh: can't create, cp: can't create, EROFS: read-only file system în Node, OSError: [Errno 30] în Python.

Cazuri tipice: aplicația scrie un fișier de stare, un cache sau un jurnal lângă fișierul de configurare, sau un script de pornire modifică configurația pe loc (de exemplu cu sed -i).

Soluția: un volum în care se poate scrie, montat în alt folder. Pentru configurații care trebuie modificate la pornire, un init container copiază fișierul din ConfigMap într-un emptyDir, unde aplicația îl poate schimba.

De ce apare: cauzele frecvente

1Fișier de stare scris în folderul ConfigMap

Greșit
YAML
        command: ["sh", "-c", "echo pornit > /config/stare; sleep 3600"]
Corect
YAML
        command: ["sh", "-c", "echo pornit > /date/stare; sleep 3600"]
        volumeMounts:
        - name: date
          mountPath: /date

/date e un emptyDir, în care se poate scrie.

2Configurație modificată pe loc

Greșit
YAML
sed -i 's/PORT/8080/' /config/app.conf
Corect
YAML
cp /config/app.conf /lucru/app.conf
sed -i 's/PORT/8080/' /lucru/app.conf

Copia dintr-un volum cu drept de scriere poate fi modificată.

3Încerci readOnly: false

Greșit
YAML
        volumeMounts:
        - name: config
          mountPath: /config
          readOnly: false
Corect
YAML
# volumele ConfigMap rămân read-only oricum; folosește emptyDir pentru scriere

Volumul ConfigMap nu devine scriibil prin readOnly: false.

Repară tu

Repară eroarea, direct în pagină

Agentul de sincronizare al unei rețele de farmacii (sincron) scrie la pornire fișierul de stare /config/stare, dar /config e montat din ConfigMap și jurnalul arată Read-only file system. Adaugă un volum emptyDir numit date, montat în /date, și schimbă comanda să scrie în /date/stare în ~/k8s/sincron.yaml.

Indiciu

Volumul nou stă în volumes, montarea lui în volumeMounts; comanda are calea fișierului în ea.

Alte forme ale mesajului

  • EROFS: read-only file system, open '/config/cache.json'
  • OSError: [Errno 30] Read-only file system: '/config/stare'

Cum o eviți pe viitor

  • Separă clar folderele: configurare (ConfigMap, Secret, doar citire) și date de lucru (emptyDir, PVC).
  • Configurează aplicația să scrie cache-ul și jurnalele în /tmp sau într-un emptyDir.
  • Dacă aplicația cere un fișier de configurare modificabil, copiază-l dintr-un init container.
  • Pune readOnlyRootFilesystem: true doar după ce știi unde scrie aplicația.

Întrebări frecvente

De ce volumele ConfigMap sunt doar pentru citire?

Pentru că sursa adevărului e obiectul din API server. O modificare locală s-ar pierde la următoarea sincronizare și ar crea diferențe între poduri.

Am același mesaj și în afara volumelor. De ce?

Probabil podul are readOnlyRootFilesystem: true, deci tot sistemul de fișiere al containerului e doar pentru citire, cu excepția volumelor montate separat.

Erori înrudite

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kubernetes de la zero, cu exerciții la fiecare lecție

Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.