Installa l'estensione Cloud Code per VS Code

L'estensione Cloud Code for VS Code aggiunge il supporto per lo sviluppo a VS Code. Google Cloud

Prima di iniziare

Prima di installare Cloud Code, verifica che i seguenti strumenti siano installati e configurati sul tuo sistema:

  1. Installa e configura Visual Studio Code sul tuo computer.

  2. Installa e configura il supporto linguistico.

    L'estensione Cloud Code funziona al meglio con i seguenti linguaggi:

  3. Installa Git. Git è necessario per copiare i sample sulla tua macchina.

  4. Installa il client Docker e aggiungilo alla variabile di ambiente PATH:

    • Se esegui la compilazione esclusivamente utilizzando Cloud Build o Jib, puoi saltare l'installazione di Docker.
    • Se utilizzi Windows Home, per la procedura di configurazione del client Docker, consulta la guida di Docker Desktop per Windows Home.
    • Se utilizzi WSL, ma non riesci a installare Docker per desktop, utilizza minikube per lo sviluppo locale con Cloud Code.

  5. Se utilizzi Google Cloud, crea un Google Cloud progetto e poi abilita la fatturazione.

    I progetti ti consentono di raccogliere tutte le risorse correlate per una singola applicazione in un unico posto, gestire le API, attivare i servizi, aggiungere e rimuovere collaboratori e gestire le autorizzazioni per le risorse. Google Cloud Google Cloud

Installa Cloud Code

Installa l'estensione Google Cloud Code dal marketplace di Visual Studio Code.

In alternativa, apri la visualizzazione Estensioni in VS Code:

  1. Fai clic su Icona dell'estensione Estensioni o premi Ctrl/Cmd+Shift+X.

  2. Cerca Google Cloud Code.

    Estensione Cloud Code nel marketplace di VSC

  3. Fai clic su Installa.

  4. Se richiesto, riavvia VS Code.

    Una volta installata l'estensione, l'icona di Cloud Code viene aggiunta alla barra delle attività ed è pronta per l'uso. Puoi configurare ulteriormente l'installazione di Cloud Code specificando le tue preferenze utilizzando la barra delle app di primo livello: vai a Code > Impostazioni > Impostazioni > Estensioni e cerca Gemini Code Assist + Google Cloud Code.

Versioni personalizzate delle dipendenze

Per impostazione predefinita, in Cloud Code è attivata l'opzione Dipendenze automatiche e alcune dipendenze della riga di comando vengono installate automaticamente. Se disattivi le dipendenze automatiche, puoi utilizzare versioni personalizzate delle dipendenze, ma devi installarle autonomamente affinché Cloud Code funzioni.

Per utilizzare versioni personalizzate delle dipendenze di Cloud Code:

  1. Fai clic su Impostazioni Gestisci > Impostazioni e imposta Dipendenze automatiche (cloudcode.autoDependencies) su off.

  2. Installa le seguenti dipendenze su PATH:

Installa Google Cloud CLI

La prima volta che utilizzi una funzionalità che richiede gcloud CLI, hai la possibilità di scoprire come installare l'interfaccia a riga di comando dalla tua IDE, utilizzare un'installazione esistente o continuare con le dipendenze gestite. Se preferisci installare manualmente gcloud CLI, consulta Installare gcloud CLI.

(Facoltativo) Verifica il file vsix di Cloud Code utilizzando VsixSignTool

Per verificare il file vsix di Cloud Code con VsixSignTool, segui questi passaggi:

  1. Assicurati di utilizzare quanto segue:

    • Gestore pacchetti NuGet
    • Sistema operativo Windows
    • Una release di produzione di Cloud Code

  2. Installa Microsoft VsixSignTool e prendi nota del percorso di installazione.

  3. Apri VS Code e vai a Icona Estensioni in VSC Estensioni > Cloud Code.

  4. Nella scheda Dettagli, fai clic su Marketplace in Risorse dell'estensione.

  5. Nella pagina Marketplace del browser, fai clic su Scarica estensione in Risorse per scaricare la versione pacchettizzata di Cloud Code. Verrà scaricata la versione pacchettizzata di Cloud Code, che ha un'estensione file .vsix, nella directory di download predefinita.

  6. Se preferisci verificare una versione diversa dall'ultima, fai clic sulla scheda Cronologia delle versioni e seleziona una versione diversa da scaricare.

  7. Al termine del download, apri una finestra del terminale ed esegui quanto segue:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

  8. Verifica che l'output corrisponda a quanto segue:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Credenziali di autenticazione per Google Cloud

