Esegui il deployment di un'app Kubernetes tramite lo sviluppo remoto

Questa pagina mostra come iniziare rapidamente a utilizzare Cloud Code per VS Code utilizzando un ambiente di sviluppo remoto in Cloud Shell.

In questa guida rapida, potrai saltare la configurazione e clonare un progetto nella tua area di lavoro di sviluppo remota con un semplice clic, creare un cluster, eseguire un'app Kubernetes su questo cluster, eseguire il debug del codice in esecuzione, visualizzare i log dell'applicazione attiva e connettere 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 questi passaggi:

  1. 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.
  2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  5. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  6. Se non l'hai ancora fatto, installa il codice visivo di Studio sulla tua macchina.
  7. Installa l'estensione Remote - SSH di Visual Studio Code.
  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.

Avvio di Cloud Code

Quando apri Visual Studio Code connesso a un ambiente di sviluppo remoto in Cloud Shell, l'ambiente ha tutti gli strumenti necessari per sviluppare applicazioni Kubernetes.

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

    VS Code avvia e clona un progetto nell'area di lavoro di sviluppo remota.

  2. Se non hai già configurato i prerequisiti, ti verrà chiesto di installarli.

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 .

  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.

    Nome del progetto attivo nella barra di stato

  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.

    Nome del progetto attivo nella barra di stato

  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.

    Sezione dei punti di interruzione nel riquadro sinistro della visualizzazione debug che consente di aggiungere, rimuovere e disabilitare i punti di interruzione

    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.

    App in pausa nel punto di interruzione, con variabili e sezioni dello stack di chiamate compilate con valori nell'ambito

  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.

    App messa in pausa in un punto di interruzione con valori aggiornati

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

      Pod Cloud Code

  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):

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi