ECS入門 DockerからFargate公開まで解説

はじめに

クラウド上でアプリケーションを効率よく動かす仕組みとして「コンテナ」が一般的になり、AWSでも数多くのサービスが提供されています。その中でも Amazon ECS（Elastic Container Service） は、コンテナを簡単に実行・管理できるマネージドサービスとして多くの現場で使われています。

しかし、初めて学ぶ方にとっては「タスク定義」「サービス」「Fargate」「ALB」「CloudWatch」など聞き慣れない言葉が多く、全体像をつかみにくいのも事実です。

そこで本記事では、以下の流れで ECSを実際に触りながら学べる入門ハンズオン を紹介します。

• ECSの全体像を理解（タスク定義とサービスの役割）
• DockerイメージをECRにpushし、Fargateでデプロイ
• パブリックIPやALBで公開し、実際にアクセス確認
• CloudWatchを使ったログ・メトリクス監視とオートスケーリング

ただ動かすだけでなく、運用監視までを体験することで、ECSを本番環境で活用するイメージが持てるようになるのがゴールです。

ECSタスク定義を理解する

タスク定義とは

ECSでコンテナを動かす際の“設計図”にあたるのが タスク定義 です。
ここで指定した内容をもとに、ECSは実際のタスク（コンテナ群）を起動します。

設定できる主な項目

タスク定義で設定できる主な項目は次のとおりです。

つまりタスク定義とは、「どんなイメージを、どのリソースで、どんな設定で動かすか」をまとめた設計図 であり、ECSを使ううえで最も基本となる要素です。

サービスを理解する

サービスとは

ECSの サービス（Service） は、タスクを「安定して動かし続ける」ための仕組みです。
単発でタスクを実行するだけでは、停止するとそこで終わってしまいます。サービスを利用すると、以下のような運用が自動化されます。

• 常時稼働：指定した数のタスクを常に維持。万一タスクが落ちても自動で再起動。
• オートスケーリング：CPUやメモリ使用率に応じて、タスク数を自動で増減。
• ロードバランサー連携：ALB（Application Load Balancer）と組み合わせ、複数のタスクにトラフィックを分散。

つまりサービスは、単なる「タスク実行」から一歩進んで、本番環境向けにアプリを継続稼働させる仕組み だと理解すると分かりやすいです。

設定できる主な項目

ECSでアプリを公開する

まずは、ECSで動かすための サンプルアプリ を用意しましょう。
本格的なアプリでなくても大丈夫です。ここではシンプルなWebアプリを例にします。

サンプルアプリ開発

ファイル構成

以下のようなシンプルな構成にします。

ecs-sample/
├── app.js          # アプリ本体
├── package.json    # Node.js の依存関係定義
└── Dockerfile      # コンテナ化するための設定

ecs-sample/
├── app.js          # アプリ本体
├── package.json    # Node.js の依存関係定義
└── Dockerfile      # コンテナ化するための設定

Node.js で簡単なWebサーバーを作成

app.js

const http = require("http");
const port = 3000;

const server = http.createServer((req, res) => {
  res.writeHead(200, { "Content-Type": "text/plain" });
  res.end("Hello ECS!");
});

server.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

const http = require("http");
const port = 3000;

const server = http.createServer((req, res) => {
  res.writeHead(200, { "Content-Type": "text/plain" });
  res.end("Hello ECS!");
});

server.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

package.json

依存関係を管理する設定ファイルを作成します。

{
  "name": "ecs-sample",
  "version": "1.0.0",
  "main": "app.js"
}

{
  "name": "ecs-sample",
  "version": "1.0.0",
  "main": "app.js"
}

Dockerfile を作成

このアプリをコンテナ化するために Dockerfile を用意します。

FROM node:22-alpine

USER node

WORKDIR /usr/src/app
COPY --chown=node:node package*.json ./
ENV NODE_ENV=production
RUN npm ci --omit=dev || npm install --omit=dev || true

COPY --chown=node:node . .

EXPOSE 3000
CMD ["node", "app.js"]

FROM node:22-alpine

USER node

WORKDIR /usr/src/app
COPY --chown=node:node package*.json ./
ENV NODE_ENV=production
RUN npm ci --omit=dev || npm install --omit=dev || true

COPY --chown=node:node . .

EXPOSE 3000
CMD ["node", "app.js"]

ローカルでの動作確認

1. Dockerイメージをビルド
2. コンテナを起動
3. ブラウザまたは curl で確認
   → Hello ECS! と表示されれば成功です。

docker build -t ecs-sample .
docker run -d -p 3000:3000 ecs-sample
curl http://localhost:3000

docker build -t ecs-sample .
docker run -d -p 3000:3000 ecs-sample
curl http://localhost:3000

ECRにPushする

ECRとは

