Pedir hardware

Nesta página, descrevemos como pedir hardware conectado do Google Distributed Cloud. O Distributed Cloud Connected está disponível nos seguintes países:

• Austrália
• Áustria
• Bélgica
• Brasil
• Canadá
• Chile
• Dinamarca
• Finlândia
• França
• Alemanha
• Hong Kong
• Japão
• Índia
• Indonésia
• Itália
• Malásia
• México
• Países Baixos
• Noruega
• Polônia
• Arábia Saudita
• Singapura
• Coreia do Sul
• Espanha
• Suécia
• Suíça
• Reino Unido
• Estados Unidos
• Uruguai

Antes de pedir o hardware, você precisa atender aos requisitos de instalação conectada do Distributed Cloud.

Modelos de aquisição do Distributed Cloud conectado

Você pode pedir o hardware conectado do Distributed Cloud de uma das seguintes maneiras, com base nos requisitos da sua empresa:

• Hardware de propriedade do Google. É possível pedir o hardware conectado do Distributed Cloud diretamente do Google. Nesse cenário, o Google fornece, mantém, conserta e desativa o hardware conectado do Distributed Cloud. Quando o contrato termina, o Google coleta o hardware do Distributed Cloud e destrói todos os dados armazenados nele.

• Hardware fornecido pelo cliente. É possível pedir o Distributed Cloud Connected de um integrador de sistemas (SI) certificado pelo Google depois de consultar o Google sobre uma configuração de implantação que atenda aos requisitos da sua empresa. Neste cenário, você é proprietário do hardware conectado do Distributed Cloud. O SI trabalha com você e o Google para implantar, consertar e desativar o hardware. Quando o contrato termina, o SI apaga todos os softwares do Google e seus dados do hardware conectado do Distributed Cloud. Depois disso, você pode reutilizar ou descartar o hardware. Esse tipo de compra está disponível apenas para servidores conectados do Distributed Cloud.

Variantes de hardware do Distributed Cloud conectado

O hardware dos servidores conectados do Distributed Cloud está disponível nos seguintes formatos:

• Servidores conectados do Distributed Cloud G1 Um grupo de três máquinas Dell XR11 de rack 1U. Para mais informações, consulte Hardware dos servidores conectados do Distributed Cloud G1.

• Servidores conectados do Distributed Cloud G2. Um chassi Dell XR8000r com três trenós de máquina XR8610t. Para mais informações, consulte Hardware dos servidores conectados do Distributed Cloud G2.

Para conferir uma lista de SKUs de servidores do Distributed Cloud Connected, consulte Preços do Distributed Cloud Connected.

Pré-requisitos

Esta seção descreve os requisitos de configuração do Google Cloud e as informações que você precisa reunir antes de pedir hardware.

Configuração doGoogle Cloud

Antes de começar, verifique se você tem as permissões necessárias e se a API está ativada no seu projeto Google Cloud . É necessário concluir essas etapas ao fazer pedidos diretamente pelo console do Google Cloud ou por uma API integrada.

• Projeto doGoogle Cloud : você precisa ter um projeto do Google Cloud com um administrador autorizado a ativar a API Distributed Cloud Hardware Management. Para mais informações sobre como criar um projeto do Google Cloud, consulte Criar um projeto. O projeto usado para gerenciar os clusters precisa ser o mesmo usado ao fazer o pedido do hardware.

• API Distributed Cloud Hardware Management: é necessário ativar a API Distributed Cloud Hardware Management. No console do Google Cloud , acesse a página API GDC Hardware Management. Se necessário, clique em Ativar para ativar a API.

  Acesse a API GDC Hardware Management

• Papéis do IAM: para pedir hardware, você precisa ter o papel do IAM de Administrador de gerenciamento de hardware do GDC (gdchardwaremanagement.admin). Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

• Requisito contratual: antes que o Google possa processar um pedido de atendimento, você precisa ter um contrato válido e assinado em arquivo e um ID de faturamento. Para mais informações, consulte Encontrar um ID da conta do Cloud Billing.

Contatos

Para fazer um pedido, você precisa fornecer os seguintes contatos:

• Contato do pedido: uma pessoa responsável por gerenciar a implantação do hardware conectado do Distributed Cloud na sua organização. Informe um representante da empresa para entrarmos em contato e concluirmos os processos de vendas e contratação.

• Contato do site: uma pessoa responsável pelo site de implantação selecionado. O Google entra em contato com essa pessoa para agendar e concluir a entrega do hardware conectado do Distributed Cloud. Essa pessoa também coordena os reparos e a desativação de hardware com o Google ou com um SI certificado pelo Google.

