Para informações sobre a versão, consulte as notas da versão do Distributed Cloud Connected.

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.

Pré-requisitos

Antes de fazer um pedido, você precisa ter as seguintes informações:

Contato do pedido. Uma pessoa responsável por gerenciar a implantação do hardware conectado do Distributed Cloud na sua organizaçã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 reparos e desativação de hardware com o Google ou um SI certificado pelo Google.
Contato da zona. Uma pessoa responsável por integrar o hardware conectado da nuvem distribuída à infraestrutura de rede e energia existente no local de implantação.
Identificador do pedido. Um identificador significativo para este pedido de hardware conectado do Distributed Cloud.
Identificador do site. Um identificador significativo para o site de implantação deste pedido de hardware conectado do Distributed Cloud.
Identificador de 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.

Pedir hardware conectado do Distributed Cloud usando o console Google Cloud

No console do Google Cloud , acesse a página Pedidos.
Acessar "Pedidos"
Selecione o projeto de destino Google Cloud .
Clique em Criar pedido.
Preencha e envie o formulário de solicitação.

Um representante de vendas da Google Cloud analisa sua inscrição e entra em contato com você para concluir o pedido. 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.

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

A API GDC Hardware Management permite fazer um pedido de hardware do Distributed Cloud de forma 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

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

Ativar a API
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 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:

Configure um ambiente de desenvolvimento em Python.
Instale a biblioteca de cliente da API GDC Hardware Management usando o seguinte comando:
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
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.

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="jcustomer@example.com",
    phone="+1 123 456 7890",
)

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.

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

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

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

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.

A seguir

Implantar cargas de trabalho no Google Distributed Cloud conectado