App Hub を設定する

このドキュメントでは、Google Cloud でアプリケーションをビルド、運用、管理するために App Hub を設定する手順について説明します。このドキュメントは、App Hub を設定して管理するユーザーを対象としています。

App Hub を設定する場合、主なタスクは次のとおりです。

新しい App Hub ホストプロジェクトを作成するか、既存のプロジェクトをホストプロジェクトとして使用するかを決定します。
- 複数のホストプロジェクトを作成する予定の場合は、同じフォルダに作成することを強くおすすめします。
- App Hub のホストプロジェクトは、共有 VPC ホストプロジェクトと同じではなく、要件が同じではありません。たとえば、App Hub を使用するために共有 VPC ネットワークは必要ありません。このドキュメントでは、ホストプロジェクトへの参照はすべて、App Hub のホストプロジェクトを意味します。
- ホストプロジェクトは、それ自体以外のサービスプロジェクトにできません。
ホストプロジェクトで App Hub API を有効にします。
1 つ以上の App Hub サービスプロジェクトをホストプロジェクトに追加します。
- App Hub のサービスプロジェクトは、共有 VPC サービスプロジェクトと同じではなく、要件が同じではありません。このドキュメントでは、サービスプロジェクトへの参照はすべて、App Hub サービスプロジェクトを意味します。
App Hub ユーザーを App Hub 管理者、App Hub 編集者、または App Hub 閲覧者として指定します。
アプリケーションを作成します。
アプリケーションにサービスとワークロードを登録します。

サービスとワークロード

App Hub を使用すると、ホストプロジェクトに接続されているサービスプロジェクトのリソースを、サービスとワークロードとして利用できます。サービスとワークロードをアプリケーションに登録すると、リソースの観察とモニタリングが可能になります。次のリソースを App Hub サービスとして指定し、App Hub アプリケーションに登録できます。

転送ルール
URL マップ
バックエンドサービス

マネージドインスタンスグループ（MIG）は、個々の VM ではなくワークロードとして指定し、App Hub アプリケーションに登録できます。

App Hub は、HTTP または HTTPS トラフィックを使用するリージョン L7 外部および内部アプリケーションロードバランサをサポートします。

登録するワークロードとサービスは、アプリケーションと同じリージョンに存在する必要があります。したがって、以下の手順とコマンドでは、すべてのリソースが同じリージョンにあることを前提としています。指定できるリージョンについては、ロケーションをご覧ください。

全体的な設定プロセス

App Hub を設定する手順は次のとおりです。

アプリケーションに含める既存のリソースと、それらが属するプロジェクトを決定します。
App Hub ホストプロジェクトを作成し、プロジェクトで App Hub API を有効にします。必要に応じて、ビジネスの組織構造に基づいて、複数のホストプロジェクトを作成します。複数のプロジェクトを作成する場合は、新しいフォルダ内に作成することをおすすめします。
サービスプロジェクトを接続します。ホストプロジェクトを構成したら、アプリケーションに必要な基盤となるリソースを持つサービスプロジェクトをホストプロジェクトに接続します。次の点にご注意ください。
1. サービスプロジェクトは、ホストプロジェクトと同じ組織に存在する必要があります。サービスプロジェクトをホストプロジェクトに接続した後で、別の組織に移動することはできません。サービスプロジェクトを別の組織に移動するには、このドキュメントの手順に沿って、ホストプロジェクトへのサービスプロジェクトの接続を削除または解除する必要があります。その後、サービスプロジェクトを別の組織に接続できます。
2. 1 つのサービスプロジェクトを複数のホストプロジェクトに接続することはできません。
3. ホストプロジェクトは、独自のサービスプロジェクトにできますが、他のホストプロジェクトのサービスプロジェクトにすることはできません。
4. サービスプロジェクトをホストプロジェクトに接続した後は、ホストプロジェクトにサービスまたはワークロードのクエリを実行すると、すべてのサービスプロジェクトのすべてのサービスとワークロードが自動的に返されるようになります。
複数のワークロードとサービスを整理するアプリケーションを作成します。 次の点にご注意ください。
1. アプリケーションの名前が、ホストプロジェクトとロケーションで一意であることを確認してください。
2. サービスプロジェクトは、複数のアプリケーションでホストプロジェクトに接続できますが、個々のリソースは 1 つのアプリケーションにのみ登録できます。
サービスとワークロードをクエリし、アプリケーションに登録します。アプリケーションを作成したら、ホストプロジェクトに対して使用可能なサービスとワークロードをクエリしてください。クエリは、ホストプロジェクトと、そのホストプロジェクトに接続されたすべてのサービスプロジェクトに対して実行されます。また、それらのプロジェクト内のすべてのサービスとワークロードも返されます。次の点にご注意ください。
1. サービスやワークロードは 1 つのアプリケーションにのみ登録できます。
2. 登録するワークロードとサービスは、アプリケーションと同じリージョンに存在する必要があります。
3. 登録されたサービスとワークロードは、基盤となるインフラストラクチャリソースの更新の影響を受けません。つまり、サービスとワークロードとして機能する基盤となるリソースを削除しても、App Hub によって関連するワークロードとサービスがアプリケーションから削除されることはありません。ワークロードまたはサービスを個別に登録解除する必要があります。