• Contato da zona e da rede: uma pessoa responsável por integrar o hardware conectado da nuvem distribuída à infraestrutura de rede e energia existente no local de implantação. Essa pessoa também ajuda na solução de problemas conjunta, se necessário.

Informações do site

Antes de fazer um pedido, colete as seguintes informações:

• Identificador do pedido: um identificador significativo para este pedido de hardware conectado da Distributed Cloud. Um ID do pedido é gerado automaticamente com base no nome do pedido, mas você pode modificar o ID se necessário.

• Identificador do site: um identificador significativo para o site de implantação deste pedido de hardware conectado do Distributed Cloud.

• Identificador da zona: um identificador significativo para a zona conectada de destino da nuvem distribuída. Se você estiver implantando apenas uma zona por site, use o identificador do site como identificador da zona.

• País de implantação: o país onde seu hardware será implantado. O país afeta a moeda de faturamento e a disponibilidade do hardware. Para pedir hardware em vários locais, crie pedidos separados para cada país.

• Região: a localização geográfica em que os dados do pedido e do cliente são armazenados. Assim seus dados permanecem na região selecionada, ajudando você a atender aos requisitos de compliance.

• Informações da empresa: ao fazer o pedido, você precisa informar o nome da empresa, o endereço de e-mail, o número de telefone e o endereço de faturamento.

Informações de configuração de rede

Ao fazer o pedido, você precisa fazer seleções para a configuração de rede. Use as informações na tabela a seguir para entender a configuração de rede que você precisa fornecer durante a realização do pedido.

Tipo de rede	Nome da configuração de IP	Descrição
Rede de gerenciamento de máquinas	Endereços de gerenciamento de máquinas IPv4 na notação CIDR	Cada servidor tem um endereço IP para o tráfego de gerenciamento do Distributed Cloud. Esse bloco configura os endereços IP da sub-rede de gerenciamento de máquinas usados para essa tarefa.
	Sub-rede de gerenciamento de máquinas IPv4 na notação CIDR	A sub-rede alocada para o tráfego de gerenciamento do Distributed Cloud. O tráfego inclui atualizações de software de infraestrutura do Distributed Cloud, além de registros e métricas da infraestrutura. Essa sub-rede precisa ser grande o suficiente para conter o bloco de endereços IPv4 para gerenciamento de máquinas e o gateway padrão da sub-rede de gerenciamento de máquinas.
	Gateway padrão da sub-rede de gerenciamento de máquinas	O endereço IP do gateway na sub-rede de gerenciamento de máquinas
Tráfego de nós do Kubernetes	Endereços de nós do Kubernetes IPv4 na notação CIDR	Cada servidor tem um endereço IP para o tráfego relacionado ao Kubernetes. Este bloco configura os endereços IP da sub-rede do Kubernetes usados para o tráfego relacionado ao Kubernetes.
	Bloco de endereços IPv4 para VIPs do plano de controle do Kubernetes na notação CIDR	Cada cluster do Kubernetes criado na zona de borda tem um VIP do plano de controle atribuído a este bloco de endereço. Se você pretende criar apenas um cluster na zona de borda, use um bloco de endereços /32. Caso contrário, o bloco de endereços precisa ser maior.
	Sub-rede IPv4 do Kubernetes em notação CIDR	A sub-rede alocada para o tráfego do Kubernetes. O tráfego inclui downloads de contêineres, rede principal do Kubernetes, registros e métricas do Kubernetes e tráfego do plano de controle do Kubernetes. Quando vazia, essa sub-rede é definida por padrão como sub-rede de gerenciamento de máquinas IPv4. Também é possível especificar uma sub-rede separada nesse campo. Essa sub-rede precisa ser grande o suficiente para conter o bloco de endereços IPv4 para tráfego de nós do Kubernetes, o bloco de endereços IPv4 para VIPs do plano de controle do Kubernetes, o gateway padrão da sub-rede do Kubernetes e VIPs de balanceador de carga de rede primários planejados. Se não for especificado, esse valor será o mesmo que o da rede de gerenciamento.
	Gateway padrão da sub-rede do Kubernetes	O endereço IP do gateway na sub-rede do Kubernetes. Quando vazio, esse campo é definido por padrão como Gateway padrão da sub-rede de gerenciamento de máquinas.
	ID da VLAN primária do Kubernetes	Por padrão, o nó do Kubernetes, incluindo a rede principal do Kubernetes, está na mesma VLAN que a rede de gerenciamento de máquinas. Para fins de segmentação de rede, é possível separar essas redes.
