Docker ENV variable not setエラーの原因と解決方法【完全ガイド】

はじめに

Dockerを使用して開発やデプロイを行っている際に、「ENV variable not set」というエラーに遭遇したことはありませんか？このエラーは多くのDockerユーザーが経験する一般的な問題です。本記事では、このエラーの原因から解決方法まで、初心者でもわかりやすく詳しく解説していきます。

Docker ENV variableが設定されない原因

1. Dockerfileでの環境変数設定ミス

最も一般的な原因は、Dockerfile内で環境変数が正しく設定されていないことです。Dockerfileは、コンテナイメージを構築するための指示書のような役割を果たします。ここで環境変数を定義しなければ、コンテナ起動時にその変数が利用できなくなります。

2. docker runコマンド実行時の設定漏れ

Dockerfile内では正しく設定されていても、コンテナを実行する際のdocker runコマンドで環境変数を渡していない場合も同じエラーが発生します。特に外部から値を渡す必要がある場合に見落としやすい項目です。

3. docker-compose.ymlでの設定ミス

docker-composeを使用している場合、YAML形式の設定ファイルで環境変数が正しく記述されていないと、コンテナ起動時に変数が設定されません。YAML形式はインデント（字下げ）が重要であり、ここでのエラーが問題の原因になることが多いです。

4. .envファイルの読み込み失敗

環境変数を.envファイルで管理している場合、そのファイルが正しい場所に存在しなかったり、docker-composeが正しく読み込んでいなかったりすると、ENV variable not setエラーが発生します。

5. シェルスクリプト内での変数展開ミス

コンテナ内で実行されるシェルスクリプトが、環境変数を正しく参照していない場合も同じエラーになります。特に変数名のタイプミスや、変数展開の構文エラーが原因になることがあります。

Docker ENV variableエラーの解決手順

ステップ1: Dockerfileを確認する

まず最初に、Dockerfile内で環境変数が正しく定義されているか確認しましょう。DockerfileにはENVキーワードを使用して環境変数を設定します。以下の形式で記述します：

ENV 変数名=値

複数の変数を設定する場合は、複数行に記述するか、一行で複数の変数を設定できます。

ステップ2: docker runコマンドのオプションを確認する

Dockerfileで定義していない、または実行時に値を変更したい場合は、docker runコマンドで-eオプションを使用して環境変数を渡します。

ステップ3: docker-compose.ymlを確認する

docker-composeを使用している場合は、YAMLファイルの環境変数設定を確認します。インデントが正しいか、必須の変数がすべて定義されているかをチェックしましょう。

ステップ4: .envファイルの存在と内容を確認する

.envファイルを使用している場合は、ファイルがプロジェクトルートに存在し、正しい形式で記述されているか確認します。

ステップ5: コンテナ内で環境変数を確認する

実際にコンテナが起動後、環境変数が正しく設定されているか確認することが重要です。docker execコマンドを使用して、実行中のコンテナ内で環境変数を確認できます。

具体的なコード例と解決方法

例1: Dockerfileでの環境変数設定

【間違い例】

FROM python:3.9
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

このDockerfileでは環境変数が設定されていないため、ENV variable not setエラーが発生します。

【正解例】

FROM python:3.9
WORKDIR /app

# 環境変数を設定
ENV DATABASE_URL=postgresql://localhost/mydb
ENV DEBUG=False
ENV APP_ENV=production

COPY . .
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

または、複数の環境変数を効率的に設定する方法：

FROM python:3.9
WORKDIR /app

# 複数の環境変数を一行で設定
ENV DATABASE_URL=postgresql://localhost/mydb \
    DEBUG=False \
    APP_ENV=production \
    LOG_LEVEL=INFO

COPY . .
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

例2: docker runコマンドでの環境変数設定

【単一の環境変数を設定】

docker run -e DATABASE_URL=postgresql://localhost/mydb -d myimage:latest

【複数の環境変数を設定】

docker run \
  -e DATABASE_URL=postgresql://localhost/mydb \
  -e DEBUG=True \
  -e APP_ENV=development \
  -d myimage:latest

【.envファイルから環境変数を読み込む】

docker run --env-file .env -d myimage:latest

この方法を使用する場合、.envファイルは以下の形式で作成します：

# .env ファイルの内容
DATABASE_URL=postgresql://localhost/mydb
DEBUG=False
APP_ENV=production
LOG_LEVEL=INFO
API_KEY=your_api_key_here

例3: docker-compose.ymlでの環境変数設定

【間違い例】

version: '3.8'
services:
  web:
    build: .
    ports:
      - "8000:8000"
    environment:
      DATABASE_URL postgresql://localhost/mydb
      DEBUG False

このYAMLは形式が正しくないため、エラーが発生します。

【正解例】

version: '3.8'
services:
  web:
    build: .
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://localhost/mydb
      - DEBUG=False
      - APP_ENV=production
      - LOG_LEVEL=INFO

【辞書形式での設定】

version: '3.8'
services:
  web:
    build: .
    ports:
      - "8000:8000"
    environment:
      DATABASE_URL: postgresql://localhost/mydb
      DEBUG: 'False'
      APP_ENV: production
      LOG_LEVEL: INFO

【.envファイルを使用する場合】

