[FEATURE] Report all missing required environment variables in a single error
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
调研方向
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.
由索引模型根据 Issue 内容生成。
描述
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
- 主要语言
- Go
- 星标
- 38.9k
- 派生
- 6k
- 平均合并
- 2 天 22 小时
- 30 天内合并 PR
- 81
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
docker/compose 的其他 Issue
-
[BUG] `docker compose port` prints `:0` (exit 0) for a port the image exposes but the service does not publish可能已有人在做 @ndeloof 于 1 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
docker/compose#14435 · 2 条评论 ·
维护者通常 1 天内回复
-
[BUG] deploy.restart_policy without condition drops the restart policy可能重新可做 @akshat-lakhera 于 25 天前认领,目前没有进行中的 PR。 未关闭
难度 2/5 1-3 小时 新手友好度 82/100
docker/compose#14383 · 3 条评论 ·
维护者通常 1 天内回复
-
[BUG] up: an optional (required: false) service_healthy dependent is not started when a required dependent shares the failing wait可能已有人在做 @ndeloof 于 2 天前认领。 未关闭
难度 4/5 3-5 天 新手友好度 58/100
docker/compose#14507 · 2 条评论 ·
维护者通常 1 天内回复
-
[BUG] Negative replica count in scale flags (docker compose scale / --scale) is accepted without validation可能已有人在做 @arsalanyavari 于 8 天前认领。 未关闭kind/bug status/approved
难度 2/5 1-3 小时 新手友好度 30/100
维护者通常 1 天内回复
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
IBM-Cloud/terraform-provider-ibm#7115 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 86/100
fluxcd/notification-controller#1441 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 66/100
volcengine/volcengine-go-sdk#163 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 76/100
OneBusAway/maglev#2145 ·
维护者通常 2 天内回复
-
priority/medium status/ready type/chore
难度 2/5 1-3 小时 新手友好度 84/100
discobox-ai/discobox#1357 ·
维护者通常 1 天内回复