App Engine へのデプロイ

このページでは、Cloud Build を使用して App Engine にアプリケーションをデプロイする方法について説明します。Cloud Build を初めて使用する場合は、最初にクイックスタートビルド構成の概要をご覧ください。

App Engine は、大規模なウェブ アプリケーションを開発およびホスティングするための、フルマネージド型のサーバーレス プラットフォームです。App Engine の詳細については、App Engine のドキュメントをご覧ください。

始める前に

  • App Engine API を有効にします。

    App Engine API を有効にする

  • App Engine 管理者ロールとサービス アカウント ユーザーを、Cloud Build サービス アカウントに付与します。

    1. Cloud Build 設定ページを開きます。

      Cloud Build 設定ページを開く

    2. App Engine 管理者ロールとサービス アカウント ユーザー ロールの両方のステータスを [有効] に設定します。

  • このページで gcloud コマンドを実行するには、gcloud コマンドライン ツールをインストールします。

  • ビルドして App Engine にデプロイするアプリケーションのソースコードを保持します。

デプロイを構成する

Cloud Build を使用すると、一般公開されているコンテナ イメージを使用してタスクを実行できます。これを行うには、Cloud Build 構成ファイルのビルド step にイメージを指定します。

App Engine の gcloud app deploy コマンドを使用すると、ソースコードを使用してイメージをビルドし、そのイメージを App Engine にデプロイできます。構成ファイルのビルドステップで gcloud イメージを使用すると、イメージ内で gcloud コマンドを呼び出せます。このビルドステップに渡された引数が gcloud ツールに直接渡されるため、このイメージで任意の gcloud コマンドを実行できます。

アプリケーションを App Engine にデプロイするには:

  1. Cloud Build 構成ファイルcloudbuild.yaml または cloudbuild.json という名前で作成します。

  2. config ファイルで次の操作を行います。

    • name フィールドを追加して gcloud ビルドステップを指定します。
    • gcloud app deploy コマンドを呼び出すため、app deployargs フィールドに追加します。
    • timeout フィールドをビルドステップに追加します。Cloud Build ビルドステップとビルドのデフォルトのタイムアウトは 10 分です。このため、App Engine のデプロイでは完了までにさらに時間がかかる場合があります。より長いタイムアウトを指定すると、gcloud app deploy の完了までに 10 分を超える時間を要する場合でもビルドがタイムアウトしなくなります。

    YAML

    steps:
    - name: 'gcr.io/cloud-builders/gcloud'
      args: ['app', 'deploy']
      timeout: '1600s'
    

    JSON

    {
      "steps": [
      {
        "name": "gcr.io/cloud-builders/gcloud",
        "args": [
          "app",
          "deploy"
         ],
        "timeout": "1600s"
      }
      ]
    }
    
  3. ビルドを開始します。ここで、[SOURCE_DIRECTORY] はソースコードへのパスまたは URL です。

     gcloud builds submit [SOURCE_DIRECTORY]
    

継続的デプロイ

Cloud Build トリガーを作成すると、App Engine にソフトウェアを自動的にデプロイできます。トリガーを構成すると、ソースコードを更新するたびにイメージをビルドしてデプロイできます。

App Engine へのデプロイを自動化するには:

  1. リポジトリで、gcloud app deploy コマンドを呼び出すステップを構成ファイルに追加します。

    YAML

    steps:
    - name: 'gcr.io/cloud-builders/gcloud'
      args: ['app', 'deploy']
      timeout: '1600s'
    

    JSON

    {
      "steps": [
      {
        "name": "gcr.io/cloud-builders/gcloud",
        "args": [
          "app",
          "deploy"
         ],
        "timeout": "1600s"
      }
      ]
    }
    
  2. 前のステップで作成した構成ファイルを使用して、ビルドトリガーを作成します。

    1. Google Cloud Console で [トリガー] ページを開きます。

      [トリガー] ページを開く

    2. ページの上部にあるプロジェクト セレクタのプルダウン メニューからプロジェクトを選択します。

    3. [開く] をクリックします。

    4. [トリガーを作成] をクリックします。

      [トリガーの作成] ページで、次の設定を入力します。

      1. トリガーの名前を入力します。

      2. トリガーを開始するリポジトリ イベントを選択します。

      3. ソースコードとビルド構成ファイルを格納するリポジトリを選択します。

      4. トリガーを開始するブランチまたはタグ名を正規表現で指定します。

      5. ビルド構成: 以前に作成したビルド構成ファイルを選択します。

    5. [作成] をクリックして、ビルドトリガーを保存します。

リポジトリに新しいコードを push すると、ビルドが自動的に開始し、App Engine にデプロイされます。

Cloud Build トリガーの作成方法については、ビルドトリガーの作成と管理をご覧ください。

次のステップ