使用单个项目创建 App Hub 应用

控制台

如需获得完成本教程所需的权限，请让您的管理员为您授予项目的以下所需 IAM 角色：

1. 在 Google Cloud 控制台中，转到 IAM 页面。

   转到 IAM

2. 点击 person_add授予访问权限。 此时会打开授予访问权限窗格。

3. 在新主账号字段中，输入将负责管理 App Hub 的个人（托管项目中的 App Hub Admin 角色）的电子邮件地址。

4. 点击选择角色，然后在过滤条件字段中输入 App Hub。

5. 选择 App Hub Admin 角色。

6. 点击添加其他角色，然后从选择角色列表中选择监控查看者。

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 Admin 角色的用户。此值的格式为 username@yourdomain，例如 222larabrown@gmail.com。

2. 向管理 API Hub 的用户授予服务项目中的“API Hub 管理员”角色。他们必须拥有应用中心管理员角色，才能将服务项目添加到宿主项目。每个服务项目都需要至少有一位用户拥有此角色。在此示例中，宿主项目充当服务项目。

   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 Viewer 角色。他们必须拥有宿主项目的 Monitoring Viewer 角色，才能查看指标。

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

控制台

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

控制台

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'
   

控制台

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. 点击注册。

   在服务和工作负载标签页的已注册的服务和工作负载部分，您可以看到添加的新服务。

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：您要注册的网址映射的服务 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 的属性和特性。