Per facilitare lo sviluppo di applicazioni con le Google Cloud API, quando accedhi a gcloud CLI, le credenziali predefinite dell'applicazione vengono aggiornate.

Accedi a Google Cloud

Se non hai eseguito l'accesso a Google Cloud, segui questi passaggi:

  1. Nella barra di stato di Cloud Code, fai clic su Cloud Code - Accedi.

  2. Se è la prima volta che ti colleghi a Google Cloud nell'IDE, ti verrà chiesto di aggiungere https://accounts.google.com al dominio attendibile. Fai clic su Configura domini attendibili nella finestra di dialogo visualizzata:

    Finestra di dialogo Configura dominio attendibile

  3. Segui le istruzioni per accedere utilizzando il browser web.

  4. Quando ti viene chiesto di consentire a Cloud Code di accedere al tuo Account Google, fai clic su Consenti.

Problema noto: il browser Edge reindirizza a HTTPS al callback di autenticazione

Quando utilizzi il browser Microsoft Edge per autenticare le tue credenziali, potresti notare che il browser Edge reindirizza l'URL http://localhost:3000 a https://localhost:3000. Viene visualizzato il seguente messaggio di errore:

The connection for this site is not secure. localhost sent an invalid response. Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.

Per risolvere il problema, puoi escludere localhost dal reindirizzamento:

  1. Nella barra degli indirizzi del browser Edge, inserisci edge://net-internals/#hsts.

  2. Vai alla sezione Eliminare i criteri di sicurezza del dominio.

  3. Inserisci localhost e fai clic su Elimina.

Uscire da Google Cloud

  1. Fai clic su Cloud Code ed espandi Guida e feedback.
  2. Fai clic su Esci da Google Cloud e, quando richiesto, seleziona Esci.
  3. In alternativa, puoi uscire utilizzando la tavolozza dei comandi. Premi Ctrl/Cmd+Shift+P o fai clic su Visualizza > Tavolozza comandi, quindi fai clic su Uscire da tutti gli account in Google Cloud SDK.

Modificare il progetto Google Cloud attivo

  1. Nella barra di stato di Cloud Code, fai clic sul nome del progetto attivo.

    Nome del progetto attivo nella barra di stato

  2. Nel menu Scelta rapida visualizzato, seleziona sync_alt Cambia progetto.

  3. Seleziona un progetto o inserisci parole chiave nella barra di ricerca per filtrare i progetti.

Autentica le credenziali per eseguire il debug delle applicazioni in locale

Oltre ai passaggi di autenticazione nella sezione Accedi a Google Cloud, dovrai autenticare le tue credenziali per eseguire il debug di un'applicazione localmente nell'IDE che effettua chiamate all'API Google.

Se non autentichi le tue credenziali per il debug delle applicazioni, nell'IDE viene visualizzato un messaggio di errore quando provi a eseguire/eseguire il debug di un'applicazione locale che tenta di effettuare una chiamata a un'API Google.

Per autenticare le tue credenziali per il debug delle applicazioni a livello locale, svolgi i seguenti passaggi:

  1. Se non l'hai ancora fatto, installa gcloud sulla tua macchina.

  2. Esegui questo comando:

    gcloud auth application-default login

  3. Al termine del debug locale, puoi uscire eseguendo il seguente comando:

    gcloud auth application-default revoke

Per scoprire di più sulle credenziali predefinite dell'applicazione e sulle API di Google, consulta Eseguire l'autenticazione nei servizi Cloud utilizzando le librerie client.

Passaggi successivi

Richiedi assistenza

Per inviare feedback, segnala i problemi su GitHub o fai una domanda su Stack Overflow.