ECR（Elastic Container Registry） は、AWSが提供するコンテナイメージの専用リポジトリサービスです。
GitHubでソースコードを管理するように、ECRではDockerイメージを安全に保存・管理できます。

Push手順

• ECRリポジトリを作成
  • AWSマネジメントコンソール → 「ECR」 → 「リポジトリ作成」
  • 設定内容はの意味は下記です。

• AWS CLIでログイン

aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin <account_id>.dkr.ecr.ap-northeast-1.amazonaws.com

aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin <account_id>.dkr.ecr.ap-northeast-1.amazonaws.com

• イメージをビルド

 docker build -t myapp .
 docker build --provenance=false -t myapp . # macの場合はこちら

 docker build -t myapp .
 docker build --provenance=false -t myapp . # macの場合はこちら

• ECR用にタグ付け

docker tag myapp:latest <account_id>.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:latest

docker tag myapp:latest <account_id>.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:latest

• Push実行

docker push <account_id>.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:latest

docker push <account_id>.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:latest

これらのコマンドはECR内のプッシュコマンドを表示を押下すると確認できます。
そこからコピペで実行するのが早いです。

VPC作成

ECSを配置するための仮想ネットワーク「VPC（Virtual Private Cloud）」を作成します。
VPCはクラウド上に構築する自分専用のネットワーク空間で、IPアドレスの範囲や通信ルールを自由に設計できます。

作成手順（マネジメントコンソール）

1. AWSマネジメントコンソールにログイン
2. 「VPC」サービスに移動
3. 左メニューの「VPC」→「VPCを作成」をクリック
4. 以下を入力して作成
   • 名前タグ：sample-vpc
5. IPv4 CIDR ブロック：10.0.0.0/16
   • その他の設定はデフォルトのままでOK
6. 「VPCを作成」ボタンをクリックして完了

設定値の意味

これでどうなるか

このVPCは、今後作成するサブネットやインターネットゲートウェイ、ルートテーブルなどの土台になります。
この時点ではまだ通信はできませんが、次のステップでそれを可能にしていきます。

パブリックサブネット作成

VPC内にサブネット（Subnet） を作成します。
サブネットとは、VPC内でIPアドレスの範囲を区切るネットワークの一部であり、ECSを実際に配置する場所です。

今回は、インターネットに接続できる パブリックサブネット を作成します。

作成手順（マネジメントコンソール）

1. 「VPC」サービスにアクセス
2. 左メニューから「サブネット」→「サブネットを作成」をクリック
3. 以下を入力：
   • 名前タグ：sample-vpc-1a
   • VPC：sample-vpc
   • アベイラビリティゾーン：任意（例：ap-northeast-1a）
   • IPv4 CIDRブロック：10.0.1.0/24
4. 下部オプションの「パブリック IPv4 アドレスの自動割り当て」に✔を入れる
5. 「サブネットを作成」をクリック

設定値の意味

これでどうなるか

インターネットに出られる準備が整ったサブネットが完成します。

• このサブネットに配置されるECSには、自動でパブリックIPアドレスが割り当てられます。
• ただし、まだ ルートテーブルでインターネットへの経路（IGW）を設定していないため、通信はできません。

インターネットゲートウェイの作成とアタッチ

何をするか

作成したVPCからインターネットにアクセスできるようにするために、インターネットゲートウェイ（IGW: Internet Gateway） を作成し、VPCに接続（アタッチ）します。
これにより、ECSが外部と通信できるようになります（例：Webアクセスやパッケージのインストールなど）。

IGWの作成手順

1. AWSマネジメントコンソールで「VPC」サービスにアクセス
2. 左メニューから「インターネットゲートウェイ」を選択
3. 「インターネットゲートウェイを作成」をクリック
4. 名前タグにsample-igwと入力
5. 「インターネットゲートウェイを作成」をクリック

アタッチ手順

1. 作成したIGWを選択
2. 「アクション」→「VPCにアタッチ」をクリック
3. 接続先VPCとしてsample-vpc を選択
4. 「アタッチ」をクリック

これでどうなるか

• VPCにインターネットの出入口が接続されました。
• ただしこの時点ではまだルートテーブルの設定がされていないため、実際の通信はできません。
• 次のステップ（ルートテーブル作成）で、インターネット経路を明示的に指定します。

ルートテーブル設定

何をするか

ルートテーブル（Route Table） は、VPC内の通信ルート（経路）を定義するものです。
ここでは、パブリックサブネットからインターネットにアクセスできるようにするためのルートを設定します。

具体的には下記を行います。

• 0.0.0.0/0（すべての外部アドレス）宛のトラフィックを インターネットゲートウェイ（IGW） に転送するルートを追加
• そのルートテーブルをパブリックサブネットに関連付ける

作成手順（ルートテーブル）

1. 「VPC」サービスにアクセス
2. 左メニューから「ルートテーブル」→「ルートテーブルを作成」をクリック
3. 以下を入力：
   • 名前タグ：sample-rt
   • VPC：sample-vpc