前提条件

App Hub を設定する前に、次のタスクを行ってください。

ホストプロジェクトにする既存のプロジェクトを決定するか、新しいプロジェクトを作成します。新しいプロジェクトを作成することを強くおすすめします。
App Hub の Identity and Access Management（IAM）ロール（App Hub 管理者、App Hub 編集者、App Hub 閲覧者）を持つユーザーが決定されていることを確認します。

次の点にご注意ください。

ホストプロジェクトには、1 つ以上のサービスプロジェクトを接続できます。
1 つのサービスプロジェクトを複数のホストプロジェクトに接続することはできません。
サービスプロジェクトをホストプロジェクトに接続するユーザーには、サービスプロジェクトとホストプロジェクトの両方での App Hub 管理者の IAM ロールが必要です。詳細については、App Hub のロールと権限をご覧ください。

App Hub を設定する

このセクションでは、サンプルの App Hub アーキテクチャを作成します。

この例では、組織に 3 つのサービスプロジェクトがあり、インフラストラクチャリソースが次のようにプロジェクトにデプロイされています。

サービスプロジェクト 1 には、サービス 1 とサービス 2 の 2 つのインフラストラクチャリソースがあります。
サービスプロジェクト 2 には、サービス 3、ワークロード 1、ワークロード 2 の 3 つのインフラストラクチャリソースがあります。
サービスプロジェクト 3 には、サービス 4、ワークロード 3、ワークロード 4 の 3 つのインフラストラクチャリソースがあります。

サンプルの作成に選択したプロジェクトに、このセクションで説明するリソースが含まれていることを確認するか、手順に沿ってサンプルを調整できるように準備してください。

以降のセクションでは、App Hub のサンプルを作成する手順について説明します。ホストプロジェクトを作成してサービスプロジェクトをホストプロジェクトに追加し、次にアプリケーションを作成してサービスとワークロードをアプリケーションに接続します。この例では 3 つのサービスプロジェクトがありますが、追加するサービスプロジェクトは増減できます。

この例では、追加するサービスプロジェクトがすでに存在し、アプリケーションに追加するサービスとワークロードが含まれていることを前提としています。サンプルを作成する前に、アプリケーションに含めるサービスとワークロードをどのサービスプロジェクトに含めるかを決定します。

App Hub を有効にする

このセクションでは、新しいホストプロジェクトを選択または作成し、App Hub API を有効にして、組織内のユーザーに適切なロールと権限を付与します。また、サービスプロジェクトをホストプロジェクトに接続します。

コンソール

Google Cloud コンソールでプロジェクトの選択ページに移動します。

プロジェクトセレクタに移動
App Hub ホストプロジェクトとなる Google Cloud プロジェクトを選択または作成します。
Enable the required API.
Enable the API

プロジェクト作成者にはオーナーロール（roles/owner）が付与されます。デフォルトでは、この Identity and Access Management（IAM）ロールには、ほとんどの Google Cloud リソースに対する完全アクセスに必要な権限が含まれています。

