Esegui il deployment di un'app Kubernetes utilizzando lo sviluppo in 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 nel tuo spazio di lavoro di sviluppo remoto con un clic, creerai un cluster, eseguirai un'app Kubernetes su questo cluster, eseguirai il debug del codice in esecuzione, visualizzerai i log dell'applicazione live e connetterai 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 utilizzi in questa guida rapida, all'interno di VS Code, completa i seguenti passaggi:

  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.

    Go to project selector

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

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

    Go to project selector

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

  6. Installa Visual Studio Code sul tuo computer, se non l'hai ancora fatto.
  7. Installa l'estensione Remote - SSH di Visual Studio Code.
  8. Installa Git. Git è necessario per copiare gli esempi sul tuo computer.
  9. Installa il plug-in Cloud Code se non l'hai ancora fatto.

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.

  1. Per iniziare a lavorare nel tuo ambiente di sviluppo remoto, scegli la lingua che preferisci per il progetto clonato e poi fai clic sul pulsante Apri con Cloud Code:

    VS Code viene avviato e clona un progetto nell'area di lavoro di sviluppo remoto.

  2. Se non hai ancora configurato i prerequisiti, ti viene chiesto di installarli.

Crea un cluster GKE

Per creare un cluster Google Kubernetes Engine (GKE) Standard:

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

  2. Fai clic su Aggiungi Aggiungi un cluster a KubeConfig e poi su Google Kubernetes Engine nel menu Scelta rapida.

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

  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 consoleGoogle Cloud .

  7. Nella console Google Cloud , utilizza il progetto che hai 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, nel menu Selezione rapida, fai clic su Aggiorna Aggiorna.

  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 come contesto attivo.

Esegui e visualizza l'app

Ora che hai completato la configurazione, puoi eseguire l'applicazione e visualizzarla in tempo reale. Cloud Code monitora il file system per rilevare le modifiche in modo da poter modificare ed eseguire nuovamente l'app in tempo quasi reale.

Per eseguire l'applicazione, segui questi passaggi:

  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 di selezione rapida visualizzato, seleziona Esegui su Kubernetes.

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

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

    Viene visualizzata una finestra di output in cui puoi monitorare lo stato di avanzamento dell'applicazione in esecuzione. Nell'output del terminale vedrai anche un live streaming dei log dei pod in esecuzione.

  5. Una volta che 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, per impostarlo come attivo e ottenere le credenziali del cluster, segui questi passaggi:

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

  2. Fai clic con il tasto destro del mouse sul nome del cluster e poi su Imposta come cluster attivo.

Debug dell'app

Per eseguire il debug dell'applicazione, segui questi passaggi:

  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 Selezione rapida visualizzato, seleziona Debug su Kubernetes.

  3. Se richiesto, autentica le tue credenziali per eseguire e debuggare un'applicazione localmente.

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

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

    Cloud Code crea i container, li invia al registro, applica le configurazioni Kubernetes al cluster e restituisce l'indirizzo IP che puoi utilizzare per sfogliare l'applicazione live.

  5. Prima che la sessione di debug venga collegata, ti viene chiesto di confermare o inserire la directory nel container remoto in cui si trova il programma di cui eseguire il debug o premere ESC per saltare il debug del container.

  6. Per aggiungere un punto di interruzione alla riga 9, apri src/app.js e poi fai clic nel margine dell'editor.

    I cerchi rossi pieni indicano i punti di interruzione attivi, mentre i cerchi grigi vuoti indicano i punti di interruzione disattivati. Per un controllo più preciso dei punti di interruzione, puoi utilizzare la sezione Punti di interruzione nella visualizzazione Debug di VS Code.

    Sezione Punti di interruzione nel riquadro a sinistra della visualizzazione di debug che consente di aggiungere, rimuovere e disattivare i punti di interruzione

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

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

    L'app è in pausa in corrispondenza del punto di interruzione e le sezioni delle variabili e dello stack di chiamate sono compilate con i valori nell'ambito

  7. Modifica la stringa inviata in linea n. 8 in Hello, goodbye! e poi riavvia l'azione Debug su Kubernetes.

    Dopo aver ricompilato e ridistribuito l'app, prendi nota del valore aggiornato di res._contentLength.

    App in pausa al punto di interruzione con valori aggiornati

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

Se un'attività va a buon fine, 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:

    • Sezione del cluster preferito
    • La sezione Spazi dei nomi e poi la sezione dello spazio dei nomi che preferisci
    • La sezione Podcast e poi la sezione del podcast che preferisci
    • La sezione Container

      Pod Cloud Code

  3. Fai clic con il tasto destro del mouse sul contenitore 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 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 Explorer di Kubernetes.
  2. Tieni il puntatore sopra il nome del cluster e poi 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 eventuali cluster):

  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