Utilizza gcloud CLI

La CLI gdcloud è un insieme di strumenti per creare e gestire le risorse Google Distributed Cloud (GDC) con air gap. Utilizza questi strumenti per eseguire attività comuni dalla riga di comando o tramite script e automazione. L'interfaccia a riga di comando gdcloud consente di eseguire il bootstrap dell'infrastruttura, gestire l'autenticazione e personalizzare le configurazioni locali.

Questo documento è rivolto a tutti i gruppi di pubblico che devono configurare l'interfaccia a riga di comando dedicata di GDC per gestire i flussi di lavoro hardware e software con air gap. Per saperne di più, consulta Pubblico per la documentazione di GDC con air gap.

Prima di iniziare

  • Assicurati di avere accesso alla console GDC e prendi nota dell'URL della tua organizzazione. Per saperne di più, consulta Accesso alla console GDC.

  • Assicurati di avere un certificato dell'autorità di certificazione (CA) installato nell'archivio dei certificati attendibili del tuo sistema. Per saperne di più, consulta Recuperare i bundle di attendibilità di GDC.

  • Verifica di avere un criterio di rete dell'organizzazione che consenta il traffico da un CIDR specifico al di fuori della tua organizzazione al registro degli artefatti. Ad esempio, configura il nome del servizio all nella risorsa OrganizationNetworkPolicy. Per saperne di più, consulta Creare criteri di rete dell'organizzazione.

  • Assicurati di avere un browser installato sul tuo dispositivo.

Configurare la CLI gdcloud

Per configurare la CLI gdcloud, completa quanto segue:

  1. Apri la console GDC inserendo l'URL globale o zonale della tua organizzazione nel browser.

  2. Nella home page, seleziona Scarica bundle CLI.

  3. Seleziona la piattaforma Linux e la versione del bundle della CLI gdcloud corrispondente al tuo ambiente GDC.

    Quando scegli piattaforme non Linux, i passaggi di configurazione potrebbero variare leggermente. Tieni presente che alcuni bundle dell'interfaccia a riga di comando gdcloud non Linux forniscono solo un sottoinsieme di comandi gdcloud. Per saperne di più, consulta Bundle della CLI gdcloud disponibili.

  4. Fai clic su Scarica.

  5. Dal tuo dispositivo, vai alla cartella Downloads:

    cd ~/Downloads

  6. Estrai i contenuti del bundle della CLI gdcloud:

    tar -xf ./gdcloud_cli.tar.gz

  7. Aggiungi il bundle della CLI gdcloud al tuo percorso:

    eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  8. Verifica che la CLI gdcloud sia installata correttamente:

    gdcloud version

    L'output è simile al seguente:

    gdcloud version: 1.15.0-gdch.380608

  9. Inizializza la CLI gdcloud:

    gdcloud init

  10. Fornisci le due proprietà richieste per completare l'inizializzazione:

    • organization_console_url: l'URL della console dell'organizzazione GDC corrente. Questo URL può essere globale o zonale. Ad esempio, https://console.org-1.google.gdch.test/.

    • project: il nome del tuo progetto GDC. Se non hai un progetto esistente, utilizza default.

    Per aggiornare le configurazioni della CLI gdcloud dopo l'inizializzazione, consulta Gestire le configurazioni della CLI gdcloud.

  11. Installa il componente gdcloud-k8s-auth-plugin:

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Esegui l'autenticazione con la CLI gdcloud per accedere:

    gdcloud auth login

    Viene visualizzato il browser per scegliere la tua identità ed effettuare l'accesso.

  13. Verifica che la configurazione della CLI gdcloud sia connessa al tuo ambiente GDC:

    gdcloud compute images list

    L'output è simile al seguente:

    METADATA.NAME               METADATA.NAMESPACE SPEC.OPERATINGSYSTEM.NAME SPEC.MINIMUMDISKSIZE
rocky-8-v20250809-gdch      vm-system          rocky-linux-8             12G
ubuntu-20.04-v20250809-gdch vm-system          ubuntu-2004               12G
ubuntu-22.04-v20250809-gdch vm-system          ubuntu-2204               12G
ubuntu-24.04-v20250809-gdch vm-system          ubuntu-2404               12G

Passaggi successivi