[FEATURE] Report all missing required environment variables in a single error
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 42/100
Línea de trabajo
Start by tracing environment variable interpolation and required-variable validation in Docker Compose; the issue names no source files or tests. Check how docker compose config and docker compose up handle multiple missing variables, then identify the relevant tests. Done means both commands report all missing required variables together and start no containers when validation fails.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Description
When a Compose file contains multiple required environment variables, Docker Compose stops at the first missing variable during interpolation.
This means users must repeatedly run docker compose up, fix one variable, and run the command again to discover the next missing variable.
It would be helpful to collect all missing required variables and report them together before exiting.
Example
services:
app:
image: alpine:latest
environment:
DB_HOST: ${DB_HOST:?DB_HOST is required}
DB_PASSWORD: ${DB_PASSWORD:?DB_PASSWORD is required}
API_KEY: ${API_KEY:?API_KEY is required}
With all three variables unset, run:
docker compose up
Current behavior
Compose exits after reporting a single missing required variable. The remaining missing variables are discovered only on subsequent attempts.
Expected behavior
Compose validates all required variables and returns one consolidated error, for example:
Configuration validation failed:
- DB_HOST: DB_HOST is required
- DB_PASSWORD: DB_PASSWORD is required
- API_KEY: API_KEY is required
No containers should be started when validation fails.
This behavior would be useful for both docker compose up and docker compose config.
Benefits
- Reduces repeated configuration attempts.
- Makes initial setup easier for projects with many required variables.
- Provides clearer feedback in CI/CD logs.
Docker Compose version
PS C:\Users\<user>> docker compose version
Docker Compose version v5.3.1
PS C:\Users\<user>> docker version
Client:
Version: 29.6.2-rd
API version: 1.55
Go version: go1.26.4
Git commit: ede120b
Built: Fri Jul 17 17:00:40 2026
OS/Arch: windows/amd64
Context: default
- Lenguaje dominante
- Go
- Estrellas
- 38.9k
- Forks
- 6k
- Merge medio
- 2 d 22 h
- PR fusionados (30 d)
- 81
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de docker/compose
-
[BUG] `docker compose port` prints `:0` (exit 0) for a port the image exposes but the service does not publishPosiblemente ocupada @ndeloof la tomó hace 1 día. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
docker/compose#14435 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
[BUG] deploy.restart_policy without condition drops the restart policyQuizá libre de nuevo @akshat-lakhera la tomó hace 25 días y no hay ningún pull request abierto. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
docker/compose#14383 · 3 comentarios ·
Los mantenedores suelen responder en 1 día
-
[BUG] up: an optional (required: false) service_healthy dependent is not started when a required dependent shares the failing waitPosiblemente ocupada @ndeloof la tomó hace 2 días. Abierto
Dificultad 4/5 3-5 días Aptitud para principiantes 58/100
docker/compose#14507 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
[BUG] Negative replica count in scale flags (docker compose scale / --scale) is accepted without validationPosiblemente ocupada @arsalanyavari la tomó hace 8 días. Abiertokind/bug status/approved
Dificultad 2/5 1-3 horas Aptitud para principiantes 30/100
Los mantenedores suelen responder en 1 día
Todos los issues de docker/compose
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
IBM-Cloud/terraform-provider-ibm#7115 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 86/100
fluxcd/notification-controller#1441 ·
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
volcengine/volcengine-go-sdk#163 · 1 comentario ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
OneBusAway/maglev#2145 ·
Los mantenedores suelen responder en 2 días
-
priority/medium status/ready type/chore
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
discobox-ai/discobox#1357 ·
Los mantenedores suelen responder en 1 día