订购硬件

本页面介绍了如何订购 Google Distributed Cloud Connected 硬件。 Distributed Cloud Connected 可在以下国家/地区使用：

• 澳大利亚
• 奥地利
• 比利时
• 巴西
• 加拿大
• 智利
• 丹麦
• 芬兰
• 法国
• 德国
• 香港
• 日本
• 印度
• 印度尼西亚
• 意大利
• 马来西亚
• 墨西哥
• 荷兰
• 挪威
• 波兰
• 沙特阿拉伯
• 新加坡
• 韩国
• 西班牙
• 瑞典
• 瑞士
• 英国
• 美国
• 乌拉圭

在订购硬件之前，您必须满足分布式云连接安装要求。

Distributed Cloud Connected 采购模式

您可以根据自己的业务需求，通过以下方式之一订购 Distributed Cloud connected 硬件：

• Google 自有硬件。您可以直接向 Google 订购 Distributed Cloud connected 硬件。在这种场景中，Google 会采购、维护、维修和停用 Distributed Cloud Connected 硬件。合同结束后，Google 会收回 Distributed Cloud 硬件并销毁存储在其中的所有数据。

• 由客户自行采购的硬件。在与 Google 协商确定符合您业务需求的部署配置后，您可以从经过 Google 认证的系统集成商 (SI) 处订购 Distributed Cloud Connected。 在此场景中，您拥有 Distributed Cloud Connected 硬件。SI 会与您和 Google 合作部署、维修和停用硬件。当合同结束时，SI 会从 Distributed Cloud Connected 硬件中清除所有 Google 软件和您的数据。然后，您可以随意重新使用或处置硬件。这种采购类型仅适用于已连接 Distributed Cloud 的服务器。

前提条件

在下单之前，您必须准备好以下信息：

• 订单联系人。负责管理组织中 Distributed Cloud connected 硬件部署的人员。

• 网站联系人。负责所选部署网站的人员。Google 会与此人联系，安排并完成 Distributed Cloud Connected 硬件的交付。此人还负责与 Google 或 Google 认证的 SI 协调硬件维修和停用事宜。

• 可用区联系人。负责将 Distributed Cloud connected 硬件集成到部署地点的现有网络和电源基础设施中的人员。

• 订单标识符。相应 Distributed Cloud connected 硬件订单的有意义的标识符。

• 网站标识符。相应 Distributed Cloud connected 硬件订单的部署站点的有意义的标识符。

• 可用区标识符。目标 Distributed Cloud connected 可用区的有意义的标识符。如果您仅为每个网站部署一个区域，请使用网站标识符作为区域标识符。

使用 Google Cloud 控制台订购 Distributed Cloud connected 硬件

1. 在 Google Cloud 控制台中，前往订单页面。

   前往“订单”页面

2. 选择目标 Google Cloud 项目。

3. 点击创建订单。

4. 填写申请表单并提交。

Google Cloud 销售代表会审核您提交的申请，并与您联系以完成订单。客服人员会执行以下操作：

• 审核您的业务需求，帮助您最终确定硬件配置。
• 收集有关本地网络、 Google Cloud 项目、安装地点以及安装要求中列出的其他要求的更多信息。
• 使用此信息在交付之前配置 Distributed Cloud 硬件。

使用 GDC Hardware Management API 订购 Distributed Cloud connected 硬件

预览版

此功能 受服务专用条款的约束。 非正式版功能“按原样”提供，且可能仅提供有限支持。 如需了解详情，请参阅发布阶段说明。

借助 GDC Hardware Management API，您可以以程序化方式订购 Distributed Cloud 硬件。订单表示您有意部署 Distributed Cloud connected。订单必须包含以下信息，这些信息将在整个 Distributed Cloud 连接部署生命周期内使用：

• 订单管理和配送方面的联系人
• 配送地点地址以及与配送相关的任何信息
• 硬件配置
• 网络配置

您必须与 Google 销售代表合作，填写客户信息问卷 (CIQ)，并最终确定 Distributed Cloud connected 部署的范围和配置。

