アプリケーションのテストとデプロイ

アプリケーションのテストとデプロイ

Python |Java |Node.js |Go |Ruby |PHP |.NET

アプリケーションをローカルで実行する方法と、App Engine にデプロイしてテストする方法を説明します。

ローカルでの実行

デプロイ前にアプリケーションの機能をテストするには、普段使用している開発ツールを使用して、アプリケーションをローカル環境で実行します。

アプリケーションのデプロイ

gcloud app deploy コマンドで App Engine にアプリケーションをデプロイします。このコマンドは、Cloud Build サービスを使用してコンテナイメージを自動的に作成し、そのイメージを App Engine フレキシブル環境にデプロイします。このコンテナには、ローカルでランタイムイメージに行った変更が含まれます。

プログラムによってアプリをデプロイするには、Admin API を使用します。

始める前に

アプリケーションをデプロイする前に、次のことを確認してください。

GCP プロジェクトのオーナーが App Engine を有効にしている。
ユーザーアカウントに必要な権限が割り当てられている。

デプロイの成功の確認

更新されたヘルスチェックを有効にすると、デプロイしたアプリケーションが正常な状態でない場合にデプロイがロールバックされます。

最初のアプリケーションをフレキシブル環境にデプロイするときに、仮想マシン（VM）や他のインフラストラクチャが設定されていると、遅延が発生することがあります。最初のセットアップ後、ヘルスチェックは、インスタンスが正常で、トラフィックを受信可能な状態にであることを確認します。app.yaml ファイルの liveness_check セクションの initial_delay_sec フィールドで指定された時間内に、アプリケーションが準備完了ステータスにならない場合、デプロイは失敗し、ロールバックされます。

アプリケーションが準備完了になるまで時間がかかる場合があります。たとえば、アプリケーションを初期化するために、大きなファイルをダウンロードしたり、キャッシュをプリロードしたりする場合があります。更新されたヘルスチェックを使用している場合は、app.yaml ファイル内の readiness_check セクションで app_start_timeout_sec 構成を変更して、この時間を延長できます。

サービスのデプロイ

アプリケーションを App Engine にデプロイするには、アプリケーションのサービスの各バージョンと、それぞれの構成ファイルをデプロイします。

アプリケーションのサービスの特定バージョンをデプロイするには、サービスの app.yaml ファイルが保存されているディレクトリ内から次のコマンドを実行します。

gcloud app deploy

このコマンドでファイルを指定しないと、現在のディレクトリにある app.yaml ファイルのみがデプロイされます。デフォルトでは、deploy コマンドはデプロイするバージョンの一意の ID を生成します。さらに、gcloud ツールで使用するように構成した GCP プロジェクトにバージョンをデプロイし、すべてのトラフィックを新しいバージョンにルーティングします。

特定のファイルを対象にするか、追加のパラメータを指定すると、コマンドのデフォルトの動作を変更できます。

サービスの他の構成ファイルをデプロイするには、各ファイルを個別にターゲットとしてデプロイする必要があります。例:
```
gcloud app deploy cron.yaml
gcloud app deploy dispatch.yaml
gcloud app deploy index.yaml
```
独自のバージョン ID を指定するには、--version フラグを使用します。
トラフィックが新しいバージョンに自動的にルーティングされないようにするには、--no-promote フラグを使用します。
特定の GCP プロジェクトにデプロイするには、--project フラグを使用します。

たとえば、app.yaml に定義されているサービスを特定の GCP プロジェクトにデプロイし、独自のバージョン ID を割り当て、トラフィックが新しいバージョンにルーティングされないようにするには、次のコマンドを実行します。

gcloud app deploy --project PROJECT_ID --version VERSION_ID --no-promote

このコマンドの詳細については、gcloud app deploy リファレンスをご覧ください。

複数のサービスのデプロイ

アプリケーションを構成する複数のサービスをデプロイまたは更新する場合にも、同じデプロイコマンドを使用します。

複数のサービスをデプロイするには、各サービスの app.yaml ファイルを個別にデプロイする必要があります。次に例を示します。

gcloud app deploy service1/app.yaml
gcloud app deploy service2/app.yaml

1 つのデプロイコマンドで、複数のファイルを指定できます。

gcloud app deploy service1/app.yaml service2/app.yaml

複数のサービスをデプロイするための要件

