Ordina hardware

Questa pagina descrive come ordinare l'hardware Google Distributed Cloud connected. Distributed Cloud connected è disponibile nei seguenti paesi:

• Australia
• Austria
• Belgioj
• Brasile
• Canada
• Cile
• Danimarca
• Finlandia
• Francia
• Germania
• Hong Kong
• Giappone
• India
• Indonesia
• Italia
• Malaysia
• Mexico
• Paesi Bassi
• Norvegia
• Polonia
• Arabia Saudita
• Singapore
• Corea del Sud
• Spagna
• Svezia
• Svizzera
• Regno Unito
• Stati Uniti
• Uruguay

Prima di ordinare l'hardware, devi soddisfare i requisiti di installazione di Distributed Cloud Connected.

Modelli di approvvigionamento di Distributed Cloud connected

Puoi ordinare l'hardware connesso a Distributed Cloud in uno dei seguenti modi, in base alle tue esigenze aziendali:

• Hardware di proprietà di Google. Puoi ordinare l'hardware Distributed Cloud connesso direttamente da Google. In questo scenario, Google reperisce, gestisce, ripara e ritira l'hardware Distributed Cloud connesso. Al termine del contratto, Google raccoglie l'hardware Distributed Cloud e distrugge tutti i dati memorizzati.

• Hardware fornito dal cliente. Puoi ordinare Distributed Cloud connesso da un integratore di sistemi (SI) certificato da Google dopo aver consultato Google in merito a una configurazione di deployment adatta ai requisiti della tua attività. In questo scenario, possiedi l'hardware Distributed Cloud connesso. L'integratore di sistemi collabora con te e Google per il deployment, la riparazione e il ritiro dell'hardware. Al termine del contratto, l'integratore di sistemi cancella tutto il software Google e i tuoi dati dall'hardware connesso a Distributed Cloud. A questo punto puoi riutilizzare o smaltire l'hardware. Questo tipo di approvvigionamento è disponibile solo per i server connessi a Distributed Cloud.

Varianti hardware di Distributed Cloud connesso

L'hardware dei server Distributed Cloud connected è disponibile nei seguenti fattori di forma:

• Server Distributed Cloud connesso G1. Un gruppo di tre macchine Dell XR11 1U per montaggio su rack. Per ulteriori informazioni, vedi Hardware dei server G1 di Distributed Cloud connesso.

• Server Distributed Cloud connected G2. Uno chassis Dell XR8000r popolato con tre slitte per macchine XR8610t. Per ulteriori informazioni, vedi Hardware dei server G2 di Distributed Cloud connesso.

Per un elenco degli SKU dei server Distributed Cloud connected, consulta la pagina Prezzi di Distributed Cloud connected.

Prerequisiti

Questa sezione descrive i requisiti di configurazione di Google Cloud e le informazioni che devi raccogliere prima di ordinare l'hardware.

Google Cloud setup

Prima di iniziare, assicurati di disporre delle autorizzazioni necessarie e che l'API sia attivata nel tuo progetto Google Cloud . Devi completare questi passaggi indipendentemente dal fatto che effettui ordini direttamente tramite la console Google Cloud o tramite un'API integrata.

• ProgettoGoogle Cloud : devi avere un progetto Google Cloud con un amministratore autorizzato ad abilitare l'API Distributed Cloud Hardware Management. Per saperne di più sulla creazione di un progetto Google Cloud, consulta Creare un progetto. Il progetto che utilizzi per gestire i cluster deve essere lo stesso che utilizzi per ordinare l'hardware.

• API Distributed Cloud Hardware Management: devi abilitare l'API Distributed Cloud Hardware Management. Nella console Google Cloud , vai alla pagina API GDC Hardware Management. Se necessario, fai clic su Abilita per abilitare l'API.

  Vai all'API GDC Hardware Management