启用 GDC Hardware Management API

您必须先在目标Google Cloud 项目中启用 GDC Hardware Management API，然后才能使用该 API。为此，请完成本部分中的步骤。

控制台

1. 在 Google Cloud 控制台中，前往 GDC Hardware Management API 页面。

   启用 API

2. 点击启用。

gcloud

使用以下命令：

gcloud services enable gdchardwaremanagement.googleapis.com

订单的结构

如需使用 GDC Hardware Management API 下单，您必须创建 Order 资源，以及 Order 资源引用的随附 Site、Zone 和 Hardware 资源。然后，您将 Order 资源提交给 Google。这些资源支持标准 CRUD 操作。 每项资源的名称都是一个路径，其中包含目标 Google Cloud 项目 ID 和 Google Cloud 区域。

这些资源具有以下功能。如需详细了解如何使用 GDC Hardware Management API，请参阅 Google Distributed Cloud CLI 和 API 参考文档。

• Order。此资源请求创建一个或多个 Distributed Cloud 区域。创建此资源时，系统会为其分配一个可在 create_order_response.name 字段中访问的名称。Order 资源名称采用以下格式：

  `projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID

  其中：

  • PROJECT_ID：目标 Google Cloud 项目的 ID。
  • REGION：您要在其中部署 Distributed Cloud 区域的 Google Cloud 区域。
  • ORDER_ID：用于标识相应订单的唯一 ID。如果省略，系统会自动生成一个值。建议您提供一个由小写字母、数字和短划线组成的唯一订单 ID 值。否则，失败的订单创建调用可能会生成重复订单。

• Site。此资源表示您要部署 Distributed Cloud 硬件的物理位置。此资源包含负责协调初始交付和未来维护的负责方的联系信息。 此联系人可能与您在订单中提供的联系人不同。

• Hardware。此资源会实例化 Distributed Cloud Connected SKU，并表示 Distributed Cloud 服务器或机架。每个 Hardware 资源都会引用关联的 Order、Site 和 Zone 资源。如需查看可用的 SKU，请使用 ListSkus API 调用。

• Zone。此资源用于指定 Distributed Cloud 连接的机器和关联集群的网络配置。Distributed Cloud 可用区涵盖一个或多个 Distributed Cloud connected 机架，或部署在您位置的所有 Distributed Cloud connected 服务器机器。

向 Google 提交 Order 资源后，如果其状态从 DRAFT 更改为 SUBMITTED 或 INFO_COMPLETE，则大多数字段值都会变为只读。

订单的生命周期

Order 资源可以处于 State 中列出的状态之一。相关方可以在订单中添加评论，这些评论会作为嵌套在相应 Order 资源下的 Comment 资源进行存储。您可以通过 GDC 硬件管理 API 和 Google Cloud 控制台阅读和提交评论。

GDC 硬件管理 API 支持以下订单生命周期操作：

• 创建并提交订单。您可以创建订单并立即提交，也可以逐步创建订单并将其保存为DRAFT状态，直到准备好提交为止。本指南的其余部分将介绍此流程。

• 查看订单状态。如果提交的订单的类型为 INFO_COMPLETE，并且您已与 Google 签订合同，则订单将按以下顺序进入相应状态：ACCEPTED, BUILDING, SHIPPING、INSTALLING 和 COMPLETED.。关联的 Zone 和 Hardware 资源的状态会与 Order 资源同步更新。

• 解决订单问题。如果我们还需要您提供更多信息，或者您尚未与 Google 签订合同，订单会进入 ADDITIONAL_INFO_NEEDED 状态，等待通过评论解决问题。 请在注释中查找更多说明，如果后续步骤在任何时候不明确，请与 Google 联系。

• 删除未提交的订单。您可以通过调用 DELETE 来删除未提交的订单。

• 修改已提交的订单。您可以使用相应的 PATCH 调用修改已提交的订单、网站和区域。提交后可修改的字段如下：

  • 所有资源：display_name、labels
  • 订单：organization_contact
  • 网站：access_times，organization_contact 的大多数字段，但不包括网站地址
  • 硬件：如果满足以下至少一个条件，则为 requested_installation_date：
    • 新日期距离现在超过 45 天
    • 新 requested_installation_date 晚于当前 requested_installation_date 且 estimated_installation_date 为空
    • 新 requested_installation_date 晚于当前 requested_installation_date，且 estimated_installation_date 至少在 7 天后

  订单提交后，您无法修改任何其他信息，但可以通过添加注释来请求 Google 修改。

• 取消已提交的订单。您可以向已提交的订单添加注释，请求取消该订单。

选择目标 Google Cloud 项目

Google Cloud 项目是一种结构，用于封装一组 Google Cloud 资源，使您可以使用这些资源，并为这些资源建立访问权限控制和结算规则。

我们建议您为每个管理网域（例如国家/地区或公司部门）和高级别使用情形（例如边缘与核心）创建一个单独的 Google Cloud 项目，并通过该 Google Cloud 项目管理网域的 Distributed Cloud 连接部署。

借助 Google Cloud 项目，您可以执行以下管理任务：

• 订购 Distributed Cloud connected 硬件。
• 配置 Distributed Cloud 连接的集群，并将其注册到舰队中。
• 管理软件发布。
• 管理 Cloud Storage 中的 Distributed Cloud 连接数据。
• 在 Secret Manager 中管理 Distributed Cloud connected 凭据。
• 在 Cloud Monitoring 中管理 Distributed Cloud 连接的日志和指标。

确切的 Google Cloud 项目拓扑取决于您的业务需求。我们建议您避免跨项目依赖关系，并始终在每个 Google Cloud 项目中创建和使用资源。

在特定 Google Cloud 项目内订购的硬件始终在该 Google Cloud 项目中进行管理。

选择目标 Google Cloud 地区

为 Distributed Cloud Connected 部署选择 Google Cloud 区域的具体方式取决于您的业务需求以及目标地理位置的法律影响。

如果您要将分布式云互联部署集成到现有的多区域Google Cloud 覆盖区，建议您将每个分布式云互联可用区映射到托管该可用区依赖项的 Google Cloud 区域。

如果您未将 Distributed Cloud 连接部署与现有 Google Cloud覆盖范围集成，建议您多样化 Google Cloud 区域选择，以提高可靠性。例如：

• 将每个 Distributed Cloud Connected 可用区映射到其最近的支持 Google Cloud 的区域。这样可将管理平面故障的影响范围限制在单个地理区域内。

• 在多个 Google Cloud 区域中对分布式云进行条带化。这样可以限制受管理平面故障影响的 Distributed Cloud 连接可用区数量；不过，受影响的可用区分布在更广阔的地理区域。

  Distributed Cloud Connected 支持以下 Google Cloud 区域：

• 亚洲：asia-east1、asia-east2、asia-northeast1、asia-northeast3、asia-south1、asia-south2、asia-southeast1、asia-southeast2

• 欧洲：europe-central2、europe-north1、europe-west1、europe-west2、europe-west3、europe-west4、europe-west6、europe-west8、europe-west9

• 中东：me-central1、me-west1

• 大洋洲：australia-southeast1

• 北美：northamerica-northeast1、northamerica-northeast2、us-central1、us-central2、us-east1、us-east4、us-east5、us-east7、us-south1、us-west1、us-west2、us-west3、us-west4、us-west8

• 南美洲：southamerica-east1、southamerica-west1

设置环境

在开始之前，请完成以下前提条件：

1. 设置 Python 开发环境。

2. 使用以下命令安装 GDC 硬件管理 API 客户端库：

   python3 -m pip install google-cloud-gdchardwaremanagement
   

3. 在目标 Google Cloud 项目上启用 GDC Hardware Management API。

使用 GDC Hardware Management API 创建并提交 Distributed Cloud connected 硬件订单

本部分中的步骤是一些示例，用于说明如何使用 GDC 硬件管理 API 创建 Order 资源并将其提交给 Google。如需完成此部分中的步骤，您必须在 Google Cloud 项目中拥有 GDC Hardware Management Admin (roles/gdchardwaremanagement.admin) 角色。如需详细了解可用的类型和方法，请参阅 Python 客户端库参考。

1. 创建 Order 资源。例如：

   import datetime
   from google.cloud import gdchardwaremanagement_v1alpha
   from google.protobuf.timestamp_pb2 import Timestamp
   from google.type import postal_address_pb2
   
   client = gdchardwaremanagement_v1alpha.GDCHardwareManagementClient()
   
   contact = gdchardwaremanagement_v1alpha.Contact(
       given_name="John",
       family_name="Customer",
       email="[e-mail]",
       phone="[phone]",
   )
   
   organization_contact = gdchardwaremanagement_v1alpha.OrganizationContact(
       address=postal_address_pb2.PostalAddress(
           organization="Example Organization",
           address_lines=["1800 Amphibious Blvd."],
           locality="Mountain View",
           administrative_area="CA",
           postal_code="94045",
           region_code="US",
       ),
       contacts=[contact],
   )
   
   order = gdchardwaremanagement_v1alpha.Order(
       organization_contact=organization_contact,
       customer_motivation="I like Google Distributed Cloud!",
       fulfillment_time=Timestamp(
           seconds=int(datetime.datetime(2024, 11, 22, 9, 0).timestamp()),
       ),
       region_code="US",
   )
   
   create_order_response = client.create_order(
       request=gdchardwaremanagement_v1alpha.CreateOrderRequest(
           parent="projects/myProject/locations/us-east1",
           order_id="myOrderID",
           order=order,
       ),
   ).result()

   您的订单现在处于 DRAFT 状态，并且已分配一个存储在 create_order_response.name 字段中的资源名称。在修改或跟踪相应订单的状态时，请使用此资源名称。

2. 创建 Site 资源。例如：

   site = gdchardwaremanagement_v1alpha.Site(
       organization_contact=organization_contact,
       google_maps_pin_uri="https://maps.app.goo.gl/z7bE8z8fffg6Sri46",
   )
   
   create_site_response = client.create_site(
       request=gdchardwaremanagement_v1alpha.CreateSiteRequest(
           parent="projects/myProject/locations/us-east1",
           site_id="mySite",
           site=site,
       ),
   ).result()

3. 创建 Zone 资源。例如：

   zone = gdchardwaremanagement_v1alpha.Zone(
       contacts=[contact],
       network_config=gdchardwaremanagement_v1alpha.ZoneNetworkConfig(
           management_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
               address_range="192.0.2.0/24",
               default_gateway_ip_address="192.0.2.1",
           ),
           machine_mgmt_ipv4_range="192.0.2.8/29",
           kubernetes_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
               address_range="203.0.113.0/24",
               default_gateway_ip_address="203.0.113.1",
           ),
           kubernetes_node_ipv4_range="203.0.113.8/29",
           kubernetes_control_plane_ipv4_range="203.0.113.16/29",
       ),
   )
   
   create_zone_response = client.create_zone(
       request=gdchardwaremanagement_v1alpha.CreateZoneRequest(
           parent="projects/myProject/locations/us-east1",
           zone_id="myZone",
           zone=zone,
       ),
   ).result()

4. 创建 Hardware 资源。您必须为 Distributed Cloud connected 部署中的每台机器指定唯一的 hardware_id 值。例如：

   from google.type import date_pb2
   
   hardware = gdchardwaremanagement_v1alpha.Hardware(
       order=create_order_response.name,
       site=create_site_response.name,
       zone=create_zone_response.name,
       config=gdchardwaremanagement_v1alpha.HardwareConfig(
           sku="projects/myProject/locations/us-east1/skus/gdce-server-l",
           power_supply=gdchardwaremanagement_v1alpha.types.PowerSupply.POWER_SUPPLY_AC,
       ),
       physical_info=gdchardwaremanagement_v1alpha.HardwarePhysicalInfo(
           power_receptacle=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.PowerReceptacleType.NEMA_5_15,
           network_uplink=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.NetworkUplinkType.RJ_45,
           voltage=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Voltage.VOLTAGE_110,
           amperes=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Amperes.AMPERES_15,
       ),
       installation_info=gdchardwaremanagement_v1alpha.HardwareInstallationInfo(
           rack_location="Floor 2, Room 201, Row 7, Rack 3",
           power_distance_meters=2,
           switch_distance_meters=2,
           rack_unit_dimensions=gdchardwaremanagement_v1alpha.Dimensions(
               width_inches=19,
               height_inches=1.75,
               depth_inches=30,
           ),
           rack_space=gdchardwaremanagement_v1alpha.RackSpace(
               start_rack_unit=12,
               end_rack_unit=12,
           ),
           rack_type=gdchardwaremanagement_v1alpha.types.HardwareInstallationInfo.RackType.FOUR_POST,
       ),
       requested_installation_date=date_pb2.Date(year=2024, month=11, day=22),
   )
   
   create_hardware_response = client.create_hardware(
       request=gdchardwaremanagement_v1alpha.CreateHardwareRequest(
           parent="projects/myProject/locations/us-east1",
           hardware_id="machineHardwareID",
           hardware=hardware,
       ),
   ).result()

5. 向 Google 提交 Order 资源：

   submit_order_response = client.submit_order(
       request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
           name=create_order_response.name,
           type_=gdchardwaremanagement_v1alpha.types.SubmitOrderRequest.Type.INFO_COMPLETE,
       ),
   ).result()

   INFO_COMPLETE 的提交类型表示您已在 Zone 和 Hardware 资源中提供了所有必需信息。如果缺少任何字段值，提交操作会失败，并显示描述问题的错误消息。如果您想在未完全填充订单的情况下与 Google 开始对话，请提交状态为 INFO_PENDING 的订单以跳过这些验证。

测试

如果您想提交测试订单，请与 Google 联系以获取沙盒环境的访问权限。 在您的项目或组织获得访问权限后，您可以使用以 fake- 前缀标识的测试 SKU。测试订单会经历前面所述的各个阶段，但不会产生费用或触发硬件发货。

问题排查

本部分介绍了最常遇到的错误、错误原因以及可用的补救措施。

错误：400 FAILED_PRECONDITION

如果您在响应 API 调用时收到 400 错误代码和 FAILED_PRECONDITION 状态，请检查您的请求是否对您尝试完成的操作有效。无效请求的示例包括：提交缺少字段或值的 Order 资源，或尝试删除与之前提交的 Order 资源相关联的 Hardware 资源。

错误：400 INVALID_ARGUMENT

如果您在 API 调用响应中收到 400 错误代码和 INVALID_ARGUMENT 状态，请检查是否存在不正确的字段名称和与预期类型不匹配的值，或者是否存在缺失的值。如果您在 PATCH 请求中使用 updateMask，并且 updateMask 中指定的一个或多个字段无效，您也可能会收到此错误。

如需解决此问题，请参阅 GDC 硬件管理 API，验证所有字段名称和值（包括格式）是否正确。如果使用 JSON 载荷，请确认载荷中包含所有必需的信息。

错误：401 UNAUTHENTICATED

如果您在 API 调用的响应中收到 401 错误代码和 UNAUTHENTICATED 状态，请检查您的身份验证配置。如需了解详情，请参阅设置应用默认凭证。

错误：403 PERMISSION_DENIED

如果您在 API 调用的响应中收到 403 错误代码和 PERMISSION_DENIED 状态，请检查用于进行 API 调用的服务账号是否具有足够的权限来访问目标对象和资源。另请验证凭据是否正确且未过期。

错误：404 NOT_FOUND

如果您在响应 API 调用时收到 404 错误代码和 NOT_FOUND 状态，请检查 API 调用中指定的资源名称和路径是否有效。请参阅 GDC 硬件管理 API，验证您的请求网址结构是否正确，以及网址中包含的所有字段是否有效。

后续步骤

• 在 Google Distributed Cloud connected 上部署工作负载