Esegui il deployment di un'app Kubernetes utilizzando lo sviluppo remoto
Questa pagina mostra come iniziare rapidamente a utilizzare Cloud Code for VS Code utilizzando un ambiente di sviluppo remoto in Cloud Shell.
In questa guida rapida, salterai la configurazione e clonerai un progetto nell'area di lavoro di sviluppo remota con un semplice clic, creerai un cluster, eseguirai un'app Kubernetes su questo cluster, eseguirai il debug del codice in esecuzione, visualizzerai i log dell'applicazione attiva e collegherai un terminale al container in esecuzione.
Prima di iniziare
Per configurare le risorse di supporto e accedere a Cloud Shell, l'ambiente di sviluppo remoto su Google Cloud che usi in questa guida rapida, all'interno di VS Code, completa i seguenti passaggi:
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
- Installa Visual Studio Code sulla tua macchina, se non l'hai ancora fatto.
- Installa l'estensione di Visual Studio Code remote - SSH.
- Installa Git. Git è necessario per copiare i campioni nella tua macchina.
- Se non l'hai ancora fatto, installa il plug-in Cloud Code.
Avvio di Cloud Code
Quando apri Visual Studio Code connesso a un ambiente di sviluppo remoto in Cloud Shell, l'ambiente dispone di tutti gli strumenti necessari per sviluppare applicazioni Kubernetes.
Per iniziare a lavorare nel tuo ambiente di sviluppo remoto, scegli la lingua preferita per il progetto clonato, quindi fai clic sul pulsante Apri con Cloud Code:
Node.js
Java
Python
Go
VS Code avvia e clona un progetto nell'area di lavoro di sviluppo remota.
Se non hai ancora configurato i prerequisiti, ti verrà chiesto di installarli.
crea un cluster GKE
Per creare un cluster Google Kubernetes Engine (GKE) standard, segui questi passaggi:
Fai clic su Cloud Code ed espandi la sezione Kubernetes.
Fai clic su add (Aggiungi un cluster) Add a Cluster to the KubeConfig (Aggiungi un cluster a KubeConfig), quindi fai clic su Google Kubernetes Engine (Google Kubernetes Engine) nel menu Scelta rapida.
Quando ti viene chiesto di attivare
container.googleapis.com
, seleziona Sì.Fai clic su + Crea un nuovo cluster GKE.
Scegli Standard come tipo di cluster.
Fai clic su Apri per consentire a Cloud Code di aprire la console Google Cloud.
Nella console Google Cloud, utilizza il progetto che hai creato, imposta la zona su
us-central1-a
e il nome del cluster sumy-first-cluster
.Fai clic su Crea. La creazione del cluster richiede alcuni minuti.
Una volta creato il cluster, nel menu Scelta rapida, fai clic su Aggiorna Aggiorna.
Quando il nome del nuovo cluster viene visualizzato nell'elenco, fai clic sul nome del cluster. Il nuovo cluster viene aggiunto alla configurazione e configurato in modo da rappresentare il contesto attivo.
Esegui e visualizza l'app
Ora che è tutto pronto, puoi eseguire la tua applicazione e vederla online. Cloud Code monitora le modifiche nel file system, così puoi modificare ed eseguire nuovamente l'app quasi in tempo reale.
Per eseguire l'applicazione, segui questi passaggi:
Nella barra di stato di Cloud Code, fai clic sul nome del progetto attivo.
Nel menu di scelta rapida visualizzato, seleziona Esegui su Kubernetes.
Conferma se utilizzare il contesto attuale del cluster o passare a un altro.
Se richiesto, scegli un registro di immagini a cui eseguire il push. Se stai creando un nuovo registro di immagini utilizzando
gcr.io/PROJECT_ID
, assicurati che il registro di immagini si trovi nello stesso progetto del cluster.Viene visualizzata una finestra di output in cui puoi monitorare l'avanzamento dell'applicazione in esecuzione. Nell'output del terminale vedrai anche un live streaming dei log dei pod in esecuzione.
Quando l'applicazione è in esecuzione su Kubernetes, la finestra di output mostra un indirizzo IP. Per utilizzare questo indirizzo IP collegato per accedere all'applicazione, premi
Ctrl
/Cmd
e fai clic sull'indirizzo.
Suggerimenti per la risoluzione dei problemi
Se utilizzi un cluster preesistente, per impostarlo come attivo e ottenere le credenziali del cluster:
Fai clic su Cloud Code ed espandi la sezione Kubernetes.
Fai clic con il pulsante destro del mouse sul nome del cluster e fai clic su Imposta come cluster attivo.
Debug dell'app
Per eseguire il debug dell'applicazione, segui questi passaggi:
Nella barra di stato di Cloud Code, fai clic sul nome del progetto attivo.
Nel menu di scelta rapida visualizzato, seleziona Debug su Kubernetes.
Se richiesto, autentica le credenziali per eseguire ed eseguire il debug localmente.
Se richiesto, conferma se utilizzare il contesto attuale del cluster o passare a uno dei cluster che preferisci.
Cloud Code utilizza le configurazioni
cloudcode.kubernetes
nel file.vscode/launch.json
per eseguire l'applicazione e collegare una sessione di debugger.Cloud Code crea i tuoi container, ne esegue il push al registro, applica le configurazioni Kubernetes al cluster e restituisce l'indirizzo IP che puoi utilizzare per esplorare la tua applicazione live.
Prima di collegare la sessione di debug, ti viene chiesto di confermare o inserire la directory nel container remoto in cui viene trovato il programma di debug oppure di premere ESC per saltare il debug del container.
Per aggiungere un punto di interruzione alla riga 9, apri
src/app.js
e fai clic sul margine dell'editor.I cerchi pieni rossi indicano i punti di interruzione attivi, mentre i cerchi vuoti grigi indicano i punti di interruzione disattivati. Per un controllo dei punti di interruzione più preciso, puoi usare la sezione Punti di interruzione nella vista Debug di VS Code.
Quando invii una nuova richiesta all'applicazione, il debugger viene messo in pausa in corrispondenza del primo punto di interruzione attivo.
Nel seguente esempio, in Locale nella sezione Variabili, tieni presente che il valore di
res._contentLength;
perHello, world!
è 13.Modifica la stringa da inviare in linea n. 8 in
Hello, goodbye!
, quindi riavvia l'azione Debug su Kubernetes.Dopo aver ricreato e ripetuto il deployment dell'app, prendi nota del valore aggiornato di
res._contentLength
.
Dopo l'avvio della sessione di debug, il riquadro Sessioni di sviluppo mostra la visualizzazione del logging strutturato. Quando un'attività inizia, viene visualizzata con un semicerchio rotante progress_activity.
Se un'attività ha esito positivo, accanto al passaggio viene visualizzato un segno di spunta check_circle.
Per visualizzare i dettagli di un passaggio, fai clic sul passaggio nel riquadro Sessione di sviluppo. Il riquadro Output visualizza il passaggio nell'output di logging.
Apri un terminale nel container
Per aprire un terminale nel container, segui queste istruzioni:
Fai clic su Cloud Code ed espandi la sezione Kubernetes.
Espandi le seguenti sezioni:
- Sezione del cluster che preferisci
- La sezione Spazi dei nomi e poi la sezione dello spazio dei nomi preferito
- La sezione Pod e poi la sezione del pod che preferisci
Sezione Container
Fai clic con il pulsante destro del mouse sul container in cui vuoi aprire un terminale e poi fai clic su Ottieni terminale.
Viene avviato un terminale. Ora hai accesso a una shell all'interno del container in esecuzione.
Esegui la pulizia
Dopo aver arrestato l'applicazione, tutte le risorse Kubernetes di cui è stato eseguito il deployment durante l'esecuzione vengono eliminate automaticamente.
Per evitare che al tuo account vengano addebitati costi relativi ad altre risorse utilizzate in questa guida rapida, assicurati di eliminare il progetto o di eliminare il cluster che hai creato se vuoi riutilizzare il progetto.
Per eliminare il cluster:
- Fai clic su Cloud Code ed espandi Explorer Kubernetes.
- Tieni il puntatore sul nome del cluster e fai clic su open_in_new Apri nella console Google Cloud.
- Fai clic su Elimina e quindi su Elimina.
Per eliminare il progetto (e le risorse associate, inclusi i cluster):
- Nella console Google Cloud, vai alla pagina Gestisci risorse.
- Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
- Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.
Passaggi successivi
- Valuta la possibilità di importare un'applicazione esistente in VS Code e di prepararti a Cloud Code.
- Affronta la configurazione più avanzata di Google Cloud e Kubernetes con il supporto per la modifica YAML di Cloud Code.
- Scopri il supporto di debug specifico per linguaggio offerto da Cloud Code.
- Accelera lo sviluppo con la sincronizzazione dei file e il ricaricamento a caldo.
- Crea e configura un cluster GKE
- Configura cluster privati
- Personalizza la tua esperienza Cloud Code configurando le impostazioni pertinenti.