Servidores de nomes DNS	Servidor de nomes DNS 1	Os IPs do servidor de nomes DNS. A infraestrutura do Distributed Cloud resolve consultas de DNS usando esses IPs. Quando o valor não for especificado, o DNS do Google será usado.
	Servidor de nomes DNS 2	Os IPs do servidor de nomes DNS. A infraestrutura do Distributed Cloud resolve consultas de DNS usando esses IPs. Quando o valor não for especificado, o DNS do Google será usado.

Pedir hardware conectado do Distributed Cloud usando o console Google Cloud

1. No console do Google Cloud , acesse a página Pedidos.

   Acessar "Pedidos"

2. Selecione o projeto de destino Google Cloud .

3. Clique em Criar um único pedido.

4. No formulário Detalhes do pedido, insira as informações que você coletou na seção Pré-requisitos deste documento. Clique em Continuar.

   Observação: depois de inserir as informações na página Detalhes do pedido, você pode salvar um rascunho do pedido clicando em Salvar como rascunho. Essa opção está disponível em todas as etapas do processo de pedido.

5. No formulário Selecionar hardware, escolha a configuração do servidor, o número de nós e os meses de assinatura.

   • Para clusters padrão, o valor padrão de Número de nós é 3. As opções de nó único só estão disponíveis para clientes em uma lista de permissões.

   • Para evitar a rejeição do pedido ou atrasos no atendimento, os detalhes fornecidos precisam corresponder ao contrato assinado com o Google.

   • Quando o formulário estiver completo, clique em Continuar.

6. No formulário Adicionar informações do site, adicione as informações sobre o local onde o hardware conectado da nuvem distribuída será enviado e instalado. É possível adicionar um novo site ou escolher um já existente. Quando terminar, clique em Continuar.

7. No formulário Adicionar informações da zona, adicione uma nova zona ou selecione uma já existente.

   • Em Provisionamento de cluster, se você planeja configurar os clusters por conta própria, selecione Vou configurar clusters no meu local. Se você quiser que o Google configure clusters para você, forneça a intenção do cluster para que o Google possa entregar seu pedido com um cluster pré-configurado.

   • As informações na seção Configuração de rede são necessárias para conectar o hardware na sua zona à rede Google Cloud . Para mais informações sobre as opções, consulte a seção Informações de configuração de rede neste documento.

     • Você pode salvar o pedido como rascunho e deixar que o representante da sua zona e rede insira as informações. Caso contrário, forneça as informações necessárias sobre a rede IP.

     • Em Selecione o modelo preferido para endereços IP, escolha um modelo que atenda aos seus requisitos. Os modelos ajudam a garantir que os detalhes corretos de IP sejam fornecidos. Para inserir endereços IP manualmente, selecione IP personalizado.

   • Quando o formulário estiver completo, clique em Continuar.

8. No formulário Requisitos de instalação, insira os requisitos do seu site físico e clique em Continuar.

9. Em Revisar detalhes e enviar, verifique se os detalhes do pedido estão corretos e clique em Criar. Depois de clicar em Criar, o pedido vai ficar em análise. Um representante de vendas analisa seu envio e entra em contato com você para concluir o pedido. Google Cloud O representante faz o seguinte:

   • Analisa os requisitos da sua empresa para ajudar você a finalizar a configuração do hardware.
   • Coleta mais informações sobre sua rede local, projeto Google Cloud , local de instalação e outros requisitos listados em Requisitos de instalação.
   • Usa essas informações para configurar o hardware do Distributed Cloud antes da entrega.

A data de instalação solicitada é definida automaticamente como a primeira data disponível, geralmente 45 dias após o Google aceitar o pedido.

Solicitar hardware conectado do Distributed Cloud usando a API GDC Hardware Management

Pré-lançamento

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

A API GDC Hardware Management permite fazer um pedido de hardware do Distributed Cloud de maneira programática. Um pedido constitui sua intenção de implantar o Distributed Cloud Connected. Um pedido precisa incluir as seguintes informações, que são usadas durante todo o ciclo de vida da implantação conectada do Distributed Cloud:

• Ponto de contato para gerenciamento de pedidos e entrega
• Endereço do local de entrega e informações relevantes para a entrega
• Configuração de hardware
• Configuração de rede

