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

Questa pagina mostra come iniziare rapidamente a utilizzare Cloud Code.

Configura una nuova applicazione Kubernetes utilizzando un'app di esempio "Hello World", crea un cluster, esegui l'app su questo cluster, esegui il debug del codice in esecuzione, visualizza i log dell'applicazione in produzione e connetti un terminale al contenitore 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.

    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.

    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 i sample 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 comandi) ed esegui Cloud Code: New Application.

  2. Scegli Applicazione Kubernetes.

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

    Ad esempio, la scelta di Node.js: Hello World crea un'app Node.js Hello World di partenza.

  4. Salva la nuova applicazione.

    Viene visualizzata una notifica che conferma la creazione della richiesta e si apre una nuova finestra con la richiesta.

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

  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 del cluster corrente o passare a un altro.

  4. Se richiesto, scegli un registry di 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 dei pod in esecuzione nell'output del terminale.

  5. Dopo che l'applicazione è in esecuzione su Kubernetes, la finestra di output visualizza 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, 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 tue credenziali per eseguire e eseguire il debug di un'applicazione.

  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 contenitori, li spinge nel registry, applica le configurazioni Kubernetes al cluster e restituisce l'indirizzo IP che puoi utilizzare per sfogliare l'applicazione in produzione.

  5. Prima che la sessione del debugger venga collegata, ti viene chiesto di confermare o inserire la directory nel contenitore remoto in cui si trova il programma da eseguire il 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 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ù 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 della visualizzazione 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 in pausa al breakpoint e sezioni di variabili e stack di chiamate compilate 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

Dopo l'avvio della sessione di debug, nel riquadro Sessioni di sviluppo viene visualizzata la vista di registrazione strutturata. 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 nel riquadro Sessione di sviluppo. Il riquadro Output mostra il passaggio nell'output del logging.

Apri un terminale nel contenitore

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 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 interrotto 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 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