docker『Invalid Container Name』の原因と対処法

# OK例
docker run --name web1 nginx
docker run --name my-app_01 nginx

# NG例
docker run --name "my app" nginx       # スペース
docker run --name "マイコンテナ" nginx   # 日本語
docker run --name "app/01" nginx       # スラッシュ

# NG
docker run --name "my app" nginx
docker run --name 開発環境 nginx
docker run --name app#01 nginx

# OK: ハイフン・アンダースコアで区切る
docker run --name my-app nginx
docker run --name dev-app nginx
docker run --name app_01 nginx

# NG
services:
  app:
    image: myorg/app
    container_name: "my app"     # スペース入り

# OK
services:
  app:
    image: myorg/app
    container_name: my-app

# 先にコンテナが動いている
docker run -d --name web nginx

# 同じ名前で起動しようとするとNG
docker run -d --name web nginx   # → 名前の競合エラー

# 既存コンテナを停止・削除
docker stop web
docker rm web

# 名前を変えて作成
docker run -d --name web2 nginx

# NG: NAME が空、または改行付き
NAME="$(cat name.txt)"   # name.txt の末尾に改行
docker run --name "$NAME" nginx

# 実際には "my-app\n" のようになっており invalid 扱い

# OK: トリムしてから使う
NAME="$(tr -d '\n\r' < name.txt)"
docker run --name "$NAME" nginx

# デバッグ: 実際の中身を確認
printf 'name=[%s]\n' "$NAME"

CONTAINER_NAME="${CONTAINER_NAME:-my-app}"
docker run --name "$CONTAINER_NAME" nginx

# NG例: サービス名にスペースや大文字を使う
services:
  Web App:          # スペース入り
    image: myorg/app

# NG例: プロジェクト名にスペースが入ったディレクトリで実行
# ディレクトリ名: "My Project"
docker compose up

# OK例: サービス名は小文字とハイフン・アンダースコアで
services:
  web_app:
    image: myorg/app

# プロジェクト名を明示指定して安全な名前にする
# docker-compose.ymlと同じディレクトリで
docker compose -p myproject up -d

# NG: 長すぎる + 不自然な構造
docker run --name my-super-long-container-name-with-too-many-sections-and-symbols nginx

# OK: 短めで意味が通る単位に分ける
docker run --name web-api nginx
docker run --name web-api-v1 nginx

# NG
docker run --name /web-api nginx

# OK
docker run --name web-api nginx

containerName := fmt.Sprintf("%s-%s", projectName, serviceName)
// projectName にスペースや大文字が入っているとNG

client.containers.run(
    "nginx",
    name="My App",   # スペース入り→NG
)

# 例: 手作業やスクリプトでの命名テンプレート
PROJECT="myapp"
ROLE="api"
ENV="dev"
ID="01"

NAME="${PROJECT}-${ROLE}-${ENV}-${ID}"   # myapp-api-dev-01
docker run --name "$NAME" myorg/app:1.0

# 1) スペース入り
# NG
docker run --name "web api" nginx
# OK
docker run --name web-api nginx

# 2) 日本語・特殊記号入り
# NG
docker run --name "開発環境#1" nginx
# OK
docker run --name dev-env-1 nginx

# 3) 名前の重複
# NG
docker run -d --name api nginx
docker run -d --name api nginx
# OK: 既存を消す or 名前を変える
docker rm -f api
docker run -d --name api nginx
# or
docker run -d --name api2 nginx

# 4) compose のサービス名にスペース
# NG
services:
  Web Api:
    image: myorg/app
# OK
services:
  web_api:
    image: myorg/app

# 5) 変数に改行が混ざっている
# NG
NAME="$(cat name.txt)"      # "my-app\n"
docker run --name "$NAME" nginx
# OK
NAME="$(tr -d '\n\r' < name.txt)"
docker run --name "$NAME" nginx