プロジェクト作成者でない場合は、プロジェクトで必要な権限を適切なプリンシパルに付与する必要があります。たとえば、プリンシパルは Google アカウント（エンドユーザーの場合）やサービスアカウント（アプリケーションとコンピューティングワークロードの場合）になることもあります。このチュートリアルを完了するために必要な権限を取得するには、プロジェクトに対して次の IAM ロールを付与するよう管理者に依頼してください。
1. Google Cloud コンソールの [IAM] ページに移動します。
  
  [IAM] に移動
2. [アクセスを許可] をクリックします。アクセス権の付与ペインが開きます。
3. [新しいプリンシパル] フィールドに、ホストプロジェクトの App Hub 管理者のロール、つまり App Hub を管理するユーザーのメールアドレスを入力します。
4. [ロールを選択] をクリックし、[フィルタ] フィールドに「App Hub」と入力します。
5. App Hub 管理者のロールを選択し、[保存] をクリックします。
6. 各 App Hub サービスプロジェクトで、App Hub 管理者のロールを同じユーザーに付与します。
Google Cloud コンソールで、App Hub の [設定] ページに移動します。

[設定] に移動
[設定] ページで、[プロジェクトの接続] をクリックします。
次のいずれかを行います。
- プロジェクトのリストで、サービスプロジェクトとして追加するプロジェクトのチェックボックスをオンにします。
- プロジェクトを検索し、サービスプロジェクトとして追加するプロジェクトを選択します。
[選択] をクリックします。 [接続されたサービスプロジェクト] テーブルに、選択したサービスプロジェクトが表示されます。
[Close] をクリックします。

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Google Cloud CLI の最新バージョンがインストールされていることを確認します。Cloud Shell から次のコマンドを実行します。
```
gcloud components update
```
App Hub のホストプロジェクトとなる新しいプロジェクト HOST_PROJECT_ID を作成または選択します。
- Google Cloud プロジェクトを作成します:
```
gcloud projects create HOST_PROJECT_ID
```
- 作成した Google Cloud プロジェクトを選択します:
```
gcloud config set project HOST_PROJECT_ID
```
作成したホストプロジェクトで App Hub API を有効にします。
```
gcloud services enable apphub.googleapis.com \
    --project=HOST_PROJECT_ID
```
プロジェクト作成者にはオーナーロール（roles/owner）が付与されます。デフォルトでは、この Identity and Access Management（IAM）ロールには、ほとんどの Google Cloud リソースに対する完全アクセスに必要な権限が含まれています。

プロジェクト作成者でない場合は、プロジェクトで必要な権限を適切なプリンシパルに付与する必要があります。たとえば、プリンシパルは Google アカウント（エンドユーザーの場合）やサービスアカウント（アプリケーションとコンピューティングワークロードの場合）になることもあります。このチュートリアルを完了するために必要な権限を取得するには、プロジェクトに対して次の IAM ロールを付与するよう管理者に依頼してください。
1. 必要に応じて、App Hub を管理するユーザーにホストプロジェクトの App Hub 管理者のロールを付与します。管理者ごとに次のコマンドを繰り返します。
```
gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
  HOST_PROJECT_ADMIN は、ホストプロジェクトで App Hub 管理者のロールを持つユーザーに置き換えます。この値の形式は username@yourdomain です（例: robert.smith@example.com）。
2. App Hub を管理するユーザーに、サービスプロジェクトの App Hub 管理者ロールを付与します。サービスプロジェクトをホストプロジェクトに追加するには、App Hub 管理者のロールが必要です。このロールを持つユーザーは、サービスプロジェクトごとに 1 人以上必要です。1 人のユーザーが複数のサービスプロジェクトでロールを持つことができます。
```
gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
```
gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
```
gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
  次のように置き換えます。
  - SERVICE_PROJECT_1: この例の 3 つのサービスプロジェクトのうち最初のプロジェクト。
  - SERVICE_PROJECT_2: この例の 3 つのサービスプロジェクトのうち 2 番目のプロジェクト。
  - SERVICE_PROJECT_3: この例の 3 つのサービスプロジェクトのうちの 3 番目のプロジェクト。

App Hub ホストプロジェクトにサービスプロジェクトを追加します。

gcloud apphub service-projects add SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

アプリケーションを作成する

サービスとワークロードのコンテナとなるアプリケーションをまだ作成していない場合は、作成します。

コンソール

ホストプロジェクトにいることを確認します。
Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

