Amplify Hostingの仕組み

Amplify Hosting がどのような流れでフロントエンドをデプロイするかの仕組みを整理します。

1. デプロイの流れ

Amplify Hostingでアプリケーションをデプロイする際の流れは以下のとおりです。

1.1 1. GitHubへのプッシュ

開発者がローカルでコードを修正し、GitHubリポジトリにプッシュします。これがデプロイのトリガーとなります。通常の開発フローと同じ git push コマンドを実行するだけで、特別な操作は必要ありません。

1.2 2. プッシュの検知

Amplifyは接続されたGitHubリポジトリを常に監視しています。プッシュが行われると、Amplifyが自動的にそれを検知し、ビルドプロセスを開始します。Amplifyコンソール上では、ビルドのステータスがリアルタイムで表示されます。

1.3 3. ソースコードの取得

Amplifyがリポジトリから最新のソースコードを取得します。指定されたブランチ(例:main)のコードがAmplifyのビルド環境にダウンロードされます。

1.4 4. ビルドの実行

amplify.yml に定義されたビルド設定(または自動検出されたデフォルト設定)に基づいて、ビルドが実行されます。依存関係のインストール(npm ci)、アプリケーションのビルド(npm run build)などが順番に実行されます。ビルド中にエラーが発生した場合はここで中断され、デプロイは行われません。

1.5 5. デプロイ

ビルドが成功すると、生成された成果物がAmplifyのインフラに自動でデプロイされます。SSRアプリケーションの場合は、サーバサイドの処理を実行する環境も自動で構成されます。

1.6 6. 公開

デプロイが完了すると、アプリケーションが公開され、ユーザがアクセスできる状態になります。カスタムドメインが設定されている場合は、そのドメインで最新のアプリケーションが配信されます。

この一連の流れがすべて自動で行われるため、開発者はコードを書いてプッシュするだけで、最新のアプリケーションが公開されます。

2. ビルド設定(amplify.yml)

Amplify Hostingのビルドプロセスは、amplify.ymlという設定ファイルによって制御されます。

前のセクションで説明したとおり、AmplifyはGitHubリポジトリを接続する際にフレームワークを自動検出し、そのフレームワークに適したビルド設定を自動で生成します。つまり、通常は開発者が amplify.yml を手動で作成する必要はありません。次のハンズオンセクションでも体験しますが、GitHubリポジトリを連携するだけで、Amplifyが適切なビルド設定を用意してくれます。

ただし、プロジェクト固有の要件がある場合(ビルド前にテストを実行したい、キャッシュの設定を調整したいなど)には、amplify.yml をリポジトリのルートに配置するか、Amplifyコンソールから編集することで、ビルドプロセスをきめ細かく制御できます。

以下は、Amplifyが自動生成するNext.jsアプリケーション向けのビルド設定の例です。

version: 1
frontend:
  phases:
    preBuild:
      commands:
        - npm ci
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: .next
    files:
      - '**/*'
  cache:
    paths:
      - .next/cache/**/*
      - node_modules/**/*

この設定ファイルの各セクションの役割は以下のとおりです。

  • preBuild … ビルド前に実行するコマンド。依存関係のインストールなどを行う
  • build … アプリケーションのビルドコマンドを実行する
  • artifacts … ビルド成果物の出力先を指定する
  • cache … ビルドを高速化するためにキャッシュするファイルを指定する

2.1 ビルド設定のカスタマイズ

通常はデフォルトのビルド設定のままで問題ありませんが、プロジェクトの要件に合わせてカスタマイズしたい場合は、amplify.yml をリポジトリに配置して上書きできます。

例えば、ビルド前にテストを実行したい場合は、preBuildフェーズにテストコマンドを追加します。

version: 1
frontend:
  phases:
    preBuild:
      commands:
        - npm ci
        - npm run test
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: .next
    files:
      - '**/*'

この設定により、テストが失敗した場合はビルドが中断され、問題のあるコードがデプロイされるのを防ぐことができます。S3 + CloudFrontの構成では、こうしたビルド前のチェックを自動化するにはGitHub Actionsなどを使って自分でCI/CDパイプラインを構築する必要がありますが、Amplifyでは amplify.yml に記述するだけで実現できます。