Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina contiene una panoramica della CLI Distributed Cloud e
istruzioni su come scaricarla e configurarla per l'utilizzo con
GDC Sandbox.
Panoramica della CLI gcloud
gdcloud CLI è un insieme di strumenti per creare e gestire
risorse con air gap di Google Distributed Cloud (GDC).
È disponibile solo per Linux.
Utilizza questi strumenti per eseguire attività comuni dalla
riga di comando o tramite script e automazione. L'interfaccia a riga di comando gdcloud può essere utilizzata per
avviare l'infrastruttura, gestire l'autenticazione e personalizzare le configurazioni locali. Tieni presente che questo è diverso dalla CLI gcloud utilizzata per gestire
Google Cloud.
Questa pagina contiene istruzioni semplificate specifiche per
la sandbox GDC. Per maggiori dettagli su gcloud CLI in generale, inclusi configurazione, upgrade, completamento automatico e accessibilità, consulta la documentazione di GDC air-gapped gdcloud.
Scarica gcloud CLI
Segui queste istruzioni se ti connetti alla sandbox GDC utilizzando
sshuttle. Se ti connetti al gateway della tua istanza tramite desktop remoto,
non è necessario scaricare lo strumento, poiché gdcloud è preinstallato
sulla macchina gateway nel percorso /usr/share/gdcloud.
In una finestra del terminale, estrai il bundle della CLI:
cd~/Downloads
tar-xfgdcloud_cli.tar.gz
Aggiungi l'interfaccia a riga di comando gdcloud al tuo PATH in modo da non dover specificare
la posizione con ogni comando. Il comando seguente presuppone che il bundle CLI sia stato scaricato ed estratto nella directory Downloads dell'utente e che il profilo della shell dell'utente si trovi in ~/.bashrc.
gcloud richiede l'autenticazione per eseguire i comandi. Per utilizzarlo
con GDC Sandbox, inizia scaricando un certificato dall'istanza
di GDC Sandbox.
Recupera il certificato per autorizzare l'accesso. Il seguente comando
scarica il certificato nella cartella /tmp; puoi scegliere
di scaricarlo dove preferisci.
Questo comando apre una finestra del browser nel portale OIDC. Seleziona
fake OIDC Provider e Platform Admin di nuovo (o l'utente che
vuoi utilizzare per lo sviluppo, assicurati di concedere l'accesso corretto al
ruolo).
Ripeti questo passaggio di autenticazione, se necessario, quando la sessione scade.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[],[],null,["# Set up the gdcloud CLI\n\nThis page contains an overview of the Distributed Cloud CLI, and\ninstructions on how to download and configure it for usage with\nGDC Sandbox.\n\nOverview of the gdcloud CLI\n---------------------------\n\nThe gdcloud CLI is a set of tools to create and manage\nGoogle Distributed Cloud (GDC) air-gapped resources.\nIt is available for Linux only.\nUse these tools to perform common tasks from the\ncommand line or through scripts and automation. The `gdcloud` CLI can be used to\nbootstrap infrastructure, manage authentication, and customize local\nconfigurations. Note that this is distinct from the `gcloud` CLI used to manage\nGoogle Cloud.\n\nThis page contains simplified instructions that are specific to\nGDC Sandbox. For more detail on the gdcloud CLI in general, including\nconfiguration, upgrade, autocomplete, and accessibility, see the\n[GDC air-gapped `gdcloud` documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-overview).\n\nDownload the gdcloud CLI\n------------------------\n\nFollow these instructions if you are connecting to the GDC Sandbox using\n`sshuttle`. If you are connecting to your instance's gateway over remote desktop,\nthere is no need to download the tool, as `gdcloud` is pre-installed on the\ngateway machine at the path `/usr/share/gdcloud`.\n\n1. Download the gdcloud CLI bundle from the GDC console.\n 1. Navigate to your GDC console as described in [Connect to your instance](/distributed-cloud/sandbox/latest/connect).\n 2. Navigate to the **Connect with CLI** section.\n 3. Click **Download CLI Bundle**.\n2. In a terminal window, extract the CLI bundle:\n\n cd ~/Downloads\n tar -xf gdcloud_cli.tar.gz\n\n3. Add the `gdcloud` CLI to your PATH so that you don't have to specify\n the location with every command. The following command assumes the CLI\n bundle was downloaded and extracted to the user's `Downloads` directory, and\n that the user's shell profile lives in `~/.bashrc`.\n\n echo 'export PATH=$PATH:~/Downloads/google-distributed-cloud-hosted-cli/bin' \u003e\u003e ~/.bashrc\n source ~/.bashrc\n\n4. Open a new terminal and run `gdcloud version` to confirm the command\n worked.\n\n5. Install the `auth` plugin. This plugin is required for using the kubeconfigs generated through the CLI.\n\n gdcloud components install gdcloud-k8s-auth-plugin\n\nConfigure gdcloud\n-----------------\n\n1. Configure the CLI by setting the organization URL to the URL of the\n GDC console.\n\n gdcloud config set core/organization_console_url https://console.org-1.zone1.google.gdch.test\n\n### Download the certificate\n\nThe gdcloud requires authentication in order to perform commands. To use it\nwith GDC Sandbox, start by downloading a certificate from the\nGDC Sandbox instance.\n\n1. Retrieve the certificate to authorize sign in. The following command\n downloads the certificate to the `/tmp` folder; you can choose\n to download it wherever you prefer.\n\n echo -n | \\\n openssl s_client -showcerts -connect console.org-1.zone1.google.gdch.test:443 | \\\n sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' \u003e /tmp/org-1-web-tls-ca.cert\n\nAuthenticate with gdcloud\n-------------------------\n\n1. Sign in to the gdcloud CLI, using the downloaded certificate. The\n following example assumes that the cert was downloaded into the\n `/tmp` folder.\n\n gdcloud auth login --login-config-cert=/tmp/org-1-web-tls-ca.cert\n\n This command opens a browser window to the OIDC portal. Select\n **fake OIDC Provider** , and **Platform Admin** again (or whatever user you\n want to use for development, make sure you give the right access to the\n role).\n\n Repeat this authentication step as needed, when the session times out."]]
