Installa l'estensione Cloud Code per VS Code

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

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 sulla tua macchina.

2. Installa e configura il supporto linguistico.

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

   • NodeJS (supporto integrato; nessuna azione richiesta)
   • Go
   • Python
   • Java
   • .NET

3. Installa Git. Git è necessario per copiare gli esempi sul tuo computer.

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

   • Se esegui la build esclusivamente utilizzando Cloud Build o Jib, puoi saltare l'installazione di Docker.
   • Se utilizzi WSL, ma non riesci a installare Docker for Desktop, utilizza minikube per lo sviluppo locale con Cloud Code.

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

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

Installa Cloud Code

Nota: quando installi Cloud Code, viene installata anche l'estensione Gemini Code Assist per impostazione predefinita.

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

In alternativa, apri la visualizzazione Estensioni in VS Code:

1. Fai clic su Estensioni o premi Ctrl/Cmd+Shift+X.

2. Cerca Google Cloud Code.

   

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 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, Cloud Code ha attivato la funzionalità Dipendenze automatiche e installa automaticamente alcune dipendenze della riga di comando. Se disattivi le dipendenze automatiche, puoi utilizzare versioni personalizzate delle dipendenze, ma devi installarle manualmente affinché Cloud Code funzioni.

Per utilizzare versioni personalizzate delle dipendenze di Cloud Code:

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

2. Installa le seguenti dipendenze su PATH:

   • kubectl
   • Skaffold
   • minikube per lo sviluppo locale

Installa Google Cloud CLI

La prima volta che utilizzi una funzionalità che richiede gcloud CLI, ti viene data la possibilità di scoprire come installare la CLI dal tuo IDE, utilizzare un'installazione esistente o continuare con le dipendenze gestite. Se preferisci installare gcloud CLI manualmente, vedi Installa gcloud CLI.

(Facoltativo) Verifica del 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 Estensioni > Cloud Code.

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

5. Nella pagina Marketplace del browser, in Risorse, fai clic su Scarica estensione per scaricare la versione pacchettizzata di Cloud Code. Viene 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 da quella più recente, fai clic sulla scheda Cronologia delle versioni e seleziona una versione diversa da scaricare.

   Nota: la versione più recente di Cloud Code che puoi verificare con VsixSignTool è 1.20.2.

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

   PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
   

8. Conferma che l'output corrisponda al seguente:

   VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Autentica le credenziali per Google Cloud

Per facilitare lo sviluppo di applicazioni con le API Google Cloud , quando accedi a gcloud CLI, le tue 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 connetti a Google Cloud nel tuo IDE, ti viene chiesto di aggiungere https://accounts.google.com a Domini attendibili. Fai clic su Configura domini attendibili nella finestra di dialogo visualizzata:

   

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

4. Quando viene richiesto 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. Questo porta al 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 criteri di sicurezza del dominio.

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

Modificare il Google Cloud progetto

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

   

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.

Autenticare le credenziali per il debug delle applicazioni in locale

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

Se non autentichi le tue credenziali per il debug delle applicazioni, nel tuo IDE viene visualizzato un messaggio di errore quando tenti di 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 in locale, segui questi 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 seguente comando:

   gcloud auth application-default revoke
   

Per saperne di più sulle Credenziali predefinite dell'applicazione e sulle API di Google, consulta Autenticarsi ai servizi cloud utilizzando le librerie client.

Passaggi successivi

• Creare un'applicazione
• Crea e configura un cluster GKE
• Sviluppo di API utilizzando Apigee

Richiedi assistenza

Per inviare feedback, segnala problemi su GitHub, oppure poni una domanda su Stack Overflow.