Esegui il deployment di un'app Kubernetes con Cloud Code for VS Code

Esegui il deployment di un'app Kubernetes con Cloud Code for VS Code

Questa pagina mostra come iniziare rapidamente a utilizzare Cloud Code.

Configura una nuova applicazione Kubernetes utilizzando un'applicazione di esempio "Hello World", crea un cluster, esegui la tua app su questo cluster, sottoponi a debug il codice in esecuzione, visualizza i log dell'applicazione live e connetti un terminale al container in esecuzione.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Google Kubernetes Engine API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Google Kubernetes Engine API.

   Enable the API

8. Installa Git. Git è necessario per copiare gli esempi sulla tua macchina.
9. Se non l'hai ancora fatto, installa il plug-in Cloud Code.

Creazione di un'applicazione

1. Apri la tavolozza dei comandi (premi Ctrl/Cmd+Shift+P o fai clic su Visualizza > Tavolozza dei comandi), quindi esegui Cloud Code: New Application.

2. Scegli Applicazione Kubernetes.

3. Scegli un'app Hello World nella lingua che preferisci.

   Ad esempio, se scegli Node.js: Hello World crei un'app Hello World Node.js.

4. Salva la nuova applicazione.

   Una notifica conferma che l'applicazione è stata creata e si apre una nuova finestra con l'applicazione.

crea un cluster GKE

Per creare un cluster Google Kubernetes Engine (GKE) standard, segui questi passaggi:

1. Fai clic su Cloud Code ed espandi la sezione Kubernetes.

2. Fai clic su add Aggiungi un cluster a KubeConfig, quindi fai clic su Google Kubernetes Engine nel menu Scelta rapida.

3. Quando ti viene chiesto di attivare container.googleapis.com, seleziona Sì.

4. Fai clic su + Crea un nuovo cluster GKE.

5. Scegli Standard come tipo di cluster.

6. Fai clic su Apri per consentire a Cloud Code di aprire la console Google Cloud.

7. Nella console Google Cloud, utilizza il progetto creato, imposta la zona su us-central1-a e imposta il nome del cluster su my-first-cluster.

8. Fai clic su Crea. La creazione del cluster richiede alcuni minuti.

9. Dopo aver creato il cluster, fai clic su Aggiorna Aggiorna nel menu Scelta rapida.

10. 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 per essere il contesto attivo.

Esegui e visualizza l'app

Ora che la configurazione è completata, puoi eseguire la tua applicazione e visualizzarla in tempo reale. Cloud Code controlla la presenza di eventuali modifiche al tuo file system in modo che tu possa modificare ed eseguire nuovamente l'app quasi in tempo reale.

Per eseguire l'applicazione, procedi nel seguente modo:

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

   

2. Nel menu Selezione rapida visualizzato, seleziona Esegui su Kubernetes.

3. Conferma se utilizzare il contesto attuale del cluster o passare a un altro.

4. Se richiesto, scegli un registro di immagini in cui eseguire il push delle immagini. Se stai creando un nuovo registro di immagini utilizzando gcr.io/PROJECT_ID, assicurati che il registro delle immagini si trovi nello stesso progetto del tuo cluster.

   Viene visualizzata una finestra di output in cui puoi monitorare l'avanzamento dell'applicazione in esecuzione. Vedrai anche un live streaming dei log dei pod in esecuzione nell'output del terminale.

5. Quando l'applicazione è in esecuzione su Kubernetes, la finestra di output mostra un indirizzo IP. Per utilizzare questo indirizzo IP collegato per accedere alla tua applicazione, premi Ctrl/Cmd e fai clic sull'indirizzo.

Suggerimenti per la risoluzione dei problemi

Se utilizzi un cluster preesistente, segui questi passaggi per impostarlo come attivo e recuperare le credenziali del cluster:

1. Fai clic su Cloud Code ed espandi la sezione Kubernetes.

2. Fai clic con il tasto destro del mouse sul nome del cluster, quindi fai clic su Imposta come cluster attivo.

Debug dell'app

Per eseguire il debug della tua applicazione:

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

   

2. Nel menu Selezione rapida visualizzato, seleziona Debug su Kubernetes.

3. Se richiesto, autentica le credenziali per eseguire ed eseguire il debug di un'applicazione in locale.

4. Se richiesto, conferma se utilizzare il contesto attuale del cluster o passa a uno preferito.

   Cloud Code utilizza le configurazioni cloudcode.kubernetes nel file .vscode/launch.json per eseguire l'applicazione e collegarvi una sessione di debug.

   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 sfogliare la tua applicazione attiva.

5. Prima di collegare la sessione del debugger, ti viene chiesto di confermare o di inserire la directory nel contenitore remoto in cui è stato trovato il programma di debug o di premere ESC per saltare il debug del contenitore.

6. 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 più preciso dei punti di interruzione, puoi utilizzare la sezione Punti di interruzione nella vista Debug di VS Code.

   

   Quando invii una nuova richiesta alla tua applicazione, il debugger si mette in pausa al primo punto di interruzione attivo.

   Nel seguente esempio, in Locale nella sezione Variabili, tieni presente che il valore di res._contentLength; per Hello, world! è 13.

   

7. Modifica la stringa da inviare all'interno n. 8 a Hello, goodbye!, quindi riavvia l'azione Debug su Kubernetes.

   Dopo aver ricreato e rieseguito il deployment dell'app, prendi nota del valore aggiornato di res._contentLength.

   

Una volta avviata la sessione di debug, nel riquadro Sessioni di sviluppo viene visualizzata la visualizzazione del logging strutturato. Quando un'attività inizia, viene visualizzata con un semicerchio rotante progress_activity.

Se l'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 mostra il passaggio nell'output di logging.

Apri un terminale nel container

Per aprire un terminale nel contenitore, segui queste istruzioni:

1. Fai clic su Cloud Code ed espandi la sezione Kubernetes.

2. Espandi le seguenti sezioni:

   • La sezione del tuo cluster preferito
   • La sezione Spazi dei nomi e la sezione del tuo spazio dei nomi preferito
   • La sezione Pod e poi la sezione del pod preferito

   • La sezione Container

     

3. Fai clic con il pulsante destro del mouse sul container in cui vuoi aprire un terminale, 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 l'interruzione dell'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 per altre risorse utilizzate in questa guida rapida, assicurati di eliminare il progetto o il cluster che hai creato se vuoi riutilizzare il progetto.

Per eliminare il cluster:

1. Fai clic su Cloud Code ed espandi Kubernetes Explorer.
2. Tieni il puntatore sul nome del cluster e fai clic su open_in_new Apri nella console Google Cloud.
3. Fai clic su Elimina e quindi su Elimina.

Per eliminare il progetto (e le risorse associate, inclusi i cluster):

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività descritte in questo documento, quando lo elimini elimini anche tutto il lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un appspot.com URL, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, il riuso dei progetti può aiutarti a non superare i limiti di quota.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi

• Valuta la possibilità di importare un'applicazione esistente in VS Code e di prepararti a utilizzare 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 i linguaggi fornito da Cloud Code.
• Velocizza lo sviluppo con la sincronizzazione dei file e il ricaricamento a caldo.
• Crea e configura un cluster GKE
• Configura i cluster privati
• Personalizza la tua esperienza con Cloud Code configurando le impostazioni pertinenti.
• Esegui il deployment delle tue applicazioni in cluster GKE ARM64, AMD64 o con architettura mista.