Você precisa trabalhar com seu representante de vendas do Google para preencher o Questionário de informações do cliente (CIQ, na sigla em inglês) e finalizar o escopo e a configuração da implantação do Distributed Cloud Connected.

Ativar a API GDC Hardware Management

Antes de usar a API GDC Hardware Management, ative-a no projetoGoogle Cloud de destino. Para isso, siga as etapas desta seção.

Console

1. No console do Google Cloud , acesse a página API GDC Hardware Management.

   Ativar a API

2. Clique em Ativar.

gcloud

Use o comando a seguir:

gcloud services enable gdchardwaremanagement.googleapis.com

Estrutura de um pedido

Para fazer um pedido usando a API GDC Hardware Management, crie um recurso Order, além dos recursos Site, Zone e Hardware acompanhantes que o recurso Order referencia. Em seguida, envie o recurso Order ao Google. Esses recursos são compatíveis com operações CRUD padrão. O nome de cada recurso é um caminho que inclui o ID do projeto Google Cloud de destino e a região Google Cloud .

Esses recursos têm as seguintes funções. Para mais informações sobre como usar a API GDC Hardware Management, consulte a referência da API e da CLI do Google Distributed Cloud.

• Order. Esse recurso solicita a criação de uma ou mais zonas do Distributed Cloud. Quando você cria esse recurso, ele recebe um nome acessível no campo create_order_response.name. O nome do recurso Order tem o seguinte formato:

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

  em que:

  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • REGION: a Google Cloud região em que você quer implantar as zonas do Distributed Cloud.
  • ORDER_ID: um ID exclusivo que identifica este pedido. Se for omitido, um valor será gerado automaticamente. Recomendamos que você forneça um valor de ID do pedido exclusivo composto por letras minúsculas, números e traços. Caso contrário, as chamadas de criação de pedido com falha podem gerar pedidos duplicados.

• Site. Esse recurso representa o local físico em que você quer implantar o hardware do Distributed Cloud. Esse recurso inclui as dados de contato de um responsável que coordena o acesso para entrega inicial e manutenção futura. Esse contato pode ser diferente do que você informou no pedido.

• Hardware. Esse recurso cria uma instância de uma SKU do Distributed Cloud Connected e representa um servidor ou rack do Distributed Cloud. Cada recurso Hardware faz referência aos recursos Order, Site e Zone associados. Para conferir as SKUs disponíveis, use a chamada de API ListSkus.

• Zone. Esse recurso especifica a configuração de rede das máquinas conectadas e dos clusters associados do Distributed Cloud. Uma zona da nuvem distribuída abrange um ou mais racks conectados da nuvem distribuída ou todas as máquinas de servidor conectadas da nuvem distribuída implantadas no seu local.

Quando você envia um recurso Order ao Google e o status muda de DRAFT para SUBMITTED ou INFO_COMPLETE, a maioria dos valores de campo se torna somente leitura.

Ciclo de vida de um pedido

Um recurso Order pode ter um dos estados listados em State. As partes envolvidas podem deixar comentários no pedido, que são armazenados como recursos Comment aninhados no recurso Order correspondente. É possível ler e enviar comentários pela API GDC Hardware Management e pelo console Google Cloud .

A API GDC Hardware Management é compatível com as seguintes operações de ciclo de vida de pedidos:

• Crie e envie um pedido. Você pode criar e enviar um pedido imediatamente ou criar gradualmente e salvar no estado DRAFT até que esteja pronto para envio. Esse processo é descrito no restante deste guia.

• Verifique o status do pedido. Se o pedido for enviado com o type INFO_COMPLETE e você tiver assinado um contrato com o Google, o pedido vai passar pela seguinte sucessão de estados: ACCEPTED, BUILDING, SHIPPING, INSTALLING e COMPLETED.. Os estados dos recursos associados Zone e Hardware são atualizados em sincronia com o recurso Order.

• Resolver problemas com pedidos. Se precisarmos de mais informações ou se você não tiver assinado um contrato com o Google, o pedido vai entrar no estado ADDITIONAL_INFO_NEEDED e aguardar resolução por comentários. Procure mais instruções em um comentário e entre em contato com o Google se as próximas etapas não estiverem claras.

• Excluir um pedido não enviado. É possível excluir um pedido não enviado com uma chamada DELETE.

