Utilizza gcloud CLI

L'interfaccia a riga di comando gdcloud è un insieme di strumenti per creare e gestire 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 gcloud consente di eseguire il bootstrap dell'infrastruttura, gestire l'autenticazione e personalizzare le configurazioni locali.

Questo documento è destinato a tutti i gruppi di pubblico che devono configurare la CLI dedicata di GDC per gestire i flussi di lavoro hardware e software con air gap. Per saperne di più, consulta la documentazione relativa ai segmenti di pubblico per GDC air-gapped.

Prima di iniziare

  • Verifica di avere accesso alla console GDC e annota l'URL della tua organizzazione. Per ulteriori informazioni, vedi Accesso alla console GDC.

  • Verifica di avere un certificato dell'autorità di certificazione (CA) installato nell'archivio dei certificati attendibili del sistema. Per saperne di più, consulta Recuperare i bundle di attendibilità 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 maggiori informazioni, consulta Crea policy di rete dell'organizzazione.

  • Verifica di aver installato un browser sul dispositivo.

Configura gcloud CLI

Per configurare gcloud CLI, completa i seguenti passaggi:

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

  2. Nella home page, seleziona Scarica pacchetto CLI.

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

    Quando scegli piattaforme non Linux, i passaggi di configurazione potrebbero variare leggermente. Tieni inoltre presente che alcuni bundle gcloud CLI non Linux forniscono solo un sottoinsieme di comandi gcloud. Per saperne di più, consulta Pacchetti gcloud CLI disponibili.

  4. Fai clic su Scarica.

  5. Dal dispositivo, vai alla cartella Downloads:

    cd ~/Downloads

  6. Estrai i contenuti del bundle gcloud CLI:

    tar -xf ./gdcloud_cli.tar.gz

  7. Aggiungi il bundle gcloud CLI al 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 gcloud CLI sia installata correttamente:

    gdcloud version

    L'output è simile al seguente:

    gdcloud version: 1.15.0-gdch.380608

  9. Inizializza gcloud CLI:

    gdcloud init

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

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

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

    Per aggiornare le configurazioni di gcloud CLI dopo l'inizializzazione, vedi Gestire le configurazioni di gcloud CLI.

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

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Esegui l'autenticazione con gcloud CLI per accedere:

    gdcloud auth login

    Viene visualizzata la schermata del browser per scegliere la tua identità ed effettuare l'accesso.

  13. Verifica che la configurazione di gcloud CLI 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