App Engine の概要

リージョン ID

REGION_ID は、アプリの作成時に選択したリージョンに基づいて Google が割り当てる省略形のコードです。一部のリージョン ID は、一般的に使用されている国や州のコードと類似しているように見える場合がありますが、このコードは国または州に対応するものではありません。2020 年 2 月以降に作成されたアプリの場合、REGION_ID.r が App Engine の URL に含まれています。この日付より前に作成されたアプリの場合、URL のリージョン ID は省略可能です。

詳しくは、リージョン ID をご覧ください。

App Engine アプリは、1 つ以上のサービスからなる単一のアプリケーション リソースで構成されています。各サービスは、それぞれ異なるランタイムを使用したり、異なるパフォーマンス設定で動作したりするように構成できます。各サービス内で、そのサービスの複数のバージョンをデプロイします。その後、各バージョンは、処理するように構成したトラフィックの量に応じて、1 つ以上のインスタンス内で実行されます。

アプリケーションのコンポーネント

アプリケーション リソースを作成すると、Google Cloud プロジェクト内に App Engine アプリが作成されます。App Engine アプリケーションは、アプリを構成するサービス、バージョン、およびインスタンスのリソースを格納する最上位のコンテナです。App Engine アプリを作成すると、アプリコードや、設定、認証情報、アプリのメタデータなどのすべてのリソースが、選択したリージョン内に作成されます。

各 App Engine アプリケーションには少なくとも 1 つのサービス（default サービス）があり、アプリの課金ステータスに応じて多数のバージョンを保持できます。詳細については、後述の上限をご覧ください。

次の図に、複数のサービスで動作する App Engine アプリの階層を示します。この図で、アプリは 2 つのサービスからなり、各サービスは複数のバージョンで構成されています。このうち 2 つのバージョンが、複数のインスタンス上で稼働しています。

アプリのサービス、バージョン、インスタンスの階層グラフ

Datastore など、他の Google Cloud サービスは App Engine アプリ全体で共有されます。詳細については、ウェブサービスの構造化をご覧ください。

サービス

App Engine 内のサービスを使用することで、大規模なアプリを論理コンポーネントに分解できます。これらのコンポーネントは、App Engine の機能を安全な方法で共有し、相互に通信できます。通常、App Engine サービスはマイクロサービスのように動作します。そのため、アプリ全体を単一のサービスで実行することも、複数のサービスを設計およびデプロイして、一連のマイクロサービスとして実行することもできます。

たとえば、お客様のリクエストを処理するアプリには、次のような異なるタスクを処理する個別のサービスが含まれていることがあります。

  • モバイル デバイスからの API リクエスト
  • 管理タイプの内部リクエスト
  • 課金パイプラインやデータ分析などのバックエンド処理

App Engine の各サービスは、アプリのソースコードと、対応する App Engine 構成ファイルで構成されています。サービスにデプロイする一連のファイルは、そのサービスの単一バージョンを表し、そのサービスに対してデプロイを行うたびに、同じサービス内に追加のバージョンが作成されます。

バージョン

それぞれのサービス内にアプリの複数のバージョンを用意することで、ロールバック用、テスト用、その他の一時的なイベント用といった、アプリの各種バージョンをすばやく切り替えることができます。トラフィックを移行または分割することで、1 つ以上の特定のバージョンのアプリにトラフィックをルーティングできます。

インスタンス

サービスに含まれる各バージョンは、1 つ以上のインスタンスで実行されます。デフォルトでは、App Engine は負荷に合わせてアプリのスケーリングを行います。アプリは、稼働中のインスタンスの数を増やしてパフォーマンスの一貫性を確保し、アイドル状態のインスタンスを最小限に減らしてコストを抑えます。インスタンスの詳細については、インスタンスの管理方法をご覧ください。

アプリケーション リクエスト

アプリの各サービスの名前やサービス内の各バージョンの名前は、一意でなければなりません。こうした一意の名前は、URL によってトラフィックを特定のリソースにターゲット指定およびルーティングするために使用できます。次に例を示します。

https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

なお、フレキシブル環境では、VERSION-dot-SERVICE-dot-PROJECT_ID（VERSION はバージョンの名前、SERVICE はサービス名、PROJECT_ID はプロジェクト ID）全体の長さを 63 文字以下にする必要があります。また、名前の先頭や末尾にハイフンは使用できません。すべて含めた長さが 63 文字を超える場合、エラー DNS address could not be found. が表示されることがあります。

受信ユーザー リクエストは、トラフィックを処理するように構成されている、さまざまなサービスまたはバージョンにルーティングされます。特定のサービスやバージョンを対象にトラフィックをルーティングすることもできます。詳しくは、リクエストの処理方法をご覧ください。

アプリケーション リクエストのロギング

アプリケーションがリクエストを処理するときに、独自のロギング メッセージを stdout と stderr に書き込むこともできます。アプリのログの詳細については、アプリケーション ログの書き込みをご覧ください。

上限

デプロイできるサービスやバージョンの最大数は、アプリが有料か無料かに応じて異なります。

制限 無料アプリ 有料アプリ
アプリごとの最大サービス数 5 210
アプリごとの最大バージョン数 15 210

基本スケーリングまたは手動スケーリングを適用する各サービスのインスタンス数には以下の上限があります。

手動 / 基本スケーリングを適用するバージョンごとの最大インスタンス数
無料アプリ 有料アプリ（米国） 有料アプリ（EU）
20 25（us-central の場合は 200） 25

また、アプリケーションの URL の文字数にも上限があります。

説明 上限
URL VERSION-dot-SERVICE-dot-PROJECT_ID のプロジェクト URL の最大文字数 63