• Ruoli IAM: per ordinare hardware, devi disporre del ruolo IAM GDC Hardware Management Admin (gdchardwaremanagement.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

• Requisito contrattuale: prima che Google possa elaborare una richiesta di evasione, devi disporre di un contratto valido e firmato e di un ID fatturazione. Per saperne di più, consulta Trovare un ID account di fatturazione Cloud.

Contatti

Per effettuare un ordine, devi fornire i seguenti contatti:

• Contatto per l'ordine: una persona responsabile della gestione del deployment dell'hardware connesso a Distributed Cloud nella tua organizzazione. Specifica un rappresentante dell'azienda che possiamo contattare per completare i processi di vendita e di gestione del contratto.

• Contatto del sito: una persona responsabile del sito di implementazione selezionato. Google contatta questa persona per pianificare e completare la consegna dell'hardware Google Distributed Cloud connesso. Questa persona coordina anche le riparazioni e il ritiro dell'hardware con Google o con un integratore di sistemi certificato da Google.

• Contatto per la zona e la rete: una persona responsabile dell'integrazione dell'hardware Distributed Cloud connesso nell'infrastruttura di rete ed elettrica esistente nel sito di deployment. Questa persona aiuta anche a risolvere i problemi congiuntamente, se necessario.

Informazioni sito

Prima di effettuare un ordine, raccogli le seguenti informazioni:

• Identificatore ordine: un identificatore significativo per questo ordine di hardware connesso a Distributed Cloud. Un ID ordine viene generato automaticamente in base al nome dell'ordine, ma puoi modificarlo se necessario.

• Identificatore del sito: un identificatore significativo per il sito di deployment per questo ordine di hardware connesso a Distributed Cloud.

• Identificatore zona: un identificatore significativo per la zona connessa a Distributed Cloud di destinazione. Se implementi una sola zona per sito, utilizza l'identificatore del sito come identificatore della zona.

• Paese di deployment: il paese in cui verrà eseguito il deployment dell'hardware. Il paese influisce sulla valuta di fatturazione e sulla disponibilità dell'hardware. Per ordinare hardware in più località, crea ordini separati per ogni paese.

• Regione: la posizione geografica in cui vengono archiviati i dati dei clienti e degli ordini. Questa selezione garantisce che i tuoi dati rimangano all'interno della regione selezionata, aiutandoti a soddisfare i requisiti di conformità.

• Informazioni sull'azienda: quando effettui l'ordine, devi fornire nome, indirizzo email, numero di telefono e indirizzo di fatturazione dell'azienda.

Informazioni sulla configurazione di rete

Quando effettui l'ordine, devi effettuare le selezioni per la configurazione della rete. Utilizza le informazioni nella tabella seguente per comprendere la configurazione di rete che devi fornire durante il posizionamento dell'ordine.

Tipo di rete	Nome della configurazione IP	Descrizione
Rete di gestione delle macchine	Indirizzi IPv4 per la gestione delle macchine in notazione CIDR	Ogni server ha un indirizzo IP per il traffico di gestione di Distributed Cloud. Questo blocco configura gli indirizzi IP della subnet di gestione delle macchine utilizzati per questa attività.
	Subnet di gestione delle macchine IPv4 in notazione CIDR	La subnet allocata per il traffico di gestione di Distributed Cloud. Il traffico include aggiornamenti software dell'infrastruttura Distributed Cloud e log e metriche dell'infrastruttura. Questa subnet deve essere abbastanza grande da contenere il blocco di indirizzi IPv4 per la gestione delle macchine e il gateway predefinito della subnet di gestione delle macchine.
	Gateway predefinito per la subnet di gestione delle macchine	L'indirizzo IP del gateway all'interno della subnet di gestione delle macchine
Traffico dei nodi Kubernetes	Indirizzi dei nodi Kubernetes IPv4 in notazione CIDR	Ogni server ha un indirizzo IP per il traffico relativo a Kubernetes. Questo blocco configura gli indirizzi IP della subnet Kubernetes utilizzati per il traffico relativo a Kubernetes.
	Blocco di indirizzi IPv4 per i VIP del control plane Kubernetes nella notazione CIDR	A ogni cluster Kubernetes creato nella zona edge viene assegnato un VIP del control plane da questo blocco di indirizzi. Se prevedi di creare un solo cluster nella zona perimetrale, puoi utilizzare un blocco di indirizzi /32. In caso contrario, il blocco di indirizzi deve essere più grande.
	Subnet Kubernetes IPv4 in notazione CIDR	La subnet allocata per il traffico Kubernetes. Il traffico include i download di container, il networking primario di Kubernetes, i log e le metriche di Kubernetes e il traffico del control plane di Kubernetes. Se è vuota, questa subnet viene impostata automaticamente su subnet di gestione delle macchine IPv4. Puoi anche specificare una subnet separata in questo campo. Questa subnet deve essere abbastanza grande da contenere il blocco di indirizzi IPv4 per il traffico dei nodi Kubernetes, il blocco di indirizzi IPv4 per i VIP del control plane Kubernetes, il gateway predefinito della subnet Kubernetes e tutti i VIP pianificati del bilanciatore del carico di rete primaria. Se non specificato, questo valore è uguale a quello della rete di gestione.
	Gateway predefinito della subnet Kubernetes	L'indirizzo IP del gateway all'interno della subnet Kubernetes. Se è vuoto, questo campo viene impostato su Gateway predefinito per la subnet di gestione delle macchine.
	ID VLAN principale di Kubernetes	Per impostazione predefinita, il nodo Kubernetes, inclusa la rete Kubernetes principale, si trova nella stessa VLAN della rete di gestione delle macchine. A fini di segmentazione della rete, puoi separare queste reti.
Server dei nomi DNS	Server dei nomi DNS 1	Gli IP del server dei nomi DNS. L'infrastruttura Distributed Cloud risolve le query DNS tramite questi IP. Se non specificato, viene utilizzato il DNS di Google.
	Server dei nomi DNS 2	Gli IP del server dei nomi DNS. L'infrastruttura Distributed Cloud risolve le query DNS tramite questi IP. Se non specificato, viene utilizzato il DNS di Google.

Ordina l'hardware connesso a Distributed Cloud utilizzando la console Google Cloud

1. Nella console Google Cloud , vai alla pagina Ordini.

   Vai a Ordini

2. Seleziona il progetto Google Cloud di destinazione.

3. Fai clic su Crea ordine singolo.

4. Nel modulo Dettagli ordine, inserisci i dettagli dell'ordine che hai raccolto nella sezione Prerequisiti di questo documento. Fai clic su Continua.

   Nota :dopo aver inserito le informazioni nella pagina Dettagli ordine, puoi salvare una bozza dell'ordine facendo clic su Salva come bozza. Questa opzione è disponibile per ogni fase della procedura di ordine.

5. Nel modulo Seleziona hardware, seleziona la configurazione del server, il numero di nodi e i mesi di abbonamento.

   • Per i cluster standard, il valore predefinito per il numero di nodi è 3. Le opzioni a nodo singolo sono disponibili solo per i clienti in una lista consentita.

   • Per evitare il rifiuto dell'ordine o ritardi nell'evasione, i dettagli che fornisci devono corrispondere al contratto Google firmato.

   • Al termine della compilazione del modulo, fai clic su Continua.

6. Nel modulo Aggiungi informazioni sul sito, aggiungi le informazioni sul sito in cui verranno spediti e installati l'hardware Distributed Cloud connesso. Puoi aggiungere un nuovo sito o sceglierne uno esistente. Al termine, fai clic su Continua.

7. Nel modulo Aggiungi informazioni sulla zona, aggiungi una nuova zona o seleziona una zona esistente.

   • Per il provisioning dei cluster, se prevedi di configurare i cluster autonomamente, seleziona Configurerò i cluster nel mio sito. Se vuoi che Google configuri i cluster per te, devi fornire l'intent del cluster in modo che Google possa consegnare l'ordine con un cluster preconfigurato.

   • Le informazioni nella sezione Configurazione di rete sono necessarie per connettere l'hardware nella tua zona alla rete Google Cloud . Per ulteriori informazioni sulle opzioni, consulta la sezione Informazioni sulla configurazione di rete di questo documento.

     • Puoi salvare l'ordine come bozza e lasciare che il rappresentante della zona e dell'emittente inserisca le informazioni. In caso contrario, fornisci le informazioni di rete IP necessarie.

     • In Seleziona il modello preferito per gli indirizzi IP, seleziona un modello che soddisfi i tuoi requisiti. I modelli contribuiscono a garantire che vengano forniti i dettagli IP corretti. Per inserire manualmente gli indirizzi IP, seleziona IP personalizzato.

   • Al termine della compilazione del modulo, fai clic su Continua.

8. Nel modulo Requisiti di installazione, inserisci i requisiti del tuo sito fisico e poi fai clic su Continua.

9. In Rivedi i dettagli e invia, verifica che i dettagli dell'ordine siano corretti, quindi fai clic su Crea. Dopo aver fatto clic su Crea, l'ordine è in revisione. Un rappresentante di vendita esamina la tua richiesta e ti contatta per completare l'ordine. Google Cloud Il rappresentante esegue le seguenti operazioni:

   • Esamina i requisiti della tua attività per aiutarti a finalizzare la configurazione hardware.
   • Raccoglie ulteriori informazioni sulla tua rete locale, Google Cloud sul progetto, sul sito di installazione e su altri requisiti elencati nei requisiti di installazione.
   • Utilizza queste informazioni per configurare l'hardware Distributed Cloud prima della consegna.

La data di installazione richiesta viene impostata automaticamente sulla prima data disponibile, in genere 45 giorni dopo l'accettazione dell'ordine da parte di Google.

Ordina hardware Distributed Cloud connesso utilizzando l'API GDC Hardware Management

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

L'API GDC Hardware Management ti consente di effettuare in modo programmatico un ordine per l'hardware Distributed Cloud. Un ordine costituisce la tua intenzione di eseguire il deployment di Distributed Cloud connesso. Un ordine deve includere le seguenti informazioni, che vengono utilizzate per l'intero ciclo di vita della tua implementazione connessa di Distributed Cloud:

• Punto di contatto per la gestione e la consegna degli ordini
• Indirizzo del sito di consegna e qualsiasi informazione pertinente alla consegna
• Configurazione hardware
• Configurazione di rete

Devi collaborare con il tuo rappresentante di vendita Google per completare il questionario sulle informazioni del cliente (CIQ) e finalizzare l'ambito e la configurazione del deployment di Distributed Cloud connesso.

Abilita l'API GDC Hardware Management

Prima di poter utilizzare l'API GDC Hardware Management, devi abilitarla nel progettoGoogle Cloud di destinazione. Per farlo, completa i passaggi descritti in questa sezione.

Console

1. Nella console Google Cloud , vai alla pagina API GDC Hardware Management.

   Abilitare l'API

2. Fai clic su Attiva.

gcloud

Utilizza il seguente comando:

gcloud services enable gdchardwaremanagement.googleapis.com

Struttura di un ordine

Per effettuare un ordine utilizzando l'API GDC Hardware Management, devi creare una risorsa Order, oltre alle risorse Site, Zone e Hardware di accompagnamento a cui fa riferimento la risorsa Order. Dopodiché, invii la risorsa Order a Google. Queste risorse supportano le operazioni CRUD standard. Il nome di ogni risorsa è un percorso che include l'ID progetto Google Cloud e la regione Google Cloud di destinazione.

Queste risorse hanno le seguenti funzioni. Per saperne di più sull'utilizzo dell'API GDC Hardware Management, consulta la documentazione di riferimento dell'API e di Google Distributed Cloud CLI.

• Order. Questa risorsa richiede la creazione di una o più zone Distributed Cloud. Quando crei questa risorsa, riceve un nome accessibile nel campo create_order_response.name. Il nome della risorsa Order ha il seguente formato:

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

  dove:

  • PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui vuoi eseguire il deployment delle zone Distributed Cloud.
  • ORDER_ID: un ID univoco che identifica questo ordine. Se omesso, viene generato automaticamente un valore. Ti consigliamo di fornire un valore ID ordine univoco composto da lettere minuscole, numeri e trattini. In caso contrario, le chiamate di creazione degli ordini non riuscite possono generare ordini duplicati.

• Site. Questa risorsa rappresenta la posizione fisica in cui vuoi eseguire il deployment dell'hardware Distributed Cloud. Questa risorsa include i dati di contatto di una parte responsabile che coordina l'accesso per la consegna iniziale e la manutenzione futura. Questo contatto potrebbe essere diverso da quello che hai fornito nell'ordine.

• Hardware. Questa risorsa crea un SKU Distributed Cloud connected e rappresenta un server o un rack Distributed Cloud. Ogni risorsa Hardware fa riferimento alle risorse Order,Site e Zone associate. Per visualizzare gli SKU disponibili, utilizza la chiamata API ListSkus.

• Zone. Questa risorsa specifica la configurazione di rete delle macchine connesse a Distributed Cloud e dei cluster associati. Una zona Distributed Cloud copre uno o più rack connessi a Distributed Cloud o tutte le macchine server connesse a Distributed Cloud distribuite nella tua sede.

Quando invii una risorsa Order a Google e il relativo stato cambia da DRAFT a SUBMITTED o INFO_COMPLETE, la maggior parte dei valori dei campi diventa di sola lettura.

Ciclo di vita di un ordine

Una risorsa Order può avere uno degli stati elencati in State. Le parti coinvolte possono lasciare commenti sull'ordine, che vengono archiviati come risorse Comment nidificate nella risorsa Order corrispondente. Puoi leggere e inviare commenti tramite l'API GDC Hardware Management e la console Google Cloud .

L'API GDC Hardware Management supporta le seguenti operazioni del ciclo di vita degli ordini:

• Crea e invia un ordine. Puoi creare e inviare immediatamente un ordine oppure crearlo gradualmente e salvarlo nello stato DRAFT finché non è pronto per l'invio. Questa procedura è descritta nel resto di questa guida.

• Controlla lo stato dell'ordine. Se l'ordine viene inviato con type INFO_COMPLETE e hai firmato un contratto con Google, l'ordine procede attraverso la seguente successione di stati: ACCEPTED, BUILDING, SHIPPING, INSTALLING e COMPLETED.. Gli stati delle risorse Zone e Hardware associate vengono aggiornati in sincronia con la risorsa Order.

• Risolvere i problemi relativi all'ordine. Se abbiamo bisogno di ulteriori informazioni da parte tua o se non hai firmato un contratto con Google, l'ordine entra nello stato ADDITIONAL_INFO_NEEDED e attende la risoluzione tramite commenti. Cerca ulteriori istruzioni in un commento e contatta Google se i passaggi successivi non sono chiari.

• Eliminare un ordine non inviato. Puoi eliminare un ordine non inviato con una chiamata DELETE.

• Modificare un ordine inviato. Puoi modificare l'ordine, il sito e la zona inviati utilizzando la chiamata PATCH corrispondente. I seguenti campi sono modificabili dopo l'invio:

  • Tutte le risorse: display_name, labels
  • Ordine: organization_contact
  • Sito: access_times, la maggior parte dei campi di organization_contact, ma non l'indirizzo del sito
  • Hardware: requested_installation_date se almeno una delle seguenti condizioni è vera:
    • La nuova data è tra più di 45 giorni
    • Il nuovo requested_installation_date è successivo all'attuale requested_installation_date e estimated_installation_date è vuoto
    • La nuova requested_installation_date è successiva alla requested_installation_date attuale e la estimated_installation_date è almeno 7 giorni dopo la data attuale

  Una volta inviato un ordine, non è possibile modificare altre informazioni, ma puoi chiedere a Google di farlo inserendo un commento.

• Annullare un ordine inviato. Puoi annullare un ordine inviato aggiungendo un commento in cui richiedi l'annullamento.

Seleziona il progetto di destinazione Google Cloud

Un progetto Google Cloud è un costrutto che incapsula un insieme di risorse Google Cloud , le rende disponibili per l'uso e stabilisce regole percontrollo dell'accessoo dell'accesso e la fatturazione per queste risorse.

Ti consigliamo di creare un progetto Google Cloud separato per ogni dominio amministrativo, ad esempio un paese o un reparto aziendale, e per ogni caso d'uso di alto livello, ad esempio edge e core, e di gestire il deployment connesso di Distributed Cloud per il dominio tramite questo Google Cloud progetto.

Il progetto Google Cloud ti consente di eseguire le seguenti attività di gestione:

• Ordina l'hardware Google Distributed Cloud connesso.
• Configura i cluster connessi Distributed Cloud e registrali in un parco risorse.
• Gestisci i rollout del software.
• Gestisci i dati connessi di Distributed Cloud in Cloud Storage.
• Gestisci le credenziali di Distributed Cloud connesso in Secret Manager.
• Gestisci i log e le metriche di Distributed Cloud connected in Cloud Monitoring.

La topologia esatta del progetto dipende dai requisiti aziendali. Google Cloud Ti consigliamo di evitare le dipendenze tra progetti e di creare e utilizzare sempre le risorse all'interno di ogni progetto Google Cloud .

L'hardware ordinato all'interno di un progetto Google Cloud specifico viene sempre gestito in quel progetto Google Cloud .

Seleziona la regione Google Cloud di destinazione

La scelta specifica delle Google Cloud regioni per il deployment di Distributed Cloud Connected dipende dai requisiti aziendali e dalle implicazioni legali delle località geografiche di destinazione.

Se stai integrando il deployment connesso a Distributed Cloud in un'improntaGoogle Cloud multiregionale esistente, ti consigliamo di mappare ogni zona connessa a Distributed Cloud alla regione Google Cloud che ospita le dipendenze della zona.

Se non integri il deployment connesso di Distributed Cloud con un footprint Google Cloudesistente, ti consigliamo di diversificare la selezione delle regioni Google Cloud per una maggiore affidabilità. Ad esempio:

• Mappa ogni zona Distributed Cloud connessa alla regione Google Cloud supportata più vicina. In questo modo, l'impatto di un errore del piano di gestione è limitato a una singola regione geografica.

• Stripe your Distributed Cloud connected across several Google Cloud regions. In questo modo si limita il numero di zone Distributed Cloud Connected che possono essere interessate da un errore del piano di gestione; tuttavia, le zone interessate sono distribuite su una regione geografica più ampia.

  Distributed Cloud connesso supporta le seguenti Google Cloud regioni:

• Asia: 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

• Medio Oriente: me-central1, me-west1

• Oceania: australia-southeast1

• Nord America: 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

• Sud America: southamerica-east1, southamerica-west1

Configura l'ambiente

Prima di iniziare, completa i seguenti prerequisiti:

1. Configura un ambiente di sviluppo Python.

2. Installa la libreria client dell'API GDC Hardware Management utilizzando questo comando:

   python3 -m pip install google-cloud-gdchardwaremanagement
   

3. Abilita l'API GDC Hardware Management nel progetto Google Cloud di destinazione.

Crea e invia un ordine di hardware Distributed Cloud connesso utilizzando l'API GDC Hardware Management

I passaggi descritti in questa sezione sono esempi che illustrano come creare e inviare una risorsa Order a Google utilizzando l'API GDC Hardware Management. Per completare i passaggi descritti in questa sezione, devi disporre del ruolo Amministratore della gestione hardware GDC (roles/gdchardwaremanagement.admin) nel tuo progetto Google Cloud . Per informazioni dettagliate sui tipi e sui metodi disponibili, consulta il riferimento della libreria client Python.

1. Crea una risorsa Order. Ad esempio:

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

   Il tuo ordine è ora nello stato DRAFT e gli è stato assegnato un nome risorsa memorizzato nel campo create_order_response.name. Utilizza questo nome risorsa quando modifichi o monitori lo stato di questo ordine.

2. Crea una risorsa Site. Ad esempio:

   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. Crea una risorsa Zone. Ad esempio:

   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. Crea le risorse Hardware. Devi specificare un valore hardware_id univoco per ogni macchina nel deployment connesso a Distributed Cloud. Ad esempio:

   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. Invia la risorsa Order a 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()

   Il tipo di invio di INFO_COMPLETE indica che hai fornito tutte le informazioni richieste nelle risorse Zone e Hardware. Se mancano valori di campo, l'invio non va a buon fine e viene visualizzato un messaggio di errore che descrive il problema. Se vuoi avviare una conversazione con Google senza compilare completamente l'ordine, invialo con lo stato INFO_PENDING per saltare queste convalide.

Test

Se vuoi inviare un ordine di test, contatta Google per accedere a un ambiente sandbox. Una volta concesso l'accesso al tuo progetto o alla tua organizzazione, puoi utilizzare uno SKU di test identificabile dal prefisso fake-. Gli ordini di test avanzano nelle fasi descritte in precedenza, ma non attivano addebiti monetari o una spedizione di hardware.

Risoluzione dei problemi

Questa sezione descrive gli errori più comuni, le relative cause e le soluzioni disponibili.

Errore: 400 FAILED_PRECONDITION

Se ricevi un codice di errore 400 con uno stato FAILED_PRECONDITION in risposta alla chiamata API, verifica che la richiesta sia valida per l'operazione che stai tentando di completare. Alcuni esempi di richieste non valide includono l'invio di una risorsa Order con campi o valori mancanti o il tentativo di eliminare una risorsa Hardware associata a una risorsa Order inviata in precedenza.

Errore: 400 INVALID_ARGUMENT

Se ricevi un codice di errore 400 con uno stato INVALID_ARGUMENT in risposta alla chiamata API, verifica la presenza di nomi e valori di campi errati che non corrispondono ai tipi previsti o di valori mancanti. Potresti ricevere questo errore anche se utilizzi un updateMask in una richiesta PATCH e uno o più campi specificati nel updateMask non sono validi.

Per risolvere il problema, consulta l'API GDC Hardware Management per verificare che tutti i nomi e i valori dei campi siano corretti, inclusa la formattazione. Se utilizzi un payload JSON, verifica che tutte le informazioni richieste siano incluse nel payload.

Errore: 401 UNAUTHENTICATED

Se ricevi un codice di errore 401 con uno stato UNAUTHENTICATED in risposta alla chiamata API, controlla la configurazione dell'autenticazione. Per saperne di più, consulta Configurare le credenziali predefinite dell'applicazione.

Errore: 403 PERMISSION_DENIED

Se ricevi un codice di errore 403 con uno stato PERMISSION_DENIED in risposta alla chiamata API, verifica se il account di servizio utilizzato per effettuare la chiamata API dispone di privilegi sufficienti per accedere agli oggetti e alle risorse di destinazione. Verifica inoltre che le credenziali siano corrette e non scadute.

Errore: 404 NOT_FOUND

Se ricevi un codice di errore 404 con uno stato NOT_FOUND in risposta alla chiamata API, verifica che i nomi e il percorso delle risorse specificati nella chiamata API siano validi. Consulta l'API GDC Hardware Management per verificare che l'URL della richiesta sia strutturato correttamente e che tutti i campi inclusi nell'URL siano validi.

Monitorare lo stato dell'ordine

Puoi monitorare lo stato del tuo ordine nella console Google Cloud nella pagina Ordini. La tabella seguente elenca i possibili stati e il relativo significato.

Stato UI	Significato
Bozza	L'ordine viene salvato come bozza.
In revisione	L'ordine è stato inviato ed è in fase di revisione da parte di Google.
Accettato	Google ha accettato l'ordine per l'evasione.
Building Hardware	L'hardware viene creato e sottoposto a provisioning presso Google o presso la struttura del partner.
Spedizione dell'hardware	L'hardware viene spedito all'indirizzo del sito fornito.
Installazione in corso…	L'hardware viene installato all'indirizzo della sede fornito.
In corso	L'ordine è parzialmente completato. Ad esempio, alcuni componenti hardware sono stati consegnati e installati.
Completato	L'ordine è stato completato.
Informazioni mancanti	Abbiamo bisogno di ulteriori informazioni da parte tua.
Azione richiesta	È necessario un intervento immediato a causa di un problema di base critico.
Annullato	L'ordine è stato rifiutato.

Passaggi successivi

• Eseguire il deployment dei carichi di lavoro su Google Distributed Cloud connesso