Installa l'estensione Cloud Code for VS Code

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

Prima di iniziare

Prima di installare Cloud Code, verifica che i seguenti strumenti siano installati e configurati nel 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: lingue:

  3. Installa Git. Git è necessario per copiare i campioni nella tua macchina.

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

    • Se crei esclusivamente con Cloud Build o Jib, puoi senza installare Docker.
    • Se utilizzi Windows Home, per conoscere la procedura di configurazione del client Docker, vedi Guida di Docker Desktop per Windows Home.
    • Se utilizzi WSL ma non riesci a installare Docker per desktop, usa per lo sviluppo locale con Cloud Code.

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

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

Installa Cloud Code

Installa l'estensione Google Cloud Code da Visual Studio Code Marketplace.

In alternativa, apri la vista 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 VSC

  3. Fai clic su Installa.

  4. Se richiesto, riavvia VS Code.

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

Versioni personalizzate delle dipendenze

Per impostazione predefinita, le dipendenze automatiche sono attivate per Cloud Code installa automaticamente alcune dipendenze della riga di comando. Se disattivi le dipendenze automatiche, puoi usare le versioni perché Cloud Code funzioni correttamente, devi installare personalmente le dipendenze.

Per utilizzare le versioni personalizzate delle dipendenze di Cloud Code:

  1. Fai clic su Impostazioni. Gestisci > Impostazioni, quindi imposta le Dipendenze automatiche. (cloudcode.autoDependencies) a off.

  2. Installa le seguenti dipendenze su PATH:

Installa Google Cloud CLI

La prima volta che utilizzi una funzionalità che richiede gcloud CLI, data la possibilità di imparare a installare l'interfaccia a riga di comando dal tuo IDE, utilizza una o continuare con le dipendenze gestite. Se preferisci installare gcloud CLI manualmente, vedere Installa gcloud CLI.

(Facoltativo) Verifica Cloud Code rispetto a VsixSignTool

Per verificare Cloud Code e VsixSignTool, esegui la seguenti 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, in Risorse delle estensioni, fai clic su Marketplace.

  5. Nella pagina Marketplace del tuo browser, in Risorse, fai clic su Scarica l'estensione per scaricare la versione in pacchetto di Cloud Code. Viene scaricata la versione in pacchetto Cloud Code, che ha un'estensione del file .vsix, per impostazione predefinita directory di download.

  6. Se preferisci verificare una versione diversa dalla più recente, fai clic sul Cronologia delle versioni e seleziona una versione diversa da scaricare.

  7. Al termine del download, apri una finestra del terminale ed esegui questo comando:

    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.

Autentica le credenziali per Google Cloud

Per aiutarti nello sviluppo di applicazioni con le API Google Cloud, quando accedi a gcloud CLI, Credenziali predefinite dell'applicazione vengono aggiornate.

Accedi a Google Cloud

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

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

  2. Se è la prima volta che ti connetti a Google Cloud nel tuo IDE, ti viene chiesto di aggiungere https://accounts.google.com al dominio attendibile. Clic 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 richiesto di consentire a Cloud Code di accedere ai tuoi dati Google Account, fai clic su Consenti.

Problema noto: il browser perimetrale reindirizza a HTTPS al momento del callback di autenticazione

Quando utilizzi il browser Microsoft Edge per autenticare le tue credenziali, puoi noterai che il browser Edge reindirizza l'URL http://localhost:3000 a https://localhost:3000. Verrà 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 Elimina i criteri di sicurezza del dominio.

  3. Inserisci localhost, poi fai clic su Elimina.

Esci 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 il riquadro dei comandi. Premi Ctrl/Cmd+Shift+P o fai clic su Visualizza > Tavolozza dei comandi, quindi fai clic su Esci da tutti gli account in Google Cloud SDK.

Modifica il progetto Google Cloud attivo

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

    Nome progetto attivo nella barra di stato

  2. Nel menu di 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 localmente

Oltre ai passaggi di autenticazione nella Accedi a Google Cloud, devi Autenticare le credenziali per eseguire il debug di un'applicazione locale nel tuo IDE che effettua chiamate API di Google.

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

Per autenticare le credenziali per il debug delle applicazioni localmente, esegui la seguenti passaggi:

  1. Installa gcloud sulla tua macchina se non l'hai ancora fatto .

  2. Esegui questo comando:

    gcloud auth application-default login

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

    gcloud auth application-default revoke

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

Passaggi successivi

Richiedi assistenza

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