...
Eroare Docker · Dockerfile și docker build

SecretsUsedInArgOrEnv: Do not use ARG or ENV instructions for sensitive data (ENV "DB_PASSWORD") (line 3)

Pe scurt

Ai pus o parolă sau un token în ENV/ARG, iar valoarea rămâne salvată în imagine, vizibilă cu docker inspect și docker history. Scoate-o din Dockerfile și dă-o la rulare (docker run -e, --env-file, secretele Compose) sau, la build, cu --secret.

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

Ce înseamnă

SecretsUsedInArgOrEnv e o verificare BuildKit care caută în numele variabilelor din ARG și ENV cuvinte ca PASSWORD, SECRET, TOKEN sau KEY. Mesajul arată instrucțiunea (ENV "DB_PASSWORD") și linia.

De ce contează: tot ce pui în ENV intră în configurația imaginii. Oricine are imaginea vede parola cu docker inspect (în Config.Env) sau cu docker history, inclusiv după ce o urci într-un registry. ARG nu rămâne în Env, dar valoarea apare în istoricul straturilor care l-au folosit.

Build-ul nu cade, e un avertisment. Reparația e să separi imaginea (aceeași peste tot) de configurație (diferită pe fiecare mediu): parola o primește containerul la pornire, nu imaginea la build.

De ce apare: cauzele frecvente

1Parola în ENV

Greșit
BASH
FROM node:20-alpine
ENV DB_PASSWORD=parola123
CMD ["node", "server.js"]
Corect
BASH
FROM node:20-alpine
CMD ["node", "server.js"]
# la rulare:
# docker run -e DB_PASSWORD=parola123 api:1.0

Valoarea ajunge doar în containerul pornit, nu în imaginea care circulă.

2Token de build în ARG

Greșit
BASH
ARG NPM_TOKEN
RUN echo "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > .npmrc && npm ci
Corect
BASH
RUN --mount=type=secret,id=npmrc,target=/root/.npmrc npm ci
# docker build --secret id=npmrc,src=$HOME/.npmrc .

Secretul montat cu --mount=type=secret există doar în acel RUN și nu intră în niciun strat.

3Parola în compose.yaml, în clar

Greșit
BASH
environment:
  DB_PASSWORD: parola123
Corect
BASH
env_file: .env
# .env, trecut în .gitignore:
# DB_PASSWORD=parola123

Fișierul .env rămâne pe calculator și nu ajunge în Git.

Repară tu

Repară eroarea, direct în pagină

În ~/api, Dockerfile-ul are ENV DB_PASSWORD=parola123, iar build-ul afișează SecretsUsedInArgOrEnv. Scoate parola din imagine, reconstruiește api:1.0 și pornește containerul api cu parola dată la rulare (DB_PASSWORD=parola123). Containerul trebuie să afișeze Conectat la baza.

Indiciu

Șterge linia ENV, reconstruiește, apoi docker run --name api -e DB_PASSWORD=parola123 api:1.0.

Alte forme ale mesajului

  • SecretsUsedInArgOrEnv: Do not use ARG or ENV instructions for sensitive data (ARG "API_TOKEN") (line 2)
  • SecretsUsedInArgOrEnv: Do not use ARG or ENV instructions for sensitive data (ENV "AWS_SECRET_ACCESS_KEY") (line 6)

Cum o eviți pe viitor

Nu scrie niciodată valori secrete în Dockerfile. Pentru rulare, folosește -e/--env-file sau secretele din Compose; pentru build (tokenuri de npm, pip, git), RUN --mount=type=secret. Verifică imaginile înainte de push cu docker inspect -f '{{json .Config.Env}}' imagine și docker history --no-trunc imagine. Dacă un secret a ajuns deja într-o imagine publicată, schimbă-l: ștergerea imaginii nu e suficientă.

Întrebări frecvente

Și -e nu e vizibil în docker inspect?

Ba da, pentru cine are acces la daemon-ul acelui server. Dar nu mai circulă odată cu imaginea în registry. Pentru protecție mai bună, folosește secretele Compose sau ale platformei (Kubernetes, AWS).

Avertismentul apare și pentru DB_PASSWORD_FILE?

Poate apărea, pentru că verificarea se uită la nume. Acolo valoarea e doar o cale de fișier, deci nu e o problemă reală.

Erori înrudite

← Toate erorile Docker

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ță 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.