Configura un ambiente di sviluppo locale

Scopri come configurare un ambiente di sviluppo locale per Google Cloud. Questo documento illustra gli strumenti principali necessari per creare, testare ed eseguire applicazioni con i servizi Google Cloud :

  • gcloud CLI: gestisci le risorse cloud, configura i progetti e imposta le Credenziali predefinite dell'applicazione (ADC) locali.
  • Librerie client di Cloud: accedi alle API Google Cloud in modo programmatico utilizzando librerie idiomatiche nel tuo linguaggio di programmazione preferito.

Questo documento mostra anche come installare il plug-in google-cloud-developer per ricevere assistenza con le attività Google Cloud e la codifica in diversi agenti.

Per una panoramica di altri strumenti e interfacce in Google Cloud, consulta Modalità di interazione con Google Cloud.

Prima di iniziare

Chiedi all'amministratore della tua organizzazione di completare i seguenti prerequisiti:

  • Provisiona l'identità utente: assegna un account Cloud Identity o Google Workspace.
  • Concedi l'accesso al progetto e i ruoli IAM: assegna i ruoli Identity and Access Management (IAM) richiesti per il tuo progetto.
  • Abilita la fatturazione Cloud: verifica che la fatturazione Cloud sia abilitata per il tuo progetto.

Per la configurazione a livello di organizzazione, consulta il Google Cloud flusso guidato di configurazione.

Configurare gcloud CLI e l'autenticazione

Configura gcloud CLI (gcloud) per gestire le risorse e autenticare il tuo ambiente locale:

  1. Installa gcloud CLI sulla tua workstation locale.
  2. Esegui gcloud init nel terminale per accedere e selezionare il progetto predefinito.
  3. Esegui gcloud auth application-default login per configurare le Credenziali predefinite dell'applicazione (ADC). Le credenziali predefinite dell'applicazione consentono alle librerie client locali di autenticarsi automaticamente rispetto al tuo progetto.

Installare le librerie client Cloud

Per accedere ai servizi Google Cloud in modo programmatico dal codice dell'applicazione:

  1. Abilita le API Cloud richieste per il tuo progetto.
  2. Installa le librerie client di Cloud per il tuo linguaggio di programmazione (ad esempio Java, Python o Go). Il codice viene autenticato automaticamente utilizzando ADC.

Installare il plug-in google-cloud-developer

Se utilizzi un agente come Claude Code, Antigravity CLI o Codex CLI per ricevere assistenza nel tuo lavoro di sviluppo, puoi installare il plug-in google-cloud-developer per ricevere aiuto con le attività Google Cloud e la programmazione. Questo plug-in include:

  • Competenze per aiutarti con la creazione dell'account, la configurazione della fatturazione, la gestione dei progetti e l'autenticazione per i servizi e le API di Google Cloud .
  • La skill finding-google-skills, che individua ed esegue la skill del prodotto Google giusta su richiesta, evitando così la necessità di precaricare le skill di Google.
  • Il server MCP remoto Developer Knowledge, che consente di cercare la documentazione ufficiale per gli sviluppatori di Google e recuperare informazioni per i prodotti Google come Google Cloud, Firebase, Android, Maps e altri ancora.

Installa il plug-in google-cloud-developer seguendo le istruzioni riportate di seguito in base al tuo agente.

Antigravity CLI

  1. Installa il plug-in specificandone la posizione nel repository Google Agent Skills:

    agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer

  2. Abilita l'API Developer Knowledge nel tuo progetto Google Cloud utilizzando gcloud CLI:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

Claude Code

  1. Aggiungi il marketplace dei plug-in Google e poi installa il plug-in:

    claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

  2. Abilita l'API Developer Knowledge nel tuo progetto Google Cloud utilizzando gcloud CLI:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. Crea una chiave API per l'API Developer Knowledge seguendo le istruzioni Crea e proteggi la chiave API. Salva la chiave che crei in una posizione sicura.

  4. Abilita l'accesso autenticato al server MCP per Developer Knowledge utilizzando la chiave API creata nel passaggio precedente:

    claude mcp add google-dev-knowledge \
--scope user \
--transport http https://developerknowledge.googleapis.com/mcp \
--header "X-Goog-Api-Key: YOUR_API_KEY"

Interfaccia a riga di comando Codex

  1. Aggiungi il marketplace dei plug-in Google e poi installa il plug-in:

    codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins

  2. Abilita l'API Developer Knowledge nel tuo progetto Google Cloud utilizzando gcloud CLI:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. Crea una chiave API per l'API Developer Knowledge seguendo le istruzioni Crea e proteggi la chiave API. Salva la chiave che crei in una posizione sicura.

  4. Attiva l'accesso autenticato al server MCP di Developer Knowledge aggiornando ~/.codex/config.toml (o .codex/config.toml del tuo progetto) in modo che includa le seguenti righe:

    [mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

Strumenti e ambienti alternativi

Se il tuo flusso di lavoro richiede ambienti di sviluppo o strumenti di infrastruttura specifici, considera quanto segue:

Passaggi successivi