単一のプロジェクトを使用して App Hub アプリケーションを作成する

Console

このチュートリアルを完了するために必要な権限を取得するには、プロジェクトに対する必要な IAM ロールを付与するよう管理者に依頼してください。

1. Google Cloud コンソールの [IAM] ページに移動します。

   [IAM] に移動

2. [person_addアクセスを許可] をクリックします。アクセス権の付与ペインが開きます。

3. [新しいプリンシパル] フィールドに、ホスト プロジェクトの App Hub 管理者のロール、つまり App Hub を管理するユーザーのメールアドレスを入力します。

4. [ロールを選択] をクリックし、[フィルタ] フィールドに「App Hub」と入力します。

5. [App Hub 管理者] ロールを選択します。

6. [別のロールを追加] をクリックし、[ロールを選択] リストから [Monitoring 閲覧者] を選択します。

7. [保存] をクリックします。

gcloud

1. App Hub を使用するユーザーにロールを付与するには、必要に応じて IAM ロールを置き換えて、次のコマンドを繰り返します。詳細については、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 です（例: 222larabrown@gmail.com）。

2. App Hub を管理するユーザーに、サービス プロジェクトの App Hub 管理者のロールを付与します。サービス プロジェクトをホスト プロジェクトに追加するには、App Hub 管理者のロールが必要です。サービス プロジェクトごとに、このロールを持つユーザーが少なくとも 1 人必要です。この例では、ホスト プロジェクトがサービス プロジェクトとして機能します。

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
      --member='user:HOST_PROJECT_ADMIN' \
      --role='roles/apphub.admin'

   SERVICE_PROJECT_ID は、HOST_PROJECT_ID の名前に置き換えます。

3. App Hub を管理するユーザーに、ホスト プロジェクトの Monitoring 閲覧者のロールを付与します。指標を表示するには、ホスト プロジェクトに対する Monitoring 閲覧者のロールが必要です。

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
      --member='user:HOST_PROJECT_ADMIN' \
      --role='roles/monitoring.viewer'

Console

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

   [設定] に移動

2. [設定] ページで、[プロジェクトを接続] をクリックします。

3. 開いたペインで、表示されたリストからプロジェクトを検索し、App Hub サービス プロジェクトのチェックボックスをオンにします。

4. [選択] をクリックします。 [接続されたサービス プロジェクト] テーブルに、選択したホスト プロジェクトがサービス プロジェクトとして表示されます。

5. [閉じる] をクリックします。

gcloud

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

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

Console

1. App Hub ホスト プロジェクトにいることを確認します。

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

   [アプリケーション] に移動

3. [アプリケーションを作成] をクリックします。

4. [アプリケーションを作成] ページの [アプリケーションのリージョンと名前を選択] ペインで、[リージョン] を選択します。

5. [リージョン] リストで [us-west1] を選択します。

6. [アプリケーション名] フィールドに「tutorial-application」と入力します。この名前は一意の識別子であり、アプリケーションの作成後に変更することはできません。

7. 表示名 Tutorial を入力し、[続行] をクリックします。これは、更新可能なユーザー フレンドリーな名前です。詳細については、既存のアプリケーションを更新するをご覧ください。

8. [属性を追加] ペインの [重要度] リストで、[高] を選択します。重要度は、アプリケーション、サービス、またはワークロードが、ビジネス運営にとってどの程度重要であるかを示します。

9. [環境] フィールドで、ソフトウェア ライフサイクルのステージを示すために [本番環境] を選択します。

10. [続行] をクリックします。

11. [オーナーを追加] ペインで、デベロッパー オーナー、オペレーター オーナー、ビジネス オーナーの次の詳細を追加します。表示名を追加する場合は、所有者のメールアドレスを入力する必要があります。

    1. 所有者の表示名を入力します。
    2. オーナーのメールアドレスを入力します。この値は、username@yourdomain の形式（例: 222larabrown@gmail.com）にする必要があります。

12. デベロッパー、オペレーター、ビジネス オーナーごとにこの手順を繰り返します。

13. [作成] をクリックします。

新しいアプリケーションが作成され、[アプリケーション] ページに表示されます。

gcloud

1. 作成した App Hub ホスト プロジェクトを選択します。

   gcloud config set project HOST_PROJECT_ID

