配置 hub

本页面介绍了如何创建不同项目中的 VPC spoke 可连接到的 hub。

须知事项

开始之前，请查看以下部分。

创建或选择项目

为了更轻松地配置 Network Connectivity Center，请先确定有效项目。

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. 确保您的 Google Cloud 项目已启用结算功能。

4. 安装 Google Cloud CLI。

5. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. 确保您的 Google Cloud 项目已启用结算功能。

8. 安装 Google Cloud CLI。

9. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

4. 如果您使用的是 Google Cloud CLI，请使用 gcloud config set 命令设置项目 ID。

   gcloud config set project PROJECT_ID

   将 PROJECT_ID 替换为您的唯一项目 ID。

   此页面上的 gcloud CLI 说明假定您已设置项目 ID。

5. 如需确认您正确设置了项目 ID，请使用 gcloud config list 命令。

   gcloud config list --format='text(core.project)'

启用 Network Connectivity API

您必须先启用 Network Connectivity API，然后才能使用 Network Connectivity Center 执行任何任务。

控制台

如要启用 Network Connectivity API，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 Network Connectivity Center 页面。

   转到 Network Connectivity Center

2. 点击启用。

或者，您可以使用 Google Cloud 控制台 API 库来启用 API，如启用 API 中所述。

获取访问权限

如要使用 Network Connectivity Center，您需要具备角色和权限中所述的权限。

确定资源

使用 gcloud CLI 或 API 引用资源时，请使用下表中所述的惯例。

会展	支持	备注	示例
完整 URI	所有资源	您必须使用这些方法之一来引用路由器设备实例。	"https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
相对资源名称	所有资源		"projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
名称	区域和全球资源	此方法可用于 Hub、Spoke 和 VPN 隧道以及 VLAN 连接。	"HUB_NAME"

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或 IAM 角色。

权限

• networkconnectivity.hubs.create，用于创建 hub
• networkconnectivity.hubs.delete，用于删除 hub
• networkconnectivity.hubs.listSpokes，用于列出 spoke
• 此外，如果您使用的是 Google Cloud 控制台，则还需要以下权限：
  • networkconnectivity.hubs.get
  • networkconnectivity.hubs.list
  • networkconnectivity.spokes.list
  • compute.projects.get

角色

• Hub & Spoke Admin (roles/networkconnectivity.hubAdmin)
• 如果您使用的是 Google Cloud 控制台，则需要 Compute Network Viewer (roles/compute.networkViewer) 角色

创建 hub

如需创建 hub，请按照以下步骤操作。

控制台

1. 在 Google Cloud 控制台中，转到 Network Connectivity Center 页面。

   转到 Network Connectivity Center

2. 在项目菜单中，选择一个项目。

3. 点击创建 hub。

4. 完成表单的基本配置部分：

   1. 输入 Hub 名称。
   2. （可选）输入说明。
   3. 可选：要添加标签，请点击添加项，然后输入键和值。
   4. 验证表单是否显示正确的项目 ID。如果项目 ID 不正确，请使用页面顶部的菜单选择其他项目。

5. 执行下列其中一项操作：

   • 如果您要创建连接到此 hub 的 spoke，请点击下一步，然后完成表单的 soke 创建部分。如需查看相关说明，请参阅创建 VPC spoke。
   • 如果您现在不想创建 spoke，请点击创建以完成创建新 hub 的操作。

gcloud

如需创建 Hub，请使用 gcloud network-connectivity hubs create 命令。

  gcloud network-connectivity hubs create HUB_NAME \
    --description="DESCRIPTION" \
    --labels="KEY"="VALUE"

替换以下值：

• HUB_NAME：新 Hub 的名称
• DESCRIPTION：用于描述该 Hub 的可选文本
• KEY：可选标签文本的键值对中的键
• VALUE：可选标签文本的键值对中的值

API

如要创建 Hub，请使用 networkconnectivity.hubs.create 方法。

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"HUB_NAME",
    "description":"DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

替换以下值：

• PROJECT_ID：新 Hub 所属项目的项目ID
• HUB_NAME：新 Hub 的名称
• DESCRIPTION：用于描述该 Hub 的可选文本
• KEY：可选标签文本的键值对中的键
• VALUE：可选标签文本的键值对中的值

如需详细了解其他 hub 命令（例如 list、describe 和 update），请参阅处理 hub 和 spoke。

删除 Hub

如需删除 hub，请按照以下步骤操作。

您必须先删除或拒绝连接到 hub 的所有 spoke，然后才能删除该 hub。如果 spoke 位于其他项目中，您可能无权删除它。在这种情况下，您必须拒绝 spoke。

如需了解删除 spoke 的步骤，请参阅删除 spoke。

控制台

1. 在 Google Cloud 控制台中，转到 Network Connectivity Center 页面。

   转到 Network Connectivity Center

2. 在项目菜单中，选择一个项目。

3. 点击 Hub 标签页。

4. 在 hub 列表中，选择您要删除的 hub。

5. 点击 Spoke 标签页。系统会列出连接到此 hub 的所有 spoke 及其状态。

6. 从活跃 spoke 列表中，删除活跃 spoke。如果您无权删除 spoke，请拒绝 spoke。

7. 点击删除 Hub。

8. 在确认对话框中，执行下列操作之一：

   • 如果您不想删除此 Hub，请点击取消。
   • 点击删除以删除 Hub。

gcloud

1. 如需列出连接到您要删除的 hub 的所有活跃 spoke，请使用 gcloud network-connectivity hubs list-spokes 命令。

   gcloud network-connectivity hubs list-spokes HUB_NAME \
      --filter="state:ACTIVE"
   

   将 HUB_NAME 替换为您要删除的 hub 的名称。

2. 删除活跃 spoke。如果您无权删除 spoke，请拒绝 spoke。

3. 如需删除 Hub，请使用 gcloud network-connectivity hubs delete 命令。

   gcloud network-connectivity hubs delete HUB_NAME
   

   将 HUB_NAME 替换为该 Hub 的名称。

API

1. 如需列出连接到您要删除的 hub 的所有活跃 spoke，请使用 networkconnectivity.hubs.listSpokes 方法。

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME:listSpokes
   

   替换以下值：

   • PROJECT_ID：要为其列出 spoke 的 hub 所属项目的 ID
   • HUB_NAME：要为其列出 spoke 的 hub 的名称

2. 删除活跃 spoke。如果您无权删除 spoke，请拒绝 spoke。

3. 如需删除 Hub，请使用 networkconnectivity.hubs.delete 方法。

    DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
   

   替换以下值：

   • PROJECT_ID：要删除的 Hub 所属项目的项目的 ID
   • HUB_NAME：要删除的 Hub 的名称

后续步骤

• 如要创建 Hub 和 Spoke，请参阅使用 Hub 和 Spoke。
• 如需查看其解决方案已与 Network Connectivity Center 集成的合作伙伴列表，请参阅 Network Connectivity Center 合作伙伴。
• 如需查找常见问题的解决方案，请参阅问题排查。
• 如需获取有关 API 和 gcloud 命令的详细信息，请参阅 API 和参考。