Questa pagina mostra come inizializzare la gcloud CLI.
Dopo aver installato gcloud CLI, esegui le attività di configurazione iniziale con gcloud init
. Puoi anche eseguire gcloud init
per modificare le impostazioni o creare una nuova configurazione.
gcloud init
esegue i seguenti passaggi di configurazione:
- Autorizza l'gcloud CLI a utilizzare le credenziali del tuo account utente per accedere a Google Cloud oppure ti consente di selezionare un account se hai autorizzato in precedenza l'accesso
- Configura una configurazione gcloud CLI e imposta un insieme di base di proprietà, tra cui l'account attivo del passaggio precedente, il progetto corrente e, se applicabile, la regione e la zona Compute Engine predefinite
In alternativa a gcloud init
, puoi eseguire quanto segue:
Comando | Descrizione |
---|---|
gcloud auth login
|
Autorizza con un account utente senza configurare una configurazione. |
gcloud auth activate-service-account
|
Esegui l'autorizzazione con un account di servizio anziché con un account utente. È utile per autorizzare in modo non interattivo e senza un browser web. |
gcloud config [COMMAND]
gcloud config configurations [COMMAND]
|
Crea e gestisci configurazioni e proprietà gcloud CLI. |
Inizializza la gcloud CLI
Per inizializzare la gcloud CLI:
Esegui
gcloud init
:gcloud init
Se sei in una sessione del terminale remoto, puoi utilizzare il flag
--no-launch-browser
per impedire al comando di avviare un flusso di autorizzazione basato su browser, se necessario:gcloud init --no-launch-browser
Crea o seleziona una configurazione, se richiesto.
Se stai inizializzando una nuova installazione gcloud CLI,
gcloud init
crea una configurazione denominatadefault
e la imposta come configurazione attiva. Se hai configurazioni esistenti,gcloud init
ti chiede di scegliere tra tre opzioni: reinizializzare quella attiva, passare a un'altra e reinizializzarla o crearne una nuova.Completa il passaggio di autorizzazione quando richiesto.
A seconda che tu abbia autorizzato in precedenza l'accesso a Google Cloud, ti potrebbe essere chiesto di accedere e concedere l'accesso in un browser web o di selezionare un account esistente.
Se hai utilizzato il flag
--no-launch-browser
e l'accesso è obbligatorio, devi copiare e incollare l'URL di autorizzazione fornito in un'altra finestra del browser e seguire le istruzioni fornite.Al termine di questo passaggio,
gcloud init
imposta la proprietàaccount
nella configurazione sull'account specificato.Se richiesto, scegli un progetto Google Cloud corrente.
Se hai accesso a un solo progetto, incluso il progetto predefinito per il tuo account utente,
gcloud init
lo seleziona per te.In caso contrario, puoi selezionare un progetto da un elenco di progetti per i quali disponi delle autorizzazioni Proprietario, Editor o Visualizzatore.
gcloud init
imposta la proprietàproject
nella configurazione sulla proprietà che scegli. Se hai accesso a più di 200 progetti, ti verrà chiesto di inserire un ID progetto, creare un nuovo progetto o elencare i progetti.This account has a lot of projects! Listing them all can take a while. [1] Enter a project ID [2] Create a new project [3] List projects Please enter your numeric choice:
Scegli una zona Compute Engine predefinita, se richiesto.
Se non hai attivato l'API Compute Engine o hai già una zona predefinita nei metadati a livello di progetto, questo passaggio non verrà visualizzato.
gcloud init
imposta le proprietàregion
ezone
nella configurazione utilizzando la zona scelta.
Per visualizzare le proprietà impostate tramite il comando gcloud init
, utilizza il comando
gcloud config list
.
[compute] region = us-east1 zone = us-east1-b [core] account = dana@example.com disable_usage_reporting = False project = example-project
Passaggi successivi
- Per scoprire di più sull'autorizzazione dello strumento, consulta Autorizzazione di gcloud CLI.
- Per scoprire di più sull'autorizzazione Credenziali predefinite dell'applicazione (ADC) per le librerie client Cloud (e le librerie client delle API di Google), consulta Come fornire le credenziali per le ADC.
- Per scoprire di più sulla gestione delle configurazioni, consulta Configurazioni dell'interfaccia a riga di comando gcloud.
- Per scoprire di più sulla gestione delle proprietà, consulta Proprietà gcloud CLI.