• Modificar um pedido enviado. É possível modificar o pedido, o site e a zona enviados usando a respectiva chamada PATCH. Os seguintes campos podem ser editados após o envio:

  • Todos os recursos: display_name, labels
  • Pedido: organization_contact
  • Site: access_times, a maioria dos campos de organization_contact, mas não o endereço do site
  • Hardware: requested_installation_date se pelo menos uma das seguintes condições for verdadeira:
    • A nova data é daqui a mais de 45 dias
    • O novo requested_installation_date é posterior ao requested_installation_date atual e estimated_installation_date está vazio
    • A nova requested_installation_date é posterior à requested_installation_date atual e estimated_installation_date está a pelo menos 7 dias da data atual

  Nenhuma outra informação pode ser modificada depois que um pedido é enviado, mas você pode pedir ao Google para fazer isso deixando um comentário.

• Cancelar um pedido enviado. Para cancelar um pedido enviado, adicione um comentário solicitando o cancelamento.

Selecione o projeto de destino Google Cloud

Um Google Cloud projeto é uma estrutura que encapsula um conjunto de Google Cloud recursos, disponibiliza esses recursos para uso e estabelece regras de controle de acesso e faturamento para eles.

Recomendamos que você crie um projeto Google Cloud separado por domínio administrativo, como um país ou departamento corporativo, e caso de uso de alto nível, como borda x núcleo, e gerencie a implantação conectada do Distributed Cloud para o domínio por esse projeto Google Cloud .

O projeto Google Cloud permite realizar as seguintes tarefas de gerenciamento:

• Peça o hardware conectado do Distributed Cloud.
• Configure e registre os clusters conectados do Distributed Cloud em uma frota.
• Gerenciar lançamentos de software.
• Gerenciar dados conectados do Distributed Cloud no Cloud Storage.
• Gerenciar credenciais conectadas do Distributed Cloud no Secret Manager.
• Gerenciar registros e métricas conectados do Distributed Cloud no Cloud Monitoring.

Sua topologia exata do projeto Google Cloud depende dos requisitos da sua empresa. Recomendamos evitar dependências entre projetos e sempre criar e usar recursos em cada projeto Google Cloud .

O hardware pedido em um projeto Google Cloud específico é sempre gerenciado nesse projeto Google Cloud .

Selecione a região de destino Google Cloud

A escolha específica das Google Cloud regiões para sua implantação conectada do Distributed Cloud depende dos requisitos de negócios e das ramificações legais dos locais geográficos de destino.

Se você estiver integrando sua implantação conectada do Distributed Cloud a uma área de cobertura multirregional doGoogle Cloud , recomendamos mapear cada zona conectada do Distributed Cloud para a região Google Cloud que hospeda as dependências dessa zona.

Se você não estiver integrando a implantação conectada do Distributed Cloud a uma área de cobertura Google Cloud existente, recomendamos diversificar a seleção de região Google Cloud para aumentar a confiabilidade. Exemplo:

• Mapeie cada zona do Distributed Cloud Connected para a região compatível Google Cloud mais próxima. Isso limita o impacto de uma falha no plano de gerenciamento a uma única região geográfica.

• Faça o stripe do Distributed Cloud conectado em várias Google Cloud regiões. Isso limita o número de zonas do Distributed Cloud Connected que podem ser afetadas por uma falha no plano de gerenciamento. No entanto, as zonas afetadas são distribuídas por uma região geográfica maior.

  O Distributed Cloud Connected é compatível com as seguintes regiões Google Cloud :

• Ásia: asia-east1, asia-east2, asia-northeast1, asia-northeast3, asia-south1, asia-south2, asia-southeast1, asia-southeast2

• Europa: europe-central2, europe-north1, europe-west1, europe-west2, europe-west3, europe-west4, europe-west6, europe-west8, europe-west9

• Oriente Médio: me-central1, me-west1

• Oceania: australia-southeast1

• América do Norte: 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

• América do Sul: southamerica-east1, southamerica-west1

Configurar o ambiente

Antes de começar, atenda aos seguintes pré-requisitos:

1. Configure um ambiente de desenvolvimento em Python.

2. Instale a biblioteca de cliente da API GDC Hardware Management usando o seguinte comando:

   python3 -m pip install google-cloud-gdchardwaremanagement
   

3. Ative a API GDC Hardware Management no projeto Google Cloud de destino.

Criar e enviar um pedido de hardware do Distributed Cloud Connected usando a API GDC Hardware Management

As etapas nesta seção são exemplos que ilustram como criar e enviar um recurso Order ao Google usando a API GDC Hardware Management. Para concluir as etapas desta seção, você precisa ter o papel de Administrador do gerenciamento de hardware do GDC (roles/gdchardwaremanagement.admin) no seu projeto Google Cloud . Para mais detalhes sobre os tipos e métodos disponíveis, consulte a referência da biblioteca de cliente do Python.