4. 「ルートテーブルを作成」をクリックして完了

ルートの追加手順

1. 作成したルートテーブルを選択
2. 「ルート」タブ → 「ルートを編集」をクリック
3. 「ルートの追加」を押し、以下を入力：
   • 送信先：0.0.0.0/0
   • ターゲット：作成済みの インターネットゲートウェイ（igw-xxxxxxx）
4. 「変更を保存」をクリック

サブネットとの関連付け手順

1. 同じルートテーブル画面の「サブネットの関連付け」タブを開く
2. 「サブネットの関連付けを編集」をクリック
3. sample-vpc-1aを選択して「保存」

役割と設定内容

これでどうなるか

対象のサブネット（＝パブリックサブネット）からインターネットへ通信できる経路が確立されます。

• 0.0.0.0/0 のルートは、「すべての外部宛の通信」を意味し、
• それを インターネットゲートウェイ（IGW）に向けることで、ECSから外部ネットワーク（インターネット）への送信が可能になります。

ただし、この時点ではまだECSへの外部からのアクセスはできません。

• なぜなら、セキュリティグループ（ファイアウォール）の設定がまだ行われていないためです。
• セキュリティグループで必要なポート（SSH:22、HTTP:80など）を開放しない限り、外部からの通信は遮断されたままとなります。

セキュリティグループ設定

何をするか

セキュリティグループ（Security Group） は、ECSの 仮想ファイアウォール です。
ここでは、外部からWebブラウザでECSにアクセスしたりするために必要な通信ポートを開放します。

作成手順

1. 「EC2」サービスにアクセス
2. 左メニューから「セキュリティグループ」→「セキュリティグループを作成」
3. 以下を入力：
4. 名前：sample-sg
   • 説明：サンプル用セキュリティグループ
   • VPC：sample-vpc（作成済みのVPCを選択）
5. 「インバウンドルールを追加」をクリックし、以下を追加

これでどうなるか

このセキュリティグループをECSに適用することで、次のような通信が許可されます

• httpを利用し3000番ポートにアクセス

クラスターを作成する

まずは、ECSでアプリを動かすための「クラスター」を作成します。クラスターは、コンテナを実行する基盤となるリソースのまとまりです。

• ECSコンソール → 左メニューから「クラスター」 → 「クラスターの作成」

• 設定
  • クラスター名：わかりやすい名前を入力（例：my-ecs-cluster）
    インフラストラクチャー：ここではシンプルに Fargate を選択
    （EC2モードを使う場合は、後でEC2インスタンスの準備が必要になります）
    
• 作成 → 数十秒でクラスターができあがります。

タスク定義を作成する

タスク定義は「コンテナの設計図」です。

• ECSコンソールに移動
  左メニューから「タスク定義」 → 「新しいタスク定義を作成」

• タスク定義ファミリー名
  • 名前：myapp-task（自由でOK）

• 起動タイプ
  • Fargate を選択（インフラ管理不要で初心者に最適）

• タスクサイズ
  • CPU：1 vCPU
  • メモリ：2 GB 〜 3 GB

• コンテナ定義を追加
  • 名前：myapp-container
  • イメージURI：<account_id>.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:latest
  • ポートマッピング：80、3000

• ログ出力
  • グループ名：/ecs/myapp-task
  • リージョン：ap-northeast-1

サービスを作成する

サービスは「タスクを安定して動かす仕組み」です。

• ECSコンソール → クラスター
  • 事前に作った my-ecs-cluster を選択
  • 「サービス」タブ → 「作成」
• 基本設定
  • タスク定義：先ほど作成したmyapp-task
  • タスク定義のリビジョン：1
  • 起動タイプ：Fargate
  • サービス名：myapp-service
  • タスク数：1（最初は1でOK）

• ネットワーク設定
  • VPC：先ほど作成したVPC
  • サブネット：先ほど作成した、パブリックサブネットを選択
  • セキュリティグループ：先ほど作成したセキュリティグループを選択
  • パブリックIP割り当て：有効化（ONにするのを忘れない！）

実行〜動作確認

タスクの実行状態を確認する

• ECS コンソールにアクセスし、対象のクラスター → サービス → タスクを開きます。
• ステータスが実行中 になっていることを確認します。

アプリにアクセスできるか確認する

• タスク詳細画面に表示される Public IPv4 address をコピーします。
• ブラウザまたはターミナルから以下のようにアクセスします。

http://{パブリックIP}:3000

http://{パブリックIP}:3000

まとめ

ECSでは、タスク定義がコンテナ実行の設計図となり、サービスが安定稼働を担います。
ECRにイメージをPushしてFargateで実行すれば、パブリックIPから動作確認が可能です。
さらにCloudWatchでログやメトリクスを監視し、オートスケーリングを設定することで、本番運用に耐える環境を整えられます。