Per informazioni sulla versione, consulta le note di rilascio di Distributed Cloud connesso.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Ordina hardware

Questa pagina descrive come ordinare l'hardware Google Distributed Cloud connesso. Distributed Cloud connesso è 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 connesso

Puoi ordinare l'hardware Distributed Cloud connesso in uno dei seguenti modi, in base ai requisiti della tua attività:

Hardware di proprietà di Google. Puoi ordinare l'hardware Distributed Cloud connesso direttamente da Google. In questo scenario, Google fornisce, gestisce, ripara e ritira l'hardware Distributed Cloud connesso. Al termine del contratto, Google raccoglie l'hardware Distributed Cloud ed elimina tutti i dati archiviati.
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, l'hardware Distributed Cloud connesso è di tua proprietà. Il SI collabora con te e Google per eseguire il deployment, la riparazione e il ritiro dell'hardware. Al termine del contratto, il SI elimina tutto il software Google e i tuoi dati dall'hardware Distributed Cloud connesso. A questo punto, puoi riutilizzare o smaltire l'hardware. Questo tipo di approvvigionamento è disponibile solo per i server Distributed Cloud connessi.

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 Distributed Cloud connesso nella tua organizzazione.
Contatto per il sito. Una persona responsabile del sito di deployment selezionato. Google contatta questa persona per pianificare e completare la consegna dell'hardware Distributed Cloud connesso. Questa persona coordina anche le riparazioni e il ritiro dell'hardware con Google o un SI certificato da Google.
Contatto per la zona. Una persona responsabile dell'integrazione dell'hardware Distributed Cloud connesso nell'infrastruttura di rete e di alimentazione esistente nel sito di deployment.
Identificatore dell'ordine. Un identificatore significativo per questo ordine di hardware Distributed Cloud connesso.
Identificatore del sito. Un identificatore significativo per il sito di deployment per questo ordine di hardware Distributed Cloud connesso.
Identificatore della zona. Un identificatore significativo per la zona Distributed Cloud connessa di destinazione. Se esegui il deployment di una sola zona per sito, utilizza l'identificatore del sito come identificatore della zona.

Ordinare l'hardware Distributed Cloud connesso utilizzando la Google Cloud console

Nella Google Cloud console, vai alla pagina Ordini.
Vai a Ordini
Seleziona ilprogetto di destinazione Google Cloud .
Fai clic su Crea ordine.
Compila il modulo di richiesta e invialo.

Un Google Cloud rappresentante di vendita esamina l'invio e ti contatta per completare l'ordine. Il rappresentante esegue le seguenti operazioni:

Esamina i requisiti della tua attività per aiutarti a finalizzare la configurazione hardware.
Raccoglie ulteriori informazioni sulla 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.

Ordinare l'hardware connesso a Distributed Cloud utilizzando l'API di gestione hardware GDC

L'API di gestione hardware GDC ti consente di effettuare un ordine di hardware Distributed Cloud a livello di programmazione. Un ordine indica 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 del deployment di Distributed Cloud connesso:

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.

Abilitare l'API di gestione hardware GDC

Prima di poter utilizzare l'API di gestione hardware GDC, devi abilitarla nel progetto di destinazione Google Cloud . A questo scopo, completa i passaggi descritti in questa sezione.

Console

Nella Google Cloud console, vai alla pagina API di gestione hardware GDC.

Abilita l'API
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 di gestione hardware GDC, devi creare una risorsa Order, oltre alle risorse Site, Zone e Hardware associate a cui fa riferimento la risorsa Order. Poi invia la risorsa Order a Google. Queste risorse supportano le operazioni CRUD standard. Il nome di ogni risorsa è un percorso che include l'ID delprogetto di destinazione e la regione. Google Cloud Google Cloud

Queste risorse hanno le seguenti funzioni. Per saperne di più sull'utilizzo dell'API di gestione hardware GDC, consulta il 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, le viene assegnato 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 delprogetto di destinazione Google Cloud .
- 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 dell'ordine non riuscite possono generare ordini duplicati.
Site. Questa risorsa rappresenta la sede fisica in cui vuoi eseguire il deployment dell'hardware Distributed Cloud. Questa risorsa include i dati di contatto di una persona responsabile che coordina l'accesso per la consegna iniziale e la manutenzione futura. Questo contatto potrebbe essere diverso da quello fornito nell'ordine.
Hardware. Questa risorsa crea un'istanza di uno SKU Distributed Cloud connesso 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 ListSkus chiamata API.
Zone. Questa risorsa specifica la configurazione di rete delle macchine Distributed Cloud connesse e dei cluster associati. Una zona Distributed Cloud copre uno o più rack Distributed Cloud connessi o tutte le macchine server Distributed Cloud connesse di cui hai eseguito il deployment nella tua sede.

Quando invii una risorsa Order a Google e il suo stato passa 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 Google Cloud console.

L'API di gestione hardware GDC supporta le seguenti operazioni del ciclo di vita degli ordini:

