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 connesso.

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.

Prerequisiti

Prima di effettuare un ordine, devi avere a portata di mano le seguenti informazioni:

• Contatto per l'ordine. Una persona responsabile della gestione del deployment dell'hardware connesso a Distributed Cloud nella tua organizzazione.

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

• Contatto della zona. Una persona responsabile dell'integrazione dell'hardware connesso a Distributed Cloud nell'infrastruttura di rete e di alimentazione esistente nel sito di deployment.

• Identificatore dell'ordine. Un identificatore significativo per questo ordine di hardware connesso a Distributed Cloud.

• 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.

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.

4. Compila il modulo di richiesta e invialo.

Un rappresentante di vendita esamina la 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.

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 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.

Passaggi successivi

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