version: '3.8'
services:
  web:
    build: .
    ports:
      - "8000:8000"
    env_file:
      - .env

例4: コンテナ内で環境変数を確認する方法

【すべての環境変数を確認】

docker exec <コンテナID> env

【特定の環境変数を確認】

docker exec <コンテナID> echo $DATABASE_URL

【実際の使用例】

# コンテナIDを確認
docker ps

# コンテナID "abc123def456" のすべての環境変数を表示
docker exec abc123def456 env

# 特定の環境変数 DATABASE_URL を確認
docker exec abc123def456 echo $DATABASE_URL

例5: Pythonアプリケーション内での環境変数の使用

【osモジュールを使用する場合】

import os

# 環境変数を取得（設定されていない場合はエラーになる）
database_url = os.environ['DATABASE_URL']
debug = os.environ['DEBUG']

# 環境変数を取得（デフォルト値を指定）
log_level = os.environ.get('LOG_LEVEL', 'INFO')
app_env = os.environ.get('APP_ENV', 'development')

【python-dotenvを使用する場合】

from dotenv import load_dotenv
import os

# .envファイルを読み込む
load_dotenv()

database_url = os.environ.get('DATABASE_URL')
debug = os.environ.get('DEBUG', 'False')
log_level = os.environ.get('LOG_LEVEL', 'INFO')

例6: Node.jsアプリケーション内での環境変数の使用

// 環境変数を取得
const databaseUrl = process.env.DATABASE_URL;
const debug = process.env.DEBUG;
const logLevel = process.env.LOG_LEVEL || 'INFO';

// 必須の環境変数をチェック
if (!databaseUrl) {
  throw new Error('DATABASE_URL environment variable is not set');
}

console.log('Database URL:', databaseUrl);
console.log('Debug mode:', debug);
console.log('Log Level:', logLevel);

よくある間違いと対処法

間違い1: 環境変数名のタイプミス

【間違い例】

ENV DATABASE_ULR=postgresql://localhost/mydb  # URlではなくURLが正しい

【正解例】

ENV DATABASE_URL=postgresql://localhost/mydb

タイプミスは一見して発見しにくいため、変数名は慎重に確認しましょう。

間違い2: docker-compose.ymlのインデント不正

【間違い例】

version: '3.8'
services:
web:  # インデントが不正
  build: .
  environment:
  - DATABASE_URL=postgresql://localhost/mydb  # インデントが不正

【正解例】

version: '3.8'
services:
  web:  # 2スペースインデント
    build: .
    environment:
      - DATABASE_URL=postgresql://localhost/mydb  # 6スペースインデント

YAMLファイルはインデントが厳格です。エディタにYAML検証ツールを導入することをお勧めします。

間違い3: .envファイルの記述ミス

【間違い例】

DATABASE_URL postgresql://localhost/mydb  # 等号がない
DEBUG = False  # 等号の前後に空白がある
 "API_KEY=your_key"  # クォートで囲んでいる

【正解例】

DATABASE_URL=postgresql://localhost/mydb
DEBUG=False
API_KEY=your_key

間違い4: コンテナ起動時にenvを指定していない

【間違い例】

docker run -d myimage:latest  # -e や --env-file がない

Dockerfileで定義した環境変数は設定されますが、外部から渡す必要がある変数は設定されません。

【正解例】

docker run -e DATABASE_URL=postgresql://localhost/mydb -d myimage:latest

間違い5: 変数展開のシンタックスエラー

【Bashスクリプト内での間違い例】

#!/bin/bash
echo $DATABSE_URL  # 変数名がタイプミス
echo "The URL is $database_url"  # 存在しない小文字変数を参照

【正解例】

#!/bin/bash
echo $DATABASE_URL
echo "The URL is $DATABASE_URL"

間francès6: 数値や真偽値を文字列として扱う

【注意点】

環境変数はすべて文字列として保存されます。数値や真偽値が必要な場合は、アプリケーション側で型変換する必要があります。

import os

# 文字列として取得
debug_str = os.environ.get('DEBUG', 'False')

# 真偽値に変換
debug = debug_str.lower() in ['true', '1', 'yes']

# 数値に変換
port = int(os.environ.get('PORT', '8000'))

トラブルシューティングのチェックリスト

ENV variable not setエラーが発生したときは、以下の順序でチェックしてください：

1. Dockerfile内で環境変数がENVで定義されているか確認
2. docker runコマンドで-eオプションを使用して変数を渡しているか確認
3. docker-compose.ymlが正しいYAML形式か確認（特にインデント）
4. .envファイルが存在し、正しい形式で記述されているか確認
5. docker exec envコマンドで、コンテナ内に変数が存在するか確認
6. アプリケーションコード内で変数名のタイプミスがないか確認
7. コンテナのログを確認（docker logsコマンド）

本番環境での推奨事項

シークレット情報の安全な管理

APIキーやパスワードなどのシークレット情報は、.envファイルには記述せず、Docker Secretsやシークレット管理ツールを使用しましょう。

# Docker Secretsを使用する例
docker secret create db_password secret_file.txt

環境ごとの設定分離

開発環境、ステージング環境、本番環境で異なる環境変数を使用する場合は、各環境専用の.envファイルを作成することをお勧めします。