Creare e inviare un ordine. Puoi creare e inviare immediatamente un ordine oppure crearlo gradualmente e salvarlo nello stato DRAFT finché non è pronto per l'invio. Questo processo è descritto nel resto di questa guida.
Controllare lo stato dell'ordine. Se l'ordine viene inviato con tipo INFO_COMPLETE e hai firmato un contratto con Google, l'ordine passa attraverso la seguente successione di stati: ACCEPTED, BUILDING, SHIPPING, INSTALLING e COMPLETED. Gli stati delle risorse associate Zone e Hardware vengono aggiornati in modo sincrono con la risorsa Order.
Risolvere i problemi relativi agli ordini. Se abbiamo bisogno di ulteriori informazioni da parte tua o non hai firmato un contratto con Google, l'ordine entra nello stato ADDITIONAL_INFO_NEEDED e attende la risoluzione tramite i 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 DELETE chiamata.
Modificare un ordine inviato. Puoi modificare l'ordine , il sito, e la zona inviati utilizzando la rispettiva chiamata PATCH. 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 è > 45 giorni da oggi
  - La nuova requested_installation_date è successiva alla requested_installation_date corrente e estimated_installation_date è vuota
  - La nuova requested_installation_date è successiva alla requested_installation_date corrente e estimated_installation_date è di almeno 7 giorni da oggi
Una volta inviato un ordine, non è possibile modificare altre informazioni, ma tu 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.

Selezionare ilprogetto di destinazione Google Cloud

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

Ti consigliamo di creare un Google Cloud progetto 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 rispetto a core, e di gestire il deployment di Distributed Cloud connesso per il dominio tramite quel Google Cloud progetto.

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

Ordinare l'hardware Distributed Cloud connesso.
Configurare i cluster Distributed Cloud connessi e registrarli in un parco risorse.
Gestire i rollout del software.
Gestire i dati Distributed Cloud connessi in Cloud Storage.
Gestire le credenziali Distributed Cloud connesse in Secret Manager.
Gestire i log e le metriche Distributed Cloud connessi in Cloud Monitoring.

La topologia esatta del Google Cloud progetto dipende dai requisiti della tua attività. Ti consigliamo di evitare le dipendenze tra progetti e di creare e utilizzare sempre le risorse all'interno di ogniprogetto. Google Cloud

L'hardware ordinato all'interno di unprogetto specifico viene sempre gestito in quelprogetto. Google Cloud Google Cloud

Selezionare la regione di destinazione Google Cloud

La scelta specifica Google Cloud regioni per il deployment di Distributed Cloud connesso dipende dai requisiti della tua attività e dalle implicazioni legali delle sedi geografiche di destinazione.

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

Se non stai integrando il deployment di Distributed Cloud connesso con un Google Cloud footprint esistente, ti consigliamo di diversificare la selezione della Google Cloud regione per una maggiore affidabilità. Ad esempio:

Mappa ogni zona Distributed Cloud connessa allaregione supportata più vicina Google Cloud . In questo modo, l'impatto di un errore del piano di gestione è limitato a una singola regione geografica.
Distribuisci Distributed Cloud connesso su più Google Cloud regioni. In questo modo, il numero di zone Distributed Cloud connesse che possono essere interessate da un errore del piano di gestione è limitato; 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

Configurare l'ambiente

Prima di iniziare, completa i seguenti prerequisiti:

Configura un ambiente di sviluppo Python.
Installa la libreria client dell'API di gestione hardware GDC utilizzando il seguente comando:
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
Abilita l'API di gestione hardware GDC nel progetto di destinazione Google Cloud .

Creare e inviare un ordine di hardware Distributed Cloud connesso utilizzando l'API di gestione hardware GDC

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

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

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

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

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

Crea le risorse Hardware. Devi specificare un valore hardware_id univoco per ogni macchina nel deployment di Distributed Cloud connesso. 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()

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 indica che hai fornito tutte le informazioni richieste nelle risorse Zone e Hardware.INFO_COMPLETE Se mancano valori dei campi, 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 ottenere l'accesso a un ambiente sandbox. Dopo che al tuo progetto o alla tua organizzazione è stato concesso l'accesso, puoi utilizzare uno SKU di test identificabile dal prefisso fake-. Gli ordini di test seguono le 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 lo stato FAILED_PRECONDITION in risposta alla chiamata API, verifica che la richiesta sia valida per l'operazione che stai tentando di completare. 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 lo stato INVALID_ARGUMENT in risposta alla chiamata API, controlla se sono presenti nomi e valori di campi errati che non corrispondono ai tipi previsti o valori mancanti. Potresti ricevere questo errore anche se utilizzi un updateMask in una richiesta PATCH e uno o più campi specificati in 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 lo stato UNAUTHENTICATED in risposta alla chiamata API, controlla la configurazione dell'autenticazione. Per saperne di più, consulta Configura le credenziali predefinite dell'applicazione.

Errore: `403 PERMISSION_DENIED`

Se ricevi un codice di errore 403 con lo 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 anche che le credenziali siano corrette e non scadute.

Errore: `404 NOT_FOUND`

Se ricevi un codice di errore 404 con lo 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 di gestione hardware GDC 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