[アプリケーション] に移動
[アプリケーションを作成] をクリックします。 [アプリケーションの作成] ペインが表示されます。
リージョンを選択します。
[アプリケーション名] を入力し、[続行] をクリックします。
[属性を追加] セクションで [表示名] を入力します。
必要に応じて、後続のフィールドにアプリケーションの詳細を追加します。詳しくは、このドキュメントの既存の App Hub アプリケーションを更新するをご覧ください。
[作成] をクリックします。

gcloud

APPLICATION_NAME という名前の新しいアプリケーションを作成し、表示名 APPLICATION_DISPLAY_NAME を設定します。--scope-type フラグは、アプリケーションに登録できるサービスとワークロードを定義します。REGIONAL のみがサポートされています。つまり、アプリケーションと同じリージョンのサービスとワークロードのみを登録できます。
```
gcloud apphub applications create APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_NAME' \
  --scope-type=REGIONAL \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
次のように置き換えます。
- APPLICATION_NAME: アプリケーションの名前。名前にはスペースを含まない小文字の英数字を使用する必要があります。
- APPLICATION_DISPLAY_NAME: アプリケーションの表示名。
- REGION: アプリケーションのリージョン。この値は us-east1 とします。

ホストプロジェクト内のアプリケーションを一覧表示します。

gcloud apphub applications list \
  --project=HOST_PROJECT_ID \
  --location=REGION

出力は次のようになります。

ID: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

作成したアプリケーションの詳細を取得します。

gcloud apphub applications describe APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

このコマンドは、次のような YAML 形式の情報を返します。

createTime: '2023-10-31T18:33:48.199394108Z'
displayName: APPLICATION_DISPLAY_NAME
name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
scope:
  type: REGIONAL
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

既存の App Hub アプリケーションを更新する

アプリケーションの作成後にアプリケーションの属性を更新することもできます。

コンソール

Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

[アプリケーション] に移動
アプリケーションの一覧で、更新するアプリケーションの [編集] をクリックします。
必要に応じてフィールドを編集し、[保存] をクリックします。
省略可: アプリケーションの重要性を示す [重要度] リストで、次のいずれかを選択します。
- ミッションクリティカル
- 高
- 中
- 低
省略可: [環境] フィールドで、ソフトウェアライフサイクルのステージを示すために、次のいずれかを選択します。
- 本番環境
- ステージング環境
- 開発環境
- テスト
省略可: デベロッパーオーナー、オペレーターオーナー、ビジネスオーナーに必要であるため、次の詳細を追加します。表示名を追加する場合は、所有者のメールアドレスを入力する必要があります。
1. 所有者の表示名を入力します。
2. 所有者のメールアドレスを入力します。この値は、username@yourdomain の形式（例: robert.smith@example.com）にする必要があります。
デベロッパー、オペレーター、ビジネスオーナーごとに、上記の手順を繰り返します。
[保存] をクリックします。

gcloud

criticality-type、environment-type、owner type の各属性でアプリケーションを更新します。
```
gcloud apphub applications update APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
  --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
  --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
次のように置き換えます。
- CRITICALITY_LEVEL: ビジネス運営におけるアプリケーション、サービス、ワークロードの重要度を示します。次のいずれかの値を指定します。
  - MISSION_CRITICAL
  - HIGH
  - MEDIUM
  - LOW
- ENVIRONMENT: ソフトウェアライフサイクルのステージを示します。次のいずれかの値を指定します。
  - PRODUCTION
  - STAGING
  - DEVELOPMENT
  - TEST
- DISPLAY-NAME-DEVELOPER、DISPLAY-NAME-OPERATOR、DISPLAY-NAME-BUSINESS: それぞれ、デベロッパー、オペレーター、ビジネスオーナーの表示名。
- EMAIL-NAME-DEVELOPER、EMAIL-NAME-OPERATOR、EMAIL-NAME-BUSINESS: それぞれ、デベロッパー、オペレーター、ビジネスオーナーのメールアドレス。これらの値は、username@yourdomain の形式にする必要があります（例: robert.smith@example.com）。

属性 environment-type の値が PRODUCTION のアプリケーションを一覧表示します。

gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=HOST_PROJECT_ID \
    --location=REGION

出力は次のようになります。

ID: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

