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 つ以上のインスタンスで実行されます。デフォルトでは、App Engine は負荷に合わせてアプリのスケーリングを行います。アプリは、稼働中のインスタンスの数を増やしてパフォーマンスの一貫性を確保し、アイドル状態のインスタンスを最小限に減らしてコストを抑えます。インスタンスの詳細については、「インスタンスの管理方法」標準|フレキシブルをご覧ください。

App Engine フレキシブル環境では、インスタンスは Compute Engine リソースを基盤にしています。App Engine フレキシブル環境のインスタンスが使用する一部のリソース(ディスク、CPU、メモリなど)は、プロジェクトの Compute Engine API の割り当てにカウントされます。App Engine による Compute Engine リソースの使用に関する詳細は、App Engine フレキシブル環境の概要をご覧ください。

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

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

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

受信ユーザー リクエストは、トラフィックを処理するように構成されている、さまざまなサービスまたはバージョンにルーティングされます。特定のサービスやバージョンを対象にトラフィックをルーティングすることもできます。詳細については、「サービス間の通信」標準|フレキシブルをご覧ください。

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

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

上限

フレキシブル環境とスタンダード環境の両方で、サービスとバージョンは同じ上限を共有します。たとえば、同じアプリに標準バージョンとフレキシブル バージョンがある場合、それらのバージョンは同じ上限に向かってカウントされます。詳細については、「割り当てと上限」標準 | フレキシブルをご覧ください。