最初にアプリケーションのバージョンを default サービスにデプロイする必要があります。これで、以降のサービスを作成してデプロイできるようになります。
各サービスの ID は、対応する app.yaml 構成ファイルで指定する必要があります。サービス ID を指定するには、各構成ファイルに service 要素の定義を追加します。デフォルトでは、この要素の定義が構成ファイル内にない場合、バージョンのデプロイ先は default サービスとなります。

ファイルの無視

.gcloudignore ファイルを使用すると、サービスのデプロイ時に GCP にアップロードしないファイルとディレクトリを指定できます。これは、ビルドアーティファクトや、デプロイ時にアップロードする必要のないその他のファイルを無視する場合に便利です。

.gcloudignore ファイルの構文については、gcloud リファレンスをご覧ください。

デプロイで使用するコンテナを手動で作成する

Google Cloud Platform 以外でコンテナイメージを作成するには、イメージをコンテナイメージリポジトリにアップロードしてから、gcloud app deploy コマンドを使用してイメージを App Engine にデプロイする必要があります。

たとえば、Docker でローカルにコンテナイメージを作成する場合、このイメージを Google Container Registry に push し、コマンドの --image-url フラグにイメージの URL を指定します。

gcloud app deploy --image-url gcr.io/YOUR_PROJECT_ID/YOUR_CONTAINER_IMAGE

自動連続デプロイパイプラインの使用

Cloud Build では、継続的デプロイパイプラインを使用してデプロイを自動化できます。詳細については、Cloud Build ドキュメントのアーティファクトのデプロイおよびビルドトリガーを使用したビルドの自動化をご覧ください。

PHP の Docker ベースイメージ

PHP カスタムランタイムアプリケーションをゼロから作成する場合は、Dockerfile で提供されるベースイメージを使用します。

バージョン	Docker コマンド
PHP 5.6	`FROM gcr.io/google-appengine/php56`
PHP 7.0	`FROM gcr.io/google-appengine/php70`
PHP 7.1	`FROM gcr.io/google-appengine/php71`

ベースイメージのソースコードは https://github.com/GoogleCloudPlatform/php-docker から入手できます。

アプリケーションの表示

アプリケーションを App Engine にデプロイした後、次のコマンドを実行してブラウザを起動し、http://YOUR_PROJECT_ID.appspot.com にアクセスすると、アプリケーションが表示されます。

gcloud app browse

App Engine でのテスト

新しいバージョンを構成してトラフィックを受信する前に、App Engine でテストを行うことができます。たとえば、default サービスの新しいバージョンをテストするには、次のようにします。

--no-promote フラグを指定して、新しいバージョンをデプロイします。
```
gcloud app deploy --no-promote
```
次の URL に移動して、新しいバージョンにアクセスします。
```
http://VERSION_ID.default.YOUR_PROJECT_ID.appspot.com
```
注: バージョン ID は GCP Console で確認できます。また、デプロイ時に --version フラグで指定できます。デプロイ時に gcloud ツールの出力でバージョン ID も確認することもできます。

これで、新しいバージョンを App Engine ランタイム環境でテストできます。アプリケーションをデバッグするには、Google Cloud Platform Console の Stackdriver ログビューアでアプリケーションのログを表示します。詳細については、アプリケーションログの書き込みをご覧ください。

http://YOUR_PROJECT_ID.appspot.com に送信されたリクエストは、トラフィックを受信するように以前に構成したバージョンに引き続きルーティングされます。
トラフィックを新しいバージョンに送信するには、GCP Console を使用してトラフィックを移行します。

バージョンの管理

デプロイしたバージョンを選択して、[トラフィックを移行] をクリックします。

同じ手順で他のサービスの新しいバージョンをテストできます。この場合、上記の URL の default をサービスの名前に置き換えます。

http://VERSION_ID.SERVICE_ID.YOUR_PROJECT_ID.appspot.com

特定のサービスとバージョンをターゲットにする方法については、リクエストのルーティング方法をご覧ください。

トラブルシューティング

アプリケーションのデプロイ時に発生する可能性のある一般的なエラーメッセージは次のとおりです。

PERMISSION_DENIED: Operation not allowed
The "appengine.applications.create" permission is required.: 必要な App Engine アプリケーションが GCP プロジェクトに含まれていない場合、gcloud app deploy コマンドが gcloud app create コマンドを実行しようとして失敗する可能性があります。App Engine アプリケーションを作成するために必要な権限があるのは、オーナーの役割を持つアカウントのみです。

このページは役立ちましたか？評価をお願いいたします。

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

最終更新日: 8月 27, 2019