LaravelプロジェクトをFargateを使用してECSにデプロイする

aws ecs

Fargateを利用してAmazon ECSにLaravelプロジェクトをデプロイします。

参考

前提

AWSアカウント
IAM Identity Centerにユーザーが作成済み
詳しくはこちらの手順を参照してください。
AWS CLIがインストール済み
詳しくはこちらの手順を参照してください。
AWS CLI用のSSOとプロファイルが設定済み
詳しくはこちらの手順を参照してください。

環境

Ubuntu 22.04.3 LTS (WSLで起動している)
Docker Engine 26.0.0
Laravel 11

アーキテクチャー図

今回作成するシステムのアーキテクチャー図です。

アーキテクチャー図

1. Laravelプロジェクトの作成

Laravelプロジェクトを作成します。
詳細はこちらの記事を参照してください。

上記の例を使う場合、Dockerfile を以下のように変更してください。
（プロジェクトソースをコンテナにコピーする処理と、いくつかのファイルのコピー元のパスを調整するための変更です）

Dockerfile:

FROM amazonlinux:2023

# （追加）プロジェクトソースをコンテナにコピー
COPY . /srv/example.com

# （変更）ファイルコピー処理のパスを調整
# 例: nginx/nginx.repo -> docker/web/nginx/nginx.repo

# NGINXインストール
RUN yum -y install yum-utils
COPY docker/web/nginx/nginx.repo /etc/yum.repos.d/nginx.repo
RUN yum -y install nginx-1.24.0
COPY docker/web/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf

# php-fpmとphp-mysqlndインストール
RUN yum -y install php8.2-fpm php8.2-mysqlnd
# 事前にディレクトリを作成しておかないとエラーになる
RUN mkdir /run/php-fpm
RUN mkdir /var/run/php
COPY docker/web/php/php-fpm.d/zzz-www.conf /etc/php-fpm.d/zzz-www.conf

ローカルでコンテナを起動する場合は docker-compose.yml も修正してください。
コンテナをビルドするパスをプロジェクトルートにし、Dockerfile のパスを指定する必要があります。

docker-compose.yml:

services:
  web:
    # "build" を変更
    build:
      context: .
      dockerfile: ./docker/web/Dockerfile
    volumes:
      - .:/srv/example.com
    ports:
      - "8080:80"
    command: bash -c "chmod 755 /srv/example.com/docker/web/start.sh && /srv/example.com/docker/web/start.sh"

2. リポジトリの作成

AWS管理コンソールからECRに移動し、Createボタンをクリックします。

AWS管理コンソールのECR画面

任意のリポジトリ名を入力し（例：laravel-project-repository）、Createをクリックします。

リポジトリ作成画面

3. Dockerイメージのプッシュ

以下の形式でDockerイメージをビルドします。

$ docker build -t <AWSアカウントID>.dkr.ecr.<ECRリポジトリリージョン>.amazonaws.com/laravel-project-repository .

Dockerfile がプロジェクトルートにない場合は -f オプションでファイルのパスを指定します。

$ docker build -t <AWSアカウントID>.dkr.ecr.<ECRリポジトリリージョン>.amazonaws.com/laravel-project-repository -f <Dockerfileのパス> .

すでにイメージがある場合は、以下のようにタグを付け直します。

$ docker tag <DockerイメージリポジトリまたはID>:<Dockerイメージタグ> <AWSアカウントID>.dkr.ecr.<ECRリポジトリリージョン>.amazonaws.com/laravel-project-repository:latest

AWS CLIを使ってAmazon ECRにログインします。

$ aws ecr get-login-password --region <ECRリポジトリリージョン> | docker login --username AWS --password-stdin <AWSアカウントID>.dkr.ecr.<ECRリポジトリリージョン>.amazonaws.com

その後、イメージをECRにプッシュします。

$ docker push <AWSアカウントID>.dkr.ecr.<ECRリポジトリリージョン>.amazonaws.com/laravel-project-repository:latest

管理コンソールでイメージが確認できます。

Dockerイメージ

4. クラスターの作成

管理コンソールのECSにアクセスし、Create Clusterをクリックします。

AWS管理コンソールのECS画面

クラスター名を入力し、「AWS Fargate (serverless)」を選択します。
例として laravel-project-cluster と指定し、Createをクリックします。

クラスター作成画面

5. ECSタスク実行用IAMロールの作成

コンテナやFargateエージェントにAWSサービスへのアクセス権限を与えるために、ECSタスク実行用のIAMロールを作成します。

管理コンソールのIAMに移動し、「Roles」をクリックします。

AWS管理コンソールのIAM画面

Create roleをクリックします。

ロール一覧画面

「AWS Service」をクリックし、「Elastic Container Service Task」を選択します。
Nextをクリックします。

Select Trusted Entityスクリーン1

Select Trusted Entityスクリーン2

ポリシー一覧から AmazonECSTaskExecutionRolePolicy を選択し、必要に応じてポリシー（例：S3アクセス）を追加します。
Nextをクリックします。

Add Permissionsスクリーン

ロール名に ecsTaskExecutionRole（任意の名前）を入力し、Create roleをクリックして完了です。

最終スクリーン

6. タスク定義の作成

タスク定義はECSタスクを作成する際に使用されます。
ここでは前節のLaravelプロジェクト用にタスク定義を作成します。

管理コンソールのTask definitionsにアクセスします。

!AWS管理コンソールのECS

「Create new task definition with JSON」を選択します。

タスク定義一覧画面

family に laravel-project-fargate、コンテナ名を web とします。
image にプッシュしたイメージのURIを指定し、portMappings と command を追加します。

task definition:

{
    "requiresCompatibilities": [
        "FARGATE"
    ],
    "family": "laravel-project-fargate",
    "containerDefinitions": [
        {
            "name": "web",
            "image": "<Your AWS account ID>.dkr.ecr.<Your ECS repository region>.amazonaws.com/laravel-project-repository:latest",
            "portMappings": [
                {
                    "containerPort": 80,
                    "protocol": "tcp"
                }
            ],
            "essential": true,
            "command": [
                "/bin/sh",
                "-c",
                "chmod 755 /srv/example.com/docker/web/start.sh && /srv/example.com/docker/web/start.sh"
            ]
        }
    ],
    "volumes": [],
    "networkMode": "awsvpc",
    "memory": "3 GB",
    "cpu": "1 vCPU",
    "executionRoleArn": "ecsTaskExecutionRole"
}

Createをクリックします。

7. セキュリティグループの作成

AWS管理コンソールのVPCにアクセスし、Security groupsをクリックします。

AWSマネジメント管理のVPC

Create security groupをクリックし、以下のセキュリティグループを作成します。

プライベート用

インバウンドルール:

Type	Port range	Source	Note
All traffic	All	このセキュリティグループID	VPCエンドポイントへのアクセス用
All traffic	All	パブリック用のセキュリティグループID	ロードバランサーからECSタスクへのアクセスを許可するため