Esegui il deployment di un'app Kubernetes utilizzando lo sviluppo in 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, eviterai la configurazione e clonerai un progetto nella tua area di lavoro di sviluppo remoto con un solo clic, creerai un cluster, eseguirai un'app Kubernetes su questo cluster, eseguirai il debug del codice in esecuzione, visualizzerai i log della tua applicazione in produzione e collegherai un terminale al contenitore 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. Se non l'hai ancora fatto, installa Visual Studio Code sul tuo computer.
  7. Installa il Remoto - SSH Visual Studio Code.
  8. Installa Git. Git è necessario per copiare i campioni nella 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 dispone di tutti gli strumenti necessari per sviluppare applicazioni Kubernetes.

  1. Per iniziare a lavorare nel tuo spazio di lavoro di sviluppo remoto, scegli il linguaggio preferito per il progetto clonato e poi 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 ancora configurato i prerequisiti, ti viene chiesto di per 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 Kubernetes .

  2. Fai clic su aggiungi. Aggiungi un cluster a KubeConfig e 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 che hai creato, imposta la zona su us-central1-a e 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 Scelta 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 è tutto pronto, puoi eseguire l'applicazione e visualizzarla in tempo reale. Cloud Code controlla 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 Scelta rapida visualizzato, seleziona Esegui su Kubernetes.

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

  4. Se richiesto, scegli un registry delle immagini a cui inviare le immagini. Se stai creando un nuovo registry delle immagini utilizzando gcr.io/PROJECT_ID, assicurati che si trovi nello stesso progetto del tuo cluster.

    Viene visualizzata una finestra di output in cui puoi monitorare lo stato di avanzamento dell'applicazione in esecuzione. Vedrai anche un live streaming dei log dalla di 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 al tuo un'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:

  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 Scelta rapida visualizzato, seleziona Esegui il debug su Kubernetes.

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

  4. Se richiesto, conferma se utilizzare il contesto del cluster corrente 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, ne esegue il push al registry applica le configurazioni Kubernetes al cluster e restituisce l'indirizzo IP che puoi utilizzare per sfogliare la tua applicazione pubblicata.

  5. Prima di collegare la sessione del debugger, ti verrà chiesto di confermare oppure inserisci la directory nel container remoto in cui il programma per eseguire il debug o premi ESC per saltare il debug del container.

  6. Per aggiungere un punto di interruzione alla riga 9, apri src/app.js e fai clic sulla 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ù granulare dei punti di interruzione, puoi utilizzare la sezione Punti di interruzione nella visualizzazione di debug di VS Code.

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

    Quando invii una nuova richiesta all'applicazione, il debugger si ferma al primo breakpoint attivo.

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

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

  7. Modifica la stringa inviata in linea 8 in Hello, goodbye! e riavvia l'azione Esegui il debug su Kubernetes.

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

    App messa in pausa al punto di interruzione con valori aggiornati

Una volta avviata la sessione di debug, viene visualizzato il riquadro Sessioni di sviluppo. la visualizzazione del logging strutturato. All'inizio di un'attività, viene visualizzato un semicerchio in rotazione 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 nella Riquadro Sessione di sviluppo. Il riquadro Output mostra il passaggio nell'output del logging.

Apri un terminale nel container

Per aprire un terminale nel container, segui queste istruzioni:

  1. Fai clic su Cloud Code ed espandi Kubernetes .

  2. Espandi le seguenti sezioni:

    • Sezione del cluster che preferisci
    • La sezione Spazi dei nomi e poi la sezione dello spazio dei nomi che preferisci
    • La sezione Pod e poi la sezione del pod 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 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, è stato eseguito il deployment di tutte le risorse Kubernetes vengono eliminate automaticamente.

Per evitare che al tuo account vengano addebitati costi per altre risorse utilizzate in questo inizio rapido, assicurati di eliminare il progetto o il cluster che hai creato se vuoi riutilizzarlo.

Per eliminare il cluster:

  1. Fai clic su Cloud Code ed espandi l'esploratore Kubernetes.
  2. Tieni premuto il puntatore del mouse sul nome del cluster, quindi 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