[FEATURE] Report all missing required environment variables in a single error

オープン
#14,471 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
42/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
docker-compose, go
領域
cli

調査の方向性

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 の本文から書いたものです。

説明

kind/feature status/0-triage
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時間
マージ済み PR(30日)
81

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

docker/compose のほかの issue

docker/compose の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。