1. Crie um recurso Order. Exemplo:

   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()

   Seu pedido agora está no estado DRAFT e recebeu um nome de recurso armazenado no campo create_order_response.name. Use esse nome de recurso ao modificar ou acompanhar o status deste pedido.

2. Criar um recurso Site. Exemplo:

   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. Criar um recurso Zone. Exemplo:

   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. Crie os recursos Hardware. É necessário especificar um valor hardware_id exclusivo para cada máquina na implantação conectada do Distributed Cloud. Exemplo:

   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. Envie o recurso Order ao Google:

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

   O tipo de envio de INFO_COMPLETE indica que você forneceu todas as informações necessárias nos recursos Zone e Hardware. Se algum valor de campo estiver faltando, o envio vai falhar com uma mensagem de erro descrevendo o problema. Se você quiser iniciar uma conversa com o Google sem preencher totalmente o pedido, envie-o com um status INFO_PENDING para pular essas validações.

Teste

Se quiser enviar um pedido de teste, entre em contato com o Google para ter acesso a um ambiente de sandbox. Depois que seu projeto ou organização receber acesso, você poderá usar uma SKU de teste identificável pelo prefixo fake-. Os pedidos de teste passam pelas etapas descritas anteriormente, mas não geram cobranças financeiras nem envio de hardware.

Solução de problemas

Esta seção descreve os erros mais comuns, as causas e as soluções disponíveis.

Erro: 400 FAILED_PRECONDITION

Se você receber um código de erro 400 com um status FAILED_PRECONDITION em resposta à chamada de API, verifique se a solicitação é válida para a operação que você está tentando concluir. Exemplos de solicitações inválidas incluem o envio de um recurso Order com campos ou valores ausentes ou a tentativa de excluir um recurso Hardware associado a um recurso Order enviado anteriormente.

Erro: 400 INVALID_ARGUMENT

Se você receber um código de erro 400 com um status INVALID_ARGUMENT em resposta à chamada de API, verifique se há nomes de campos e valores incorretos que não correspondem aos tipos esperados ou se há valores ausentes. Você também pode receber esse erro se usar um updateMask em uma solicitação PATCH e um ou mais campos especificados no updateMask forem inválidos.

Para corrigir esse problema, consulte a API GDC Hardware Management para verificar se todos os nomes e valores de campos estão corretos, incluindo a formatação. Se você estiver usando um payload JSON, confirme se todas as informações necessárias estão incluídas nele.

Erro: 401 UNAUTHENTICATED

Se você receber um código de erro 401 com um status UNAUTHENTICATED em resposta à chamada de API, verifique sua configuração de autenticação. Para mais informações, consulte Configurar o Application Default Credentials.

Erro: 403 PERMISSION_DENIED

Se você receber um código de erro 403 com um status PERMISSION_DENIED em resposta à chamada de API, verifique se a conta de serviço usada para fazer a chamada tem privilégios suficientes para acessar os objetos e recursos de destino. Verifique também se as credenciais estão corretas e não expiraram.

Erro: 404 NOT_FOUND

Se você receber um código de erro 404 com um status NOT_FOUND em resposta à sua chamada de API, verifique se os nomes de recursos e o caminho especificados na chamada de API são válidos. Consulte a API GDC Hardware Management para verificar se o URL da solicitação está estruturado corretamente e se todos os campos incluídos no URL são válidos.

Acompanhar o status do pedido

Você pode acompanhar o status do seu pedido no console Google Cloud na página Pedidos. A tabela a seguir lista os status possíveis e o significado deles.

Status da interface	Significado
Rascunho	O pedido é salvo como rascunho.
Em análise	O pedido é enviado e está sendo analisado pelo Google.
Aceito	O Google aceitou o pedido para atendimento.
Como criar hardware	O hardware está sendo construído e provisionado no Google ou na instalação de um parceiro.
Envio de hardware	O hardware está sendo enviado para o endereço do local fornecido.
Instalando	O hardware está sendo instalado no endereço do local fornecido.
Em andamento	O pedido foi concluído parcialmente. Por exemplo, alguns hardwares foram entregues e instalados.
Concluído	O pedido foi concluído.
Falta de informações	Precisamos de mais informações.
Ação necessária	É necessária atenção imediata devido a um problema crítico.
Cancelado	O pedido foi recusado.

A seguir

• Implantar cargas de trabalho no Google Distributed Cloud conectado