サービスとワークロードを登録する

インフラストラクチャサービスとワークロードをアプリケーションに登録すると、サービスとワークロードが App Hub リソースとして登録されます。プレースホルダを使用して gcloud CLI でアプリケーションを作成する場合、3 つのサービスプロジェクトのサービスとワークロードは次のようになります。

サービスプロジェクト 1 には、サービス 1 とサービス 2 の 2 つのインフラストラクチャリソースがあります。
サービスプロジェクト 2 には、サービス 3、ワークロード 1、ワークロード 2 の 3 つのインフラストラクチャリソースがあります。
サービスプロジェクト 3 には、サービス 4、ワークロード 3、ワークロード 4 の 3 つのインフラストラクチャリソースがあります。

コンソール

Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

[アプリケーション] に移動
アプリケーションの名前をクリックします。[サービスとワークロード] タブに、サービスプロジェクトに存在する登録済みのサービスとワークロードのリストが表示されます。
登録するサービスまたはワークロードごとに、次の操作を行います。
1. [サービスとワークロード] タブで、[サービス / ワークロードを登録] をクリックします。
2. [サービスまたはワークロードの登録] ペインの [サービスまたはワークロードの選択] セクションで、サービスまたはワークロードを選択して [続行] をクリックします。
3. [属性を追加] セクションで、サービスまたはワークロードの名前を入力します。
4. 必要に応じて、以下のフィールドにサービスまたはワークロードの詳細を追加します。詳しくは、このドキュメントの既存の App Hub アプリケーションを更新するをご覧ください。[重要度] フィールドと [環境] フィールドに指定された値のいずれかを指定する必要がありますが、この値は、アプリケーションの作成時に設定した値とは異なる場合があります。
5. [登録] をクリックします。[サービスとワークロード] タブに、登録済みのサービスまたはワークロードが表示されます。登録ステータスの詳細については、App Hub のプロパティと属性をご覧ください。

gcloud

App Hub 編集者の権限を持つユーザーを追加します。
```
gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
  --member='user:APP_HUB_EDITOR' \
  --role='roles/apphub.editor'
```
APP_HUB_EDITOR を、ホストプロジェクトで App Hub 編集者のロールを持つユーザーに置き換えます。この値の形式は username@yourdomain です（例: robert.smith@example.com）。

ホストプロジェクトに接続されているサービスプロジェクト 2 から検出されたワークロードを一覧表示します。このコマンドは、アプリケーションに登録可能なワークロードを返します。

gcloud apphub discovered-workloads list \
  --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
  --project=HOST_PROJECT_ID \
  --location=REGION

未登録の MIG を含む出力は次のようになります。

ID: [DISCOVERED_WORKLOAD_ID_1]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

ID: [DISCOVERED_WORKLOAD_ID_2]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

出力からワークロード ID をコピーし、次の手順で使用します。

前の手順で作成したワークロードをアプリケーションに登録します。

gcloud apphub applications workloads create WORKLOAD_NAME \
  --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
  --display-name='mywebserver-deployment1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

次のように置き換えます。

WORKLOAD_NAME: ワークロードを登録するときの名前。
DISCOVERED_WORKLOAD_ID_2: 前の手順の出力のワークロード ID。

前の 2 つのステップを繰り返して、サービスプロジェクト 3 から必要なワークロードをフィルタして登録します。

省略可: criticality-type、environment-type、オーナー属性を使用してワークロードを更新できます。

gcloud apphub applications workloads update WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
  --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
  --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
  --project=HOST_PROJECT_ID \
  --location=REGION

criticality-type と environment-type に指定された値のいずれかを指定する必要がありますが、この値はアプリケーションの作成時に設定した値とは異なる場合があります。