2. リージョン us-west1 に tutorial-application という名前の新しいアプリケーションを作成し、表示名 Tutorial を設定します。このアプリケーション名 tutorial-application は固有の識別子であり、アプリケーションの作成後に変更することはできません。表示名は、更新可能なわかりやすい名前です。Tutorial詳細については、既存のアプリケーションを更新するをご覧ください。

   gcloud apphub applications create tutorial-application \
       --display-name='Tutorial' \
       --scope-type=REGIONAL \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   gcloud apphub applications list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   次のような出力が表示されます。

   ID                    DISPLAY_NAME  CREATE_TIME
   tutorial-application  Tutorial      2023-10-31T18:33:48
   

4. criticality-type、environment-type、owner の各属性でアプリケーションを更新します。

   gcloud apphub applications update tutorial-application \
     --criticality-type='HIGH' \
     --environment-type='PRODUCTION' \
     --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=us-west1
   

   以下を置き換えます。

   • DISPLAY-NAME-DEVELOPER、DISPLAY-NAME-OPERATOR、DISPLAY-NAME-BUSINESS: それぞれ、デベロッパー、オペレーター、ビジネス オーナーの表示名。
   • EMAIL-NAME-DEVELOPER、EMAIL-NAME-OPERATOR、EMAIL-NAME-BUSINESS: それぞれ、デベロッパー、オペレーター、ビジネス オーナーのメールアドレス。これらの値は、username@yourdomain の形式（例: 222larabrown@gmail.com）にする必要があります。

   注:

   • criticality-type: ビジネス運営におけるアプリケーション、サービス、ワークロードの重要度を示します。
   • environment-type: ソフトウェア ライフサイクルのステージを示します。

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

   gcloud apphub applications describe tutorial-application \
     --project=HOST_PROJECT_ID \
     --location=us-west1
   

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

   attributes:
   businessOwners:
   – displayName: [DISPLAY-NAME-BUSINESS]
     email: [EMAIL-BUSINESS]
   criticality:
     type: HIGH
   developerOwners:
   – displayName: [DISPLAY-NAME-DEVELOPER]
     email: [EMAIL-DEVELOPER]
   environment:
     type: PRODUCTION
   operatorOwners:
   – displayName: [DISPLAY-NAME-OPERATOR]
     email: [EMAIL-OPERATOR]
   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: Tutorial
   name: projects/HOST_PROJECT_ID/locations/us-west1/applications/tutorial-application
   scope:
     type: REGIONAL
   state: ACTIVE
   uid: 9d991a9d-5d8a-4c0d-b5fd-85e39fb58c73
   updateTime: '2023-10-31T18:33:48.343303819Z'
   

Console

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

   [アプリケーション] に移動

2. アプリケーションの名前、「Tutorial」をクリックします。 [サービスとワークロード] タブに、App Hub サービス プロジェクトに存在する登録済みのサービスとワークロードのリストが表示されます。

3. サービスの登録:

   1. [サービスとワークロード] タブで、[サービス / ワークロードを登録] をクリックします。
   2. [サービスまたはワークロードの登録] ページの [リソースの選択] ペインで、[参照] をクリックして、サービスまたはワークロードを [リソース] として選択します。
   3. [リソースの選択] ペインで、サービスの名前「l7-xlb-backend-service」を選択し、[選択] をクリックします。
   4. [リソースの選択] ペインで、リソースの名前 tutorial-service-backend を入力します。
   5. 表示名 Backend service を入力し、[続行] をクリックします。
   6. [属性を追加] ペインの [重要度] リストで、アプリケーションの重要性を示すために [高] を選択します。
   7. [環境] フィールドで、ソフトウェア ライフサイクルのステージを示すために [本番環境] を選択します。
   8. [続行] をクリックします。
   9. [オーナーを追加] ペインで、デベロッパー オーナー、オペレーター オーナー、ビジネス オーナーに必要であるため、次の詳細を追加します。表示名を追加する場合は、所有者のメールアドレスを入力する必要があります。
      1. 所有者の表示名を入力します。
      2. オーナーのメールアドレスを入力します。この値は、username@yourdomain の形式（例: 222larabrown@gmail.com）にする必要があります。
   10. デベロッパー、オペレーター、ビジネス オーナーごとにこの手順を繰り返します。
   11. [Register] をクリックします。

   [サービスとワークロード] タブの [登録されているサービスとワークロード] セクションで、追加された新しいサービスを確認できます。

