リージョン ID
REGION_ID は、アプリの作成時に選択したリージョンに基づいて Google が割り当てる省略形のコードです。一部のリージョン ID は、一般的に使用されている国や州のコードと類似しているように見える場合がありますが、このコードは国または州に対応するものではありません。2020 年 2 月以降に作成されたアプリの場合、REGION_ID.r は App Engine の URL に含まれています。この日付より前に作成されたアプリの場合、URL のリージョン ID は省略可能です。
詳しくは、リージョン ID をご覧ください。
アプリケーションをローカルで実行し、App Engine にデプロイしてテストする方法を説明します。
ローカルでの実行
デプロイ前にアプリケーションの機能をテストするには、普段使用している開発ツールを使用して、アプリケーションをローカル環境で実行します。
アプリケーションをデプロイする前に
アプリケーションをデプロイする前に、次のことを確認してください。
- Google Cloud プロジェクトのオーナーが App Engine 用に Google Cloud プロジェクトを設定する必要があります。
- ユーザー アカウントに必要な権限が含まれていること。
アプリケーションのデプロイ
gcloud app deploy コマンドを使用して、アプリケーションを App Engine にデプロイします。デプロイ中に、Cloud Build サービスが App Engine スタンダード環境で実行するアプリケーションのコンテナ イメージを作成します。各ビルドは、Google Cloud プロジェクトと同じリージョンで実行されます。詳細については、ビルドイメージの管理をご覧ください。
プログラムによってアプリをデプロイする場合は、Admin API を使用します。
サービスのデプロイ
アプリケーションを App Engine にデプロイするには、アプリケーションのサービスの各バージョンと、それぞれの構成ファイルをデプロイします。
アプリケーションのサービスのバージョンをデプロイするには、サービスの app.yaml ファイルがあるディレクトリから次のコマンドを実行します。
gcloud app deploy
このコマンドでファイルを指定しないと、現在のディレクトリにある app.yaml ファイルのみがデプロイされます。デフォルトで、deploy コマンドは、デプロイしたバージョンの一意の ID を生成します。そのバージョンを Google Cloud CLI で使用するように構成した Google Cloud プロジェクトにデプロイし、すべてのトラフィックを新しいバージョンに転送します。
特定のファイルを対象にするか、追加のパラメータを指定すると、コマンドのデフォルトの動作を変更できます。
- サービスの他の構成ファイルをデプロイするには、各ファイルを個別にターゲットとして指定してデプロイする必要があります。例:
gcloud app deploy cron.yaml gcloud app deploy dispatch.yaml gcloud app deploy index.yaml
- 独自のバージョン ID を指定するには、
--versionフラグを使用します。 - トラフィックが新しいバージョンに自動的にルーティングされないようにするには、
--no-promoteフラグを使用します。 - 特定の Google Cloud プロジェクトにデプロイするには、
--projectフラグを使用します。
たとえば、app.yaml ファイルで定義されているサービスを特定の Google Cloud プロジェクトにデプロイし、独自のバージョン ID を割り当て、トラフィックが新しいバージョンにルーティングされないようにするには、次のコマンドを実行します。
gcloud app deploy --project PROJECT_ID --version VERSION_ID --no-promote
このコマンドの詳細については、gcloud app deploy リファレンスをご覧ください。
複数のサービスのデプロイ
アプリケーションを構成する複数のサービスをデプロイまたは更新する場合にも、同じデプロイ コマンドを使用します。
開始する前に:
- 最初にアプリケーションのバージョンの 1 つを
defaultサービスにデプロイする必要があります。これで、後続のサービスを作成してデプロイできるようになります。 - 各サービスの ID は、対応する
app.yaml構成ファイルで指定する必要があります。サービス ID を指定するには、各構成ファイルにservice要素の定義を追加します。この要素の定義が構成ファイル内にないと、デフォルトでバージョンのデプロイ先はdefaultサービスとなります。
複数のサービスをデプロイする場合は、各サービスの app.yaml ファイルを個別にデプロイします。次のように、1 つの gcloud app deploy コマンドで、複数のファイルを指定できます。
gcloud app deploy service1/app.yaml service2/app.yaml
ビルドログの表示
Cloud Build がストリーミングしたビルドとデプロイのログは、Google Cloud コンソールの Cloud Build のビルド履歴セクションで確認できます。アプリのリージョンのビルドを表示するには、ページ上部の [リージョン] プルダウン メニューを使用して、フィルタするリージョンを選択します。
ビルドイメージの管理
新しいバージョンをデプロイするたびに、Cloud Build サービスによってコンテナ イメージが作成されます。このコンテナ イメージは、アプリのリージョンでビルドされ、App Engine スタンダード環境で動作します。
作成されたコンテナ イメージは、Container Registry の app-engine-tmp/app フォルダに保存されます。これらのイメージをダウンロードして、任意の場所に保存したり、別の場所で実行したりできます。デプロイが完了したコンテナ イメージは、App Engine ではもう必要でなくなります。不要になったイメージは自動的に削除されないので、保存容量の上限に達する前に削除するとよいでしょう。ただし、将来イメージが必要になった場合や、イメージのコピーを保持する場合は、削除する前にコピーをエクスポートする必要があります。Container Registry 内のイメージを管理する方法については、Container Registry のドキュメントをご覧ください。
ファイルの無視
.gcloudignore ファイルを使用すると、サービスをデプロイするときに App Engine にアップロードしないファイルとディレクトリを指定できます。これは、デプロイ時にアップロードする必要のないビルド アーティファクトやその他のファイルを無視する場合に便利です。
アプリケーションの表示
アプリケーションを App Engine にデプロイした後、次のコマンドを実行してブラウザを起動できます。https://PROJECT_ID.REGION_ID.r.appspot.com にアクセスすると、アプリケーションが表示されます。
gcloud app browse
トラフィック移行前の App Engine でのテスト
新しいバージョンを構成してトラフィックを受信する前に、App Engine でテストを行うことができます。たとえば、default サービスの新しいバージョンをテストする手順は次のとおりです。
新しいバージョンをデプロイしますが、トラフィックが新しいバージョンに自動的にルーティングされないようにするには、次のコマンドを実行します。
gcloud app deploy --no-promote
次の URL に移動して、新しいバージョンにアクセスします。
https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.comこれで、新しいバージョンを App Engine ランタイム環境でテストできるようになりました。ログを確認することでアプリケーションをデバッグできます。詳細については、アプリケーション ログの書き込みをご覧ください。
https://PROJECT_ID.REGION_ID.r.appspot.comに送信されたリクエストは、トラフィックを受信するように構成されたバージョンにルーティングされます。トラフィックが新しいバージョンに送信されるようにするには、Google Cloud コンソールでトラフィックを移行します。
デプロイしたバージョンを選択して、[トラフィックを移行] をクリックします。
同じ手順で他のサービスの新しいバージョンをテストできます。この場合、上記の URL の default をサービスの名前に置き換えます。
https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
特定のサービスとバージョンをターゲットにする方法については、リクエストのルーティング方法をご覧ください。
ビルド環境変数の使用
Buildpack をサポートするランタイム用のビルド環境変数を設定することもできます。
ビルド環境変数は、アプリのデプロイに使用する Buildpack の構成に指定できる Key-Value ペアです。たとえば、コンパイラ オプションを指定できます。
始める前に、次のことを行います。
- キーの先頭は大文字の ASCII 文字にする必要があります。キーには大文字の ASCII 文字、数字、アンダースコアのみ使用できます。
- 接尾辞に
GOOGLE_*キーを持つ変数は作成しないでください。 - 次のキーは Google で使用するために予約されています。
GOOGLE_RUNTIMEGOOGLE_RUNTIME_VERSIONGOOGLE_ENTRYPOINTGOOGLE_DEVMODE
- Buildpack でサポートされている任意の鍵を使用できます。
Buildpack で環境変数を使用するには、app.yaml ファイルで build_env_variables フィールドを指定します。
Buildpack の詳細については、こちらをご覧ください。
Cloud Trace の使用
Cloud Trace は、リクエストがアプリケーションを通じてどのように伝播するかを把握するために役立ちます。リクエストごとの詳しいレイテンシ情報の分析や、アプリケーション全体のレイテンシの確認などができます。
Cloud Trace でトレースの詳細を表示するには、トレースを検索して調査するの説明に従います。トレース エクスプローラでフィルタを使用して、特定の App Engine サービスやバージョンでトレースをフィルタできます。