アプリケーションに登録されている登録済みワークロードを一覧表示します。
```
gcloud apphub applications workloads list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
出力は次のようになります。
```
ID: WORKLOAD_NAME
DISPLAY_NAME: mywebserver-deployment1
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
CREATE_TIME: 2023-10-31T18:34:23
```
登録済みであるが、接続解除されたワークロードは、WORKLOAD_REFERENCE フィールドに空の値で示されます。登録ステータスの詳細については、App Hub のプロパティと属性をご覧ください。

ホストプロジェクトに接続されているサービスプロジェクト 1 の転送ルールを使用して、検出されたサービスを一覧表示します。このコマンドによって、アプリケーションに登録可能なサービスが返されます。

gcloud apphub discovered-services list \
  --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
  --project=HOST_PROJECT_ID \
  --location=REGION

出力は次のようになります。

ID: [DISCOVERED_SERVICE_ID_1]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

ID: [DISCOVERED_SERVICE_ID_2]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

出力からサービス ID DISCOVERED_SERVICE_ID_2 をコピーして、次の手順で使用します。

転送ルール testing-forwarding-rule-2 をサービスプロジェクト 1 にサービスとして登録します。

gcloud apphub applications services create SERVICE_NAME \
  --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
  --display-name='mywebserver-service1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

次のように置き換えます。

SERVICE_NAME: サービスを登録するときの名前。
DISCOVERED_SERVICE_ID_2: 前の手順の出力のサービス ID。

上記の手順を繰り返して、サービスを一覧表示し、これらのサービスをフィルタリングして、サービスプロジェクト 1、2、3 にサービスを登録します。

criticality-type 属性と environment-type 属性でサービスを更新します。

gcloud apphub applications services update SERVICE_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID  \
  --location=REGION

APPLICATION_NAME アプリケーションと HOST_PROJECT_ID ホストプロジェクトの登録済みサービスを一覧表示します。

gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

各サービスの出力は、次のようになります。

ID: SERVICE_NAME
DISPLAY_NAME: mywebserver-service1
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
CREATE_TIME: 2023-11-01T21:38:08

登録済みであるが、接続解除されているサービスは、SERVICE_REFERENCE フィールドに空の値で示されます。

APPLICATION_NAME アプリケーションと HOST_PROJECT_ID ホストプロジェクト内のサービスを、environment-type 属性が PRODUCTION に設定されているものにフィルタリングします。
```
gcloud apphub applications services list \
  --filter='attributes.environment.type=PRODUCTION' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION
```

App Hub の設定プロセスが完了しました。

サービスプロジェクトを追加または削除する

サービスプロジェクトの接続を変更して、さまざまなインフラストラクチャリソースをアプリケーションにグループ化して使用できます。

コンソール

サービスプロジェクトをホストプロジェクトに追加するには、次のようにします。

Google Cloud コンソールで、App Hub の [設定] ページに移動します。

[設定] に移動
[設定] ページで、[プロジェクトの接続] をクリックします。
表示されたペインで、プロジェクトを検索するか、表示されたリストから、サービスプロジェクトとして追加するプロジェクトのチェックボックスをオンにします。
[選択] をクリックします。 [接続されたサービスプロジェクト] テーブルに、選択したプロジェクトがホストプロジェクトのサービスプロジェクトとして表示されます。
[Close] をクリックします。

ホストプロジェクトからサービスプロジェクトを削除するには:

Google Cloud コンソールで、App Hub の [設定] ページに移動します。

[設定] に移動
[設定] ページで、サービスプロジェクトとして削除するプロジェクトのチェックボックスをオンにします。
[プロジェクトを接続解除] をクリックします。[接続されたサービスプロジェクト] テーブルが更新され、ホストプロジェクトに接続されたプロジェクトのみが表示されます。

gcloud

サービスプロジェクトをホストプロジェクトに追加するには、次のようにします。

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

SERVICE_PROJECT_ID は、ホストプロジェクトに追加するサービスプロジェクトの名前に置き換えます。ホストプロジェクトからサービスプロジェクトを削除するには:

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

既存のアプリケーション、サービス、ワークロードを表示する

プロジェクト内のアプリケーションを表示したり、アプリケーション内のサービスとワークロードを一覧表示したりできます。

コンソール

プロジェクト内のアプリケーションを表示するには、Google Cloud コンソールで App Hub の [アプリケーション] ページに移動します。

[アプリケーション] に移動
サービスとワークロードを一覧表示するには:
アプリケーション
1. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。
  [アプリケーション] に移動
2. アプリケーションの名前をクリックします。アプリケーションに登録されているサービスとワークロードのリストが記載されたページが表示されます。
3. 省略可: サービスまたはワークロードをフィルタするには:
  1. [フィルタ] フィールドで、[重要度] などのフィルタを選択します。
  2. 値として [高] を選択します。
    アプリケーションに登録されている重要度の高いサービスとワークロードのリストが表示されます。
サービスとワークロード
1. Google Cloud コンソールで、App Hub の [Services とワークロード] ページに移動します。
  [サービスとワークロード] に移動
2. [リージョン] リストで、サービスとワークロードを表示するリージョンを選択します。たとえば、us-east1 を選択します。
  [サービスとワークロード] ページには、us-east1 に関連付けられた、接続済みのサービスプロジェクトのすべてのサービスとワークロードが表示されます。
3. 省略可: サービスまたはワークロードをフィルタするには:
  1. [フィルタ] フィールドで [環境] などのフィルタを選択します。
  2. 値として [本番環境] を選択します。
    アプリケーションに登録されている本番環境のサービスとワークロードのリストが表示されます。

gcloud

プロジェクト内のアプリケーションを表示するには:

gcloud apphub applications list \
    --project=HOST_PROJECT_ID \
    --location=REGION

アプリケーション内の登録済みサービスを一覧表示するには:

gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

アプリケーション内の登録済みワークロードを一覧表示するには:

gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

クリーンアップ

既存のアプリケーションをクリーンアップし、ホストプロジェクトからサービスプロジェクトの接続を削除して、プロジェクトに関連するリソースを削除します。これにより、サービスプロジェクトのリソースの自動検出が停止します。

これを行うには、まず、アプリケーションに登録されているワークロードとサービスを削除する必要があります。

コンソール

Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

[アプリケーション] に移動
アプリケーションの名前をクリックします。アプリケーションに登録されているサービスとワークロードのリストが表示されます。
サービスまたはワークロードの登録を解除します。
1. [サービスとワークロード] タブの [登録済みのサービスとワークロード] セクションで、登録を解除するサービスまたはワークロードの名前をクリックします。
2. [詳細] タブで、[サービスの登録を解除] または [ワークロードの登録を解除] をクリックして、サービスまたはワークロードを [検出済み] リソースとして更新します。
  [サービスとワークロード] タブに、ワークロードの登録が解除されたことを示すアラートが表示されます。
3. サービスとワークロードごとに、この手順を繰り返します。
App Hub の [アプリケーション] ページに移動します。

[アプリケーション] に移動
アプリケーションの名前をクリックします。
アプリケーションの詳細が表示されているページで [削除] をクリックします。
このドキュメントでは、サービスプロジェクトの追加や削除の手順に沿って、ホストプロジェクトからサービスプロジェクトを削除します。

gcloud

アプリケーションの登録済みワークロードを一覧表示します。

gcloud apphub applications workloads list \
  --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
  --location=REGION

アプリケーションからワークロードの登録を解除します。
```
gcloud apphub applications workloads delete WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
これで、ワークロードは、アプリケーションに登録可能な検出されたワークロードになります。
先ほどのコマンドを繰り返して、残りの登録済みワークロードをアプリケーションから削除します。

アプリケーションの登録済みサービスを一覧表示します。

gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

アプリケーションからサービスの登録を解除します。
```
gcloud apphub applications services delete SERVICE_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
これで、サービスが検出されたサービスになり、アプリケーションに登録できるようになりました。
上記のコマンドを繰り返して、残りの登録済みサービスをアプリケーションから登録解除します。

アプリケーションを削除します。

gcloud apphub applications delete APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

ホストプロジェクトからサービスプロジェクトを削除します。

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
  --project=HOST_PROJECT_ID

ホストプロジェクトからすべてのサービスプロジェクトを削除するには、前述のコマンドを繰り返します。

App Hub を設定する

サービスとワークロード

全体的な設定プロセス

前提条件

App Hub を設定する

App Hub を有効にする

コンソール

gcloud

アプリケーションを作成する

コンソール

gcloud

既存の App Hub アプリケーションを更新する

コンソール

gcloud

サービスとワークロードを登録する

コンソール

gcloud

サービス プロジェクトを追加または削除する

コンソール

gcloud

既存のアプリケーション、サービス、ワークロードを表示する

コンソール

アプリケーション

サービスとワークロード

gcloud

クリーンアップ

コンソール

gcloud

次のステップ

サービスプロジェクトを追加または削除する