4. 上記の手順を繰り返して、他のサービスを tutorial-service-forwarding-rule と tutorial-service-url-map として登録します。

5. 次の例外を除き、前述のサービスの登録手順を繰り返して、ワークロードを登録します。

   1. [サービスまたはワークロードの登録] ペインの [サービスまたはワークロードの選択] セクションで、ワークロードの [名前]「l7-xlb-backend-example」を選択して [続行] をクリックします。
   2. [リソースの選択] ペインで、リソースの名前 tutorial-workload-mig を入力します。
   3. 表示名 Workload instance group を入力し、[続行] をクリックします。[サービスとワークロード] タブの [登録されているサービスとワークロード] セクションで、追加された新しいワークロードを確認できます。

gcloud

1. 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 ホスト プロジェクトで App Hub 編集者のロールを持つユーザーに置き換えます。この値の形式は username@yourdomain です（例: 222larabrown@gmail.com）。

2. App Hub ホスト プロジェクトで検出されたすべてのサービスを一覧表示します。このコマンドによって、アプリケーションに登録可能なサービスが返されます。

   gcloud apphub discovered-services list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   次のような出力が表示されます。

   ID                             SERVICE_REFERENCE                                                                                                              SERVICE_PROPERTIES
   BACKEND_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   FORWARDING_RULE_SERVICE_ID" {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   URL_MAP_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   

   次のステップで使用するサービス ID（BACKEND_SERVICE_SP2_ID など）を出力からコピーします。

3. 前の手順で取得したサービスをアプリケーションに登録します。前の手順の出力フィールドからサービス ID をコピーします。

   gcloud apphub applications services create tutorial-service-backend \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_ID' \
       --display-name='Backend service' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create tutorial-service-forwarding-rule \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
       --display-name='Forwarding rule' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create tutorial-service-url-map \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/URL_MAP_SERVICE_ID' \
       --display-name='URL map' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   以下を置き換えます。

   • BACKEND_SERVICE_ID: 登録するバックエンド サービスのサービス ID。
   • FORWARDING_RULE_SERVICE_ID: 登録する転送ルールのサービス ID。
   • URL_MAP_SERVICE_ID: 登録する URL マップのサービス ID。

4. アプリケーションに登録されているすべてのサービスを一覧表示します。

   gcloud apphub applications services list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   次のような出力が表示されます。

   ID                               DISPLAY_NAME      SERVICE_REFERENCE                                                                                                              CREATE_TIME
   tutorial-service-backend         Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  2024-02-13T00:31:45
   tutorial-service-forwarding-rule Forwarding rule   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  2024-02-13T00:31:45
   tutorial-service-url-map         URL map           {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             2024-02-13T00:31:45
   

   登録されているが切断されたサービスは、SERVICE_REFERENCE フィールドの空の値で表されます。登録ステータスの詳細については、App Hub のプロパティと属性をご覧ください。

5. App Hub ホスト プロジェクトで検出されたすべてのワークロードを一覧表示します。このコマンドによって、アプリケーションに登録可能なワークロードが返されます。

   gcloud apphub discovered-workloads list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   次のような出力が表示されます。

   ID                            WORKLOAD_REFERENCE                                                                                                            WORKLOAD_PROPERTIES
   INSTANCE_GROUP_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
   

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

6. 前の手順のワークロードを tutorial-workload-mig としてアプリケーションに登録します。前の手順の出力フィールドからワークロード ID をコピーします。

   gcloud apphub applications workloads create tutorial-workload-mig \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/WORKLOAD_ID' \
       --display-name='Workload instance group' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   WORKLOAD_ID は、登録するワークロードの ID に置き換えます。

7. アプリケーションに登録されているすべてのワークロードを一覧表示します。

   gcloud apphub applications workloads list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   次のような出力が表示されます。

   ID                        DISPLAY_NAME              WORKLOAD_REFERENCE                                                                                                            CREATE_TIME
   tutorial-workload-mig     Workload instance group   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  2024-02-13T00:31:45
   

   登録済みだが切断されたワークロードは、WORKLOAD_REFERENCE フィールドの空の値で表されます。登録ステータスの詳細については、App Hub のプロパティと属性をご覧ください。