TerraformでECSにコンテナをデプロイする方法を解説！ECRへイメージをプッシュする方法もあわせて解説

Amazon ECS（Elastic Container Service）は、コンテナ化されたアプリケーションを簡単に実行・管理できる便利なサービスです。Terraformと組み合わせることで、インフラをコード化し、繰り返し可能かつ管理しやすい形でデプロイが可能です。

本記事は、「Hello OpsToday ECS」という言葉を表示させるWebページを作成して、それをECS上で起動する手順の解説記事となります。Terraformの基本的な知識を持つエンジニアが、より効率的にAWS環境を運用する方法を知りたい方に最適な内容です！

terraformでECRとECSを作成し、コンテナを起動する手順

実際にterraformでECRとECSを作成し、コンテナをAWS上で起動させる方法を解説します。

コンテナの概要やECSとは何か、ECRとは何か、についてはこちらの記事で解説していますので概要を知りたいという方は、まずはこちらをご覧ください。

Amazon ECSとは？AWSでコンテナを運用するための基礎知識！EKSとの違い、ECRの概要も徹底解説

1. HTMLファイルの作成

まずは、OpsToday-ECSフォルダ内にindex.htmlファイルを作成し、次の内容を記述してください。

<!DOCTYPE html>
<html lang=”en”>
<head>
<meta charset=”UTF-8″>
<meta name=”viewport” content=”width=device-width, initial-scale=1.0″>
<title>Hello OpsToday ECS</title>
</head>
<body>
<h1>Hello OpsToday ECS</h1>
</body>
</html>

2. Docker イメージをビルド

HTMLファイルと同一のフォルダ内にDockerfileという名前のファイルを作成し、次の内容を Dockerfile に保存してください。

FROM nginx:alpine
COPY index.html /usr/share/nginx/html/index.html

Dockerfile作成が完了したら次のコマンドで、まずはローカル環境にDocker イメージをビルドします。

(base) apple@MacBook OpsToday-ECS % docker build -t hello-opstoday-ecs .

ERROR: Cannot connect to the Docker daemon at unix:///Users/apple/.docker/run/docker.sock. Is the docker daemon running?

上記エラーは、Dockerのアプリが起動していない場合に発生します。

Docekrアプリケーションを起動し、コマンドを再実行してください。

3. tfstateファイルを格納するためのS3バケットを作成する

terraformの基本的な使い方については以前の記事で解説しています。使い方がわからない場合や環境設定がまだの場合は、こちらの記事を参照してください。

001-00004のリンク

今回は、S3に「opstoday-terraform-tstate-0111」という名前のバケットを作成してそのバケットの中にtfstateファイルを格納します。

今回は、「opstoday-terraform-tstate-0111」の名前でバケットを作成しましたが、バケット名は全世界で一意である必要があります。他のバケット名と被らないように環境に合わせて命名してください。

4. tfstateファイルの作成

VScodeで「tfstate.tf」という名前のファイルを作成し、下記のコードを記述します。

# tfstate管理バケット
terraform {
required_version = “= 1.9.6” #terraformのバージョン
backend “s3” {
bucket = “<ステップ6で作成したバケット名>” #AWSコンソール上のバケット名を入力
key = “opstoday-terrafom-tfstate-ecs” #オブジェクト名を入力　参照/新規作成
region = “ap-northeast-1”
}
}

# プロバイダー指定
provider “aws” {
region = “ap-northeast-1”
}

コードの入力が完了したら、VScodeのターミナル上で下記コマンドを実行します。

terraform init

下記の画像のようにTerraform has been successfully initialized!と表示されていれば、tfstateファイルの作成が完了しています。

5. Terraformコードの作成

OpsToday-ECSフォルダ内に以下の4つのファイルを作成します。

ecr.tf
ecs.tf
iam.tf
network.tf

4つのファイル内にそれぞれコードを記述していきます。

ecr.tf

resource “aws_ecr_repository” “main” {
name = “hello-world-opstoday”
force_delete = true
}

output “repository_url” {
value = aws_ecr_repository.main.repository_url
}

ecs.tf

resource “aws_ecs_cluster” “main” {
name = “OpsToday-ecs-cluster”
}

locals {
container_name = “apache-helloworld”
}

resource “aws_ecs_task_definition” “main” {
family = “OpsToday-ecs-task-definition”
cpu = 512
memory = 1024
requires_compatibilities = [“FARGATE”]
execution_role_arn = aws_iam_role.ecs_task_execution_role.arn
network_mode = “awsvpc”
container_definitions = jsonencode([
{
“name”: local.container_name,
“image”: “${aws_ecr_repository.main.repository_url}:latest”,
“cpu”: 0,
“portMappings”: [
{
“name”: local.container_name,
“containerPort”: 80,
“hostPort”: 80,
“protocol”: “tcp”,
“appProtocol”: “http”
}
],
“essential”: true,
“environment”: [],
“environmentFiles”: [],
“mountPoints”: [],
“volumesFrom”: [],
“logConfiguration”: {
“logDriver”: “awslogs”,
“options”: {
“awslogs-create-group”: “true”,
“awslogs-group”: “/ecs/OpsToday-ecs-task-definition”,
“awslogs-region”: “ap-northeast-1”,
“awslogs-stream-prefix”: “ecs”
}
}
}
])
}

resource “aws_ecs_service” “main” {
name = “OpsToday-ecs-service”
cluster = aws_ecs_cluster.main.id
task_definition = aws_ecs_task_definition.main.arn
launch_type = “FARGATE”
desired_count = 2
network_configuration {
subnets = [
aws_subnet.public1.id,
aws_subnet.public2.id
]
security_groups = [
aws_default_security_group.default.id
]
assign_public_ip = true
}
load_balancer {
target_group_arn = aws_lb_target_group.main.arn
container_name = local.container_name
container_port = 80
}
}

iam.tf

resource “aws_iam_role” “ecs_task_execution_role” {
name = “OpsToday-ecs-task-execution-role”

assume_role_policy = <<-EOS
{
“Version”: “2008-10-17”,
“Statement”: [
{
“Sid”: “”,
“Effect”: “Allow”,
“Principal”: {
“Service”: “ecs-tasks.amazonaws.com”
},
“Action”: “sts:AssumeRole”
}
]
}
EOS
}

resource “aws_iam_policy” “ecs_task_execution_role_policy” {
name = “OpsToday-ecs-task-execution-role-policy”
policy = <<-EOS
{
“Version”: “2012-10-17”,
“Statement”: [
{
“Effect”: “Allow”,
“Action”: [
“ecr:GetAuthorizationToken”,
“ecr:BatchCheckLayerAvailability”,
“ecr:GetDownloadUrlForLayer”,
“ecr:BatchGetImage”,
“logs:CreateLogStream”,
“logs:PutLogEvents”,
“logs:CreateLogGroup”
],
“Resource”: “*”
}
]
}
EOS
}

resource “aws_iam_role_policy_attachment” “ecs_task_execution_role_policy” {
role = aws_iam_role.ecs_task_execution_role.name
policy_arn = aws_iam_policy.ecs_task_execution_role_policy.arn
}