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 マップ
バックエンドサービス

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

App Hub は、グローバル（プレビュー版）とリージョンのリソースをサポートしています。詳細については、App Hub でサポートされているリソースをご覧ください。

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

全体的な設定プロセス

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 を有効にして、組織内のユーザーに適切なロールと権限を付与します。また、サービスプロジェクトをホストプロジェクトに接続します。

Console

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

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

プロジェクト作成者にはオーナーロール（roles/owner）が付与されます。デフォルトでは、この 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 の [設定] ページに移動します。

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

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）が付与されます。デフォルトでは、この 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

省略可: ホストプロジェクトの指標スコープにサービスプロジェクトを追加する

ホストプロジェクトのアプリケーションのシステム指標を表示するには、サービスプロジェクトをリソースコンテナとしてホストプロジェクトの指標スコープに追加します。App Hub ホストプロジェクトは、指標スコープをホストするスコーピングプロジェクトとして機能します。Google Cloud プロジェクトの指標スコープは、ホストプロジェクトでグラフ化してモニタリングできる時系列データのリソースコンテナのセットを定義します。リソースコンテナ、指標スコープ、スコーピングプロジェクトの詳細については、Cloud Monitoring: データモデルをご覧ください。

アプリケーションのシステム指標を表示するには、必要に応じて、モニタリング対象のサービスプロジェクトを手動でホストプロジェクトに追加または削除する必要があります。ただし、ホストプロジェクトを独自のサービスプロジェクトとして使用している場合、App Hub アプリケーションは同じプロジェクトに存在するため、プロジェクトを指標スコープに追加しないでください。

次の IAM ロールがあることを確認します。

App Hub アプリケーションの指標を表示するために必要な権限を取得するには、プリンシパルにMonitoring 閲覧者（roles/monitoring.viewer）IAM ロールを付与するよう管理者に依頼してください。詳細については、Monitoring へのアクセス権を付与するをご覧ください。
指標スコープの構成に必要な権限を取得するには、モニタリング管理者（roles/monitoring.admin）スコープ対象プロジェクトと、指標スコープに追加する各リソースコンテナに対する IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Console

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

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
[指標のスコープ] を選択します。

[指標スコープ] タブには、現在の Google Cloud プロジェクトでモニタリングされているリソースが一覧表示されます。また、指標スコープに現在の Google Cloud プロジェクトが含まれる Google Cloud プロジェクトも一覧表示されます。
Google Cloud プロジェクトを指標スコープに追加するには:
1. [Google Cloud プロジェクト] ペインで、[プロジェクトを追加] をクリックします。
2. [Google Cloud プロジェクトを追加] ダイアログで [プロジェクトを選択] をクリックし、モニタリングする必要なサービスプロジェクトのチェックボックスをオンにします。
3. 変更を保存するには、[プロジェクトを追加] をクリックします。
  
  [設定] ページが表示され、そのページの表が更新されて選択内容が一覧表示されます。

プロジェクトを指標スコープに追加した後、変更がすべての Monitoring システム全体に反映されるまで約 60 秒かかります。

Google Cloud コンソールを使用して指標スコープを構成する方法については、指標スコープを構成するをご覧ください。

gcloud

サービスプロジェクトをモニタリング対象リソースコンテナとして App Hub ホストプロジェクトに追加するには:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Google Cloud CLI を使用して指標スコープを構成する方法については、API を使用して指標スコープを構成するをご覧ください。

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

まだ作成していない場合は、サービスとワークロードのコンテナとなるアプリケーションを作成します。サービスプロジェクトのサービスとワークロードのスコープに基づいて、グローバル（プレビュー）またはリージョンアプリケーションを作成します。

グローバルアプリケーション（プレビュー）を使用すると、グローバル Google Cloud リソースから検出されたサービスとワークロードを登録できます。
リージョンアプリケーションを使用すると、リージョン Google Cloud リソースから検出されたサービスとワークロードを登録できます。

アプリケーションの作成後にアプリケーションスコープを変更することはできません。グローバルに利用可能なリソースはグローバルアプリケーションに、リージョンで利用可能なリソースはリージョンアプリケーション（プレビュー版）にのみ登録できます。詳細については、グローバルおよびリージョンの App Hub アプリケーションをご覧ください。

Console

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

[アプリケーション] に移動
[アプリケーションを作成] をクリックします。
[アプリケーションの作成] ページの [アプリケーションのリージョンと名前を選択] ペインで、アプリケーションに登録するサービスとワークロードのスコープに基づいて、次のいずれかを行います。
- グローバルロケーションからサービスとワークロードを登録できるアプリケーションを作成するには、[グローバル]（プレビュー）を選択します。
- 1 つの場所からサービスとワークロードを登録できるアプリケーションを作成するには:
  1. [リージョン] を選択します。
  2. リージョンを選択します。
[アプリケーション名] を入力し、[続行] をクリックします。
必要に応じて、次のフィールドにアプリケーションの詳細を追加します。詳しくは、このドキュメントの既存の App Hub アプリケーションを更新するをご覧ください。
[作成] をクリックします。

gcloud

APPLICATION_NAME という名前の新しいアプリケーションを作成し、表示名 APPLICATION_DISPLAY_NAME を設定します。
```
gcloud apphub applications create APPLICATION_NAME \
  --scope-type=SCOPE_TYPE \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
以下を置き換えます。
- APPLICATION_NAME: アプリケーションの名前。名前にはスペースなしの小文字の英数字のみを使用します。
- SCOPE_TYPE: アプリケーションに登録できるサービスとワークロードを定義するアプリケーションのスコープ。次の値のいずれかを使用できます。
  - REGIONAL
  - GLOBAL（プレビュー）
- REGION: アプリケーションのリージョン。--scope-type に応じて、値を us-east1 または global（プレビュー版）にします。

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

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

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

ID                DISPLAY_NAME              CREATE_TIME
APPLICATION_NAME  APPLICATION_DISPLAY_NAME  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: SCOPE_TYPE
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

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

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

Console

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

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

gcloud

criticality-type、environment-type、owner type の各属性でアプリケーションを更新します。
```
gcloud apphub applications update APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_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
```
以下を置き換えます。
- APPLICATION_DISPLAY_NAME: アプリケーションの表示名。
- 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 の形式にする必要があります（例: 222larabrown@gmail.com）。

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

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

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

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

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

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

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

Console

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

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

[サービスとワークロード] タブに、登録済みのサービスまたはワークロードが表示されます。登録ステータスの詳細については、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                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
[DISCOVERED_WORKLOAD_ID_1]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
[DISCOVERED_WORKLOAD_ID_2]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}     {'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                DISPLAY_NAME                 WORKLOAD_REFERENCE                                                                                                    CREATE_TIME
WORKLOAD_NAME     mywebserver-deployment1      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}   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                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
[DISCOVERED_SERVICE_ID_1]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
[DISCOVERED_SERVICE_ID_2]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}     {'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                DISPLAY_NAME                 SERVICE_REFERENCE                                                                                                                  CREATE_TIME
SERVICE_NAME      mywebserver-service1         {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}   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 の設定プロセスが完了しました。

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

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

ホストプロジェクト内のアプリケーションのシステム指標を表示するには、サービスプロジェクトをホストプロジェクトに追加した後、サービスプロジェクトをリソースコンテナとしてホストプロジェクトの指標スコープに追加します。詳細については、このドキュメントのホストプロジェクトの指標スコープにサービスプロジェクトを追加するをご覧ください。ホストプロジェクトからサービスプロジェクトを削除する場合は、ホストプロジェクトの指標スコープからサービスプロジェクトをリソースコンテナとして削除することを検討してください（ホストプロジェクトでアプリケーションのシステム指標の表示を選択した場合）。詳細については、このドキュメントのホストプロジェクトの指標スコープからサービスプロジェクトを削除する手順をご覧ください。

Console

サービスプロジェクトをホストプロジェクトに追加するには:

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

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

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

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

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

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

Console

プロジェクト内のアプリケーションを表示するには、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

省略可: アプリケーション指標を表示する

App Hub ホストプロジェクトで作成されたアプリケーションのシステム指標を表示できます。これらの指標は、アプリケーションのパフォーマンスと健全性のモニタリングに役立つゴールデンシグナル（トラフィック、エラー、レイテンシ、飽和度）に対応しています。

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

[サービスとワークロード] タブに、アプリケーションに登録されているサービスとワークロードのメタデータが表示されます。
省略可: 指標の表示期間を変更するには、期間セレクタを使用します。デフォルトの期間は 1 時間です。
登録されたサービスとワークロードのシステム指標を表示するには、bar_chart [指標] をクリックします。

次のゴールデンシグナルを含む表が表示されます。
- トラフィック: 選択した期間のリソースへの受信リクエスト率。
- サーバーエラー率: 選択した期間に 5xx シリーズの HTTP エラーコードを生成する受信リクエストの平均割合。
- P95 レイテンシ: 選択した期間に集約されたサービスリクエストのレイテンシの 95 パーセンタイル（ミリ秒単位）。
- CPU 使用率: 指定した期間に集計されたワークロードの CPU 使用率の平均（%）。値は通常、0.0～100.0 の数値ですが、100.0 を超える場合もあります。
- メモリ使用率: 指定した期間で集計されたワークロードのメモリ使用率の平均（%）。

省略可: グラフを使用して指標を調べる

App Hub プロジェクトの指標をグラフに表示するには、Metrics Explorer を使用します。ラベルに基づくフィルタを適用することで、グラフに表示するデータを制限できます。詳細については、Metrics Explorer でグラフを作成をご覧ください。

次の App Hub システムメタデータラベルをフィルタできます（プレビュー）。

apphub_application_host_project_id
apphub_application_id
apphub_application_location
apphub_workload_criticality_type
apphub_workload_environment_type
apphub_workload_id

App Hub メタデータラベルをグラフで可視化する手順は次のとおりです。他のシステムメタデータラベルと App Hub 指標についても、同じ手順を使用できます。

Google Cloud コンソールで、[Metrics Explorer] ページに移動します。
Metrics Explorer に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。
[指標] 要素の [指標を選択] メニューを開いてフィルタバーに「VM Instance」と入力し、サブメニューを使用して特定のリソースタイプと指標を選択します。
1. [Active resources] メニューで、[VM Instance] を選択します。
2. [有効な指標カテゴリ] メニューで、[一般的な指標] を選択します。
3. [Active metrics] メニューで [CPU utilization] を選択します。
4. [適用] をクリックします。
この指標の完全修飾名は compute.googleapis.com/instance/cpu/utilization です。
データの表示方法を構成します。特定のラベルの指標のみを表示するには、次の操作を行います。
1. [フィルタ] 要素で [フィルタを追加] をクリックし、[apphub_application_id] を選択します。値として、特定の App Hub 名を入力します。
2. [集計] エントリで、最初のメニューを [未集計] に設定します。
グラフの構成の詳細については、Metrics Explorer 使用時の指標の選択をご覧ください。

クリーンアップ

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

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

Console

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

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

[アプリケーション] に移動
アプリケーションの名前をクリックします。
アプリケーションの詳細が表示されているページで、[削除] をクリックします。
ホストプロジェクトからサービスプロジェクトを削除するには、このドキュメントのサービスプロジェクトの追加と削除をご覧ください。
ホストプロジェクトの指標スコープからサービスプロジェクトを削除するには:
1. Google Cloud コンソールで、[設定] ページに移動します。
  [設定] に移動
  
  検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
2. [指標のスコープ] を選択します。
3. [Google Cloud プロジェクト] ペインで [プロジェクトを削除] をクリックし、確認ダイアログを完了します。

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

前のコマンドを繰り返して、ホストプロジェクトからすべてのサービスプロジェクトを削除します。
ホストプロジェクトの指標スコープからサービスプロジェクトを削除します（プレビュー）。
```
gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
  --project=HOST_PROJECT_ID
```
前のコマンドを繰り返して、指標スコープのホストプロジェクトからすべてのサービスプロジェクトを削除します。

App Hub を設定する

サービスとワークロード

全体的な設定プロセス

前提条件

App Hub を設定する

App Hub を有効にする

Console

gcloud

省略可: ホスト プロジェクトの指標スコープにサービス プロジェクトを追加する

Console

gcloud

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

Console

gcloud

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

Console

gcloud

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

Console

gcloud

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

Console

gcloud

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

Console

アプリケーション

サービスとワークロード

gcloud

省略可: アプリケーション指標を表示する

省略可: グラフを使用して指標を調べる

クリーンアップ

Console

gcloud

次のステップ

省略可: ホストプロジェクトの指標スコープにサービスプロジェクトを追加する

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