🚀 イメージ操作の基本コマンド

Dockerのインストール:

sudo snap install docker # version 28.4.0, or
sudo snap install docker # version 28.1.1+1
sudo apt install docker.io # version 28.2.2-0ubuntu1~22.04.1
sudo apt install podman-docker # version 3.4.4+ds1-1ubuntu1.22.04.3

基本的なイメージ操作:

# イメージの検索
docker search nginx# イメージのダウンロード
docker pull nginx:latest
docker pull mariadb:10.6

# ローカルイメージの一覧
docker images

# イメージの削除
docker rmi nginx:latest

# 使用されていないイメージを削除
docker image prune

🎛️ コンテナ操作の基本コマンド

# コンテナの起動（フォアグラウンド）
docker run nginx:latest# コンテナの起動（バックグラウンド）
docker run -d nginx:latest

# ポートマッピングして起動
docker run -d -p 8080:80 nginx:latest

# 名前を付けて起動
docker run -d –name my-nginx -p 8080:80 nginx:latest

# 環境変数を指定して起動
docker run -d -e MYSQL_ROOT_PASSWORD=secret mariadb:10.6

# 実行中のコンテナ一覧
docker ps

# すべてのコンテナ一覧（停止中含む）
docker ps -a

# コンテナの停止
docker stop my-nginx

# コンテナの起動（停止中のものを再起動）
docker start my-nginx

# コンテナの再起動
docker restart my-nginx

# コンテナの削除
docker rm my-nginx

# 強制削除（実行中でも）
docker rm -f my-nginx

# 停止中のコンテナをすべて削除
docker container prune

⚠️ ポートマッピングについて重要な説明

portsセクションは「ホストPCのポート」と「コンテナのポート」を紐付ける設定です。

例: “8080:80” の場合、

• 左側（8080）はホストPC（自分のPCやサーバー）のポート番号
• 右側（80）はコンテナ内のサービス（例: nginxやApacheなど）がリッスンしているポート番号

この設定により、ブラウザで http://localhost:8080 にアクセスすると、
コンテナ内のWebサーバー（80番ポート）にリクエストが届きます。

よくある間違い：

• ❌ ホスト側のポート（左側）が他のアプリで使われていると起動できない
• ❌ コンテナ側のポート（右側）がサービスの設定と一致していないと表示されない

複数のWebアプリを同時に起動したい場合：

“8081:80” や
“8082:80” など、ホスト側のポートを変えて起動します。

まとめ：

• ✅ “ホスト側:コンテナ側” の形式で書く
• ✅ ホスト側は自由に設定可能（未使用ポートを選ぶ）
• ✅ コンテナ側はサービスの設定に合わせる
• ⚠️ ポート競合や設定ミスに注意

💡 現環境のコンテナ化について

コンテナは現環境（OS・設定・ソフトウェア・データ）を”そっくりそのまま”コンテナ化することは基本的に不可能です。

必要なソフトウェアや設定を調べて、Dockerfileで”再現できるように”レシピを書く必要があります。

詳細：

1. そっくりそのままコンテナ化はできない理由
   • コンテナは「軽量な仮想環境」であり、OS全体や物理環境を丸ごとコピーするものではありません。
   • 物理サーバやVMの”状態”や”設定”をそのままコンテナに持ち込むことはできません。
   • 例えば /etc や /var
     の細かい設定、ユーザー管理、カーネルモジュールなどはコンテナでは再現できません。
2. 再現するための方法
   • 必要なソフトウェア（nginx, php,
     mysqlなど）や設定ファイルを調べて、Dockerfileやdocker-compose.ymlで「再現」します。
   • データや設定は、COPYやVOLUMEで持ち込むことができます。
   • ただし、OSのバージョンや細かい挙動は公式イメージやベースイメージに依存します。
3. 例外的な方法
   • 物理サーバやVMのイメージを「コンテナ化」するツール（例：docker import,
     Packerなど）はありますが、実務では推奨されません。
   • 理由：不要なものまで持ち込む、セキュリティリスク、サイズが大きくなる、メンテナンス性が悪い

まとめ：

「現環境を調べて、必要なものだけをDockerfileで再現する」のが基本です。そっくりそのままコンテナ化はできませんが、アプリやサービス単位で”再現”は可能です。

🔍 コンテナの調査・デバッグコマンド

# コンテナのログ確認
docker logs my-nginx# ログをリアルタイム表示
docker logs -f my-nginx

# コンテナの詳細情報
docker inspect my-nginx

# コンテナのリソース使用状況
docker stats

# コンテナ内でコマンド実行
docker exec my-nginx ls -la

# コンテナ内に対話的にログイン
docker exec -it my-nginx /bin/bash

# コンテナ内のプロセス一覧
docker top my-nginx

🎯 WordPressコンテナのDockerfile

FROM php:8.1-apache# WordPress依存パッケージのインストール
RUN apt-get update &&
apt-get install -y
libpng-dev
libjpeg-dev
libfreetype6-dev
libzip-dev
unzip &&
docker-php-ext-configure gd –with-freetype –with-jpeg &&
docker-php-ext-install -j$(nproc)
gd
mysqli
pdo_mysql
zip &&
apt-get clean &&
rm -rf /var/lib/apt/lists/*

# WordPressのダウンロード
ENV WORDPRESS_VERSION=6.4
RUN curl -o wordpress.tar.gz -fSL
“https://wordpress.org/wordpress-${WORDPRESS_VERSION}.tar.gz” &&
tar -xzf wordpress.tar.gz -C /var/www/html –strip-components=1 &&
rm wordpress.tar.gz &&
chown -R www-data:www-data /var/www/html

# Apache設定
RUN a2enmod rewrite

# ポート公開
EXPOSE 80

# 起動コマンド
CMD [“apache2-foreground”]

🏗️ マルチステージビルドの例

# ビルドステージ
FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build# 実行ステージ
FROM node:18-alpine
WORKDIR /app
COPY –from=builder /app/dist ./dist
COPY –from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD [“node”, “dist/main.js”]

メリット：

• ✅ 最終イメージサイズの削減
• ✅ ビルドツールを含まない
• ✅ セキュリティ向上

🚀 ECRリポジトリの作成手順

方法1: AWS CLI を使用

# ECRリポジトリの作成
aws ecr create-repository
–repository-name my-app
–region ap-northeast-1# イメージスキャンを有効にして作成
aws ecr create-repository
–repository-name my-app
–image-scanning-configuration scanOnPush=true
–region ap-northeast-1

# 作成されたリポジトリの確認
aws ecr describe-repositories –region ap-northeast-1

方法2: AWSマネジメントコンソール

1. AWS Management Consoleにログイン
2. 「ECR」サービスを開く
3. 「リポジトリを作成」をクリック
4. リポジトリ名を入力（例: my-app）
5. 「プライベート」を選択（推奨）
6. オプション: イメージスキャンを有効化
7. 「リポジトリを作成」をクリック

📋 作成されるリポジトリURI形式:

123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app

• 123456789012: AWSアカウントID
• ap-northeast-1: リージョン
• my-app: リポジトリ名

🔐 ECRへの認証方法

ECRにイメージをプッシュ/プルする前に、Docker CLIをECRに認証する必要があります。

方法1: AWS CLI v2 を使用（推奨）

# ECRにログイン
aws ecr get-login-password –region ap-northeast-1 |
docker login –username AWS –password-stdin
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com# 成功すると以下のメッセージが表示されます:
# Login Succeeded

方法2: AWS CLI v1 を使用

# ログインコマンドを取得して実行
$(aws ecr get-login –no-include-email –region ap-northeast-1)

⚠️ 認証トークンの有効期限

ECRの認証トークンは12時間で期限切れになります。

期限切れ後は再度ログインが必要です。

認証の確認:

# Dockerの認証情報を確認
cat ~/.docker/config.json

📤 ECRへのイメージプッシュ手順

1. ローカルイメージのビルド# Dockerイメージをビルド
docker build -t my-app:latest .
2. ECR用にタグ付け

# ECRリポジトリURIでタグ付け
docker tag my-app:latest
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:latest# バージョンタグも付ける（推奨）
docker tag my-app:latest
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:v1.0.0

3. ECRにログイン# ECRへの認証
aws ecr get-login-password –region ap-northeast-1 |
docker login –username AWS –password-stdin
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com
4. イメージをプッシュ

# イメージをECRにプッシュ
docker push 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:latest# バージョンタグもプッシュ
docker push 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:v1.0.0

5. プッシュ確認

# ECRのイメージ一覧を確認
aws ecr list-images –repository-name my-app –region ap-northeast-1# イメージの詳細情報を確認
aws ecr describe-images –repository-name my-app –region ap-northeast-1

💡 まとめてプッシュするスクリプト例:

#!/bin/bash# 変数設定
AWS_REGION=”ap-northeast-1″
AWS_ACCOUNT_ID=”123456789012″
REPO_NAME=”my-app”
IMAGE_TAG=”latest”

# ECRのURIを生成
ECR_URI=”${AWS_ACCOUNT_ID}.dkr.ecr.${AWS_REGION}.amazonaws.com/${REPO_NAME}”

# イメージビルド
echo “Building Docker image…”
docker build -t ${REPO_NAME}:${IMAGE_TAG} .

# ECR用にタグ付け
echo “Tagging image for ECR…”
docker tag ${REPO_NAME}:${IMAGE_TAG} ${ECR_URI}:${IMAGE_TAG}

# ECRにログイン
echo “Logging in to ECR…”
aws ecr get-login-password –region ${AWS_REGION} |
docker login –username AWS –password-stdin ${ECR_URI}

# ECRにプッシュ
echo “Pushing image to ECR…”
docker push ${ECR_URI}:${IMAGE_TAG}

echo “Done!”

📥 ECRからのイメージプル手順

1. ECRにログイン# ECRへの認証
aws ecr get-login-password –region ap-northeast-1 |
docker login –username AWS –password-stdin
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com
2. イメージをプル

# ECRからイメージをプル
docker pull 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:latest# 特定バージョンをプル
docker pull 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:v1.0.0

3. プルしたイメージを確認# ローカルイメージ一覧を確認
docker images | grep my-app
4. コンテナを起動# ECRからプルしたイメージでコンテナ起動
docker run -d -p 8080:80
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:latest

💡 異なるEC2インスタンスでプルする場合:

別のEC2インスタンスやローカル環境でECRからイメージをプルする場合：

1. AWS CLIがインストールされていることを確認
2. 適切なIAM権限（ECRへのアクセス権）があることを確認
3. 上記の手順でログイン→プルを実行

🚀 ECSでのコンテナ実行の基本フロー

ECRにプッシュしたイメージをECSで実行する基本的な流れ：

ステップ1: ECSクラスターの作成

# Fargateクラスターの作成
aws ecs create-cluster
–cluster-name my-cluster
–region ap-northeast-1# クラスター一覧の確認
aws ecs list-clusters –region ap-northeast-1

ステップ2: タスク定義の作成

タスク定義はコンテナの設定を定義するJSONファイルです。

# task-definition.json を作成
{
“family”: “my-app-task”,
“networkMode”: “awsvpc”,
“requiresCompatibilities”: [“FARGATE”],
“cpu”: “256”,
“memory”: “512”,
“containerDefinitions”: [
{
“name”: “my-app-container”,
“image”: “123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-app:latest”,
“portMappings”: [
{
“containerPort”: 80,
“protocol”: “tcp”
}
],
“essential”: true
}
]
}# タスク定義を登録
aws ecs register-task-definition
–cli-input-json file://task-definition.json
–region ap-northeast-1

ステップ3: サービスの作成と実行

# ECSサービスの作成（Fargate）
aws ecs create-service
–cluster my-cluster
–service-name my-app-service
–task-definition my-app-task
–desired-count 1
–launch-type FARGATE
–network-configuration
“awsvpcConfiguration={subnets=[subnet-xxxxx],securityGroups=[sg-xxxxx],assignPublicIp=ENABLED}”
–region ap-northeast-1

ステップ4: サービスの確認

# サービス一覧
aws ecs list-services –cluster my-cluster –region ap-northeast-1# サービスの詳細
aws ecs describe-services
–cluster my-cluster
–services my-app-service
–region ap-northeast-1

# 実行中のタスク一覧
aws ecs list-tasks –cluster my-cluster –region ap-northeast-1

⚠️ 注意事項

• サブネットIDとセキュリティグループIDは実際の環境に合わせて変更してください
• ECSタスクにECRへのアクセス権限を持つIAMロールが必要です
• Fargateの場合、料金はCPU/メモリの使用量に応じて課金されます

💡 AWSマネジメントコンソールでの操作

CLI操作が複雑に感じる場合は、AWSコンソールから以下の手順で操作できます：

1. ECSコンソールを開く
2. 「クラスターの作成」→ Fargateを選択
3. 「タスク定義の作成」→ コンテナイメージにECR URIを指定
4. 「サービスの作成」→ タスク定義とクラスターを選択
5. ネットワーク設定（VPC、サブネット、セキュリティグループ）を指定
6. サービスを起動

📝 ECR/ECS 実務でよく使うコマンド

ECR関連:

# リポジトリ一覧
aws ecr describe-repositories –region ap-northeast-1# イメージ一覧
aws ecr list-images –repository-name my-app –region ap-northeast-1

# イメージの削除
aws ecr batch-delete-image
–repository-name my-app
–image-ids imageTag=v1.0.0
–region ap-northeast-1

# リポジトリの削除（注意！）
aws ecr delete-repository
–repository-name my-app
–force
–region ap-northeast-1

# イメージの脆弱性スキャン結果を確認
aws ecr describe-image-scan-findings
–repository-name my-app
–image-id imageTag=latest
–region ap-northeast-1

ECS関連:

# クラスター一覧
aws ecs list-clusters –region ap-northeast-1# サービス一覧
aws ecs list-services –cluster my-cluster –region ap-northeast-1

# タスク定義の一覧
aws ecs list-task-definitions –region ap-northeast-1

# サービスのスケーリング
aws ecs update-service
–cluster my-cluster
–service my-app-service
–desired-count 3
–region ap-northeast-1

# サービスの停止
aws ecs update-service
–cluster my-cluster
–service my-app-service
–desired-count 0
–region ap-northeast-1

# サービスの削除
aws ecs delete-service
–cluster my-cluster
–service my-app-service
–force
–region ap-northeast-1

# タスクのログを確認（CloudWatch Logs）
aws logs tail /ecs/my-app-task –follow –region ap-northeast-1

📝 完全なDocker Compose設定例

version: ‘3.8’services:
web:
build: .
ports:
– “8080:80”
depends_on:
– db
environment:
– DB_HOST=db
– DB_NAME=myapp
volumes:
– ./app:/var/www/html
networks:
– app-network

db:
image: mariadb:10.6
environment:
MYSQL_ROOT_PASSWORD: rootpass
MYSQL_DATABASE: myapp
MYSQL_USER: user
MYSQL_PASSWORD: userpass
volumes:
– db-data:/var/lib/mysql
networks:
– app-network

volumes:
db-data:

networks:
app-network:
driver: bridge

⚠️ 複数コンテナとコンテナ名について

複数のnginxコンテナを同時に立ち上げる場合は、

• それぞれ異なるコンテナ名（–nameオプションやdocker-composeのサービス名）で起動します。
• 例: nginx-a（8080:80）、nginx-b（8081:80）など
• これにより、A用・B用など用途ごとにWebアプリを分けて運用できます。

注意：

1つのコンテナ（同じコンテナ名）に複数ポート（8080:80, 8081:80など）をマッピングすると、
どちらのポートでアクセスしても同じコンテナの80番に転送されます。

→ 1つのnginxで複数ポートを管理したい場合はこの方法ですが、
アプリや公開フォルダの振り分けはnginxの設定(serverブロック)で行う必要があります。
初心者はコンテナを分けて運用する方が分かりやすいです。

💾 ボリューム管理

# ボリューム作成
docker volume create my-volume# ボリューム一覧
docker volume ls

# ボリューム詳細
docker volume inspect my-volume

# ボリュームを使用してコンテナ起動
docker run -d -v my-volume:/data nginx

# ホストのディレクトリをマウント（バインドマウント）
docker run -d -v /host/path:/container/path nginx

# 読み取り専用マウント
docker run -d -v my-volume:/data:ro nginx

# ボリューム削除
docker volume rm my-volume

# 未使用ボリューム削除
docker volume prune

🌐 ネットワーク管理

# ネットワーク作成
docker network create my-network# ネットワーク一覧
docker network ls

# ネットワーク詳細
docker network inspect my-network

# ネットワークに接続してコンテナ起動
docker run -d –network my-network –name web nginx

# 既存コンテナをネットワークに接続
docker network connect my-network web

# ネットワークから切断
docker network disconnect my-network web

# ネットワーク削除
docker network rm my-network

🚨 解決方法

# ログ確認
docker logs <container-name># 詳細情報確認
docker inspect <container-name>

# イベント確認
docker events

🚨 解決方法

# ポート使用状況確認
sudo lsof -i :8080
# または
sudo netstat -tulpn | grep 8080# 別のポートを使用
docker run -d -p 8081:80 nginx

🚨 解決方法

# 使用状況確認
docker system df# 未使用リソースの削除
docker system prune

# すべて削除（注意！）
docker system prune -a –volumes