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

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

Questa pagina mostra come iniziare rapidamente a utilizzare Cloud Code.

Configurerai una nuova applicazione Kubernetes utilizzando un'applicazione di esempio "Hello World", creerai un cluster, eseguirai l'app su questo cluster, eseguirai il debug del codice in esecuzione, visualizzerai i log dell'applicazione in tempo reale e collegherai un terminale al container in esecuzione.

Prima di iniziare

Accedi al tuo Google Cloud account. 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 senza costi per l'esecuzione, il test e il deployment dei workload.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Installa Git. Git è necessario per copiare gli esempi sulla tua macchina.
2. Installa Docker. Docker è necessario per creare il codice campione. Assicurati che il tuo account utente locale sia in grado di creare container.
3. Installa il plug-in Cloud Code se non l'hai già fatto.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti il ruolo IAM Amministratore di Kubernetes Engine (roles/container.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un'applicazione

1. Apri la tavolozza dei comandi (premi Ctrl/Cmd+Shift+P o fai clic su Visualizza > Tavolozza 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, viene creata un'app Node.js Hello World di base.

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:

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

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

3. Quando ti viene chiesto di abilitare l'API Container, 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 Google Cloud console.

7. Nella Google Cloud console, assicurati che il progetto selezionato sia quello che hai creato o scelto in precedenza.

8. Imposta il nome del cluster su my-first-cluster.

9. Seleziona Zonal come tipo di località e imposta la zona su us-central1-a.

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

11. Dopo aver creato il cluster, fai di nuovo clic su Aggiungi un cluster a KubeConfig e seleziona dall'elenco il cluster appena creato.

12. 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 che tu possa modificare ed eseguire di nuovo 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.

   

2. Nel menu Selezione rapida visualizzato, seleziona Esegui su Kubernetes. Quando ti viene richiesto di nuovo, seleziona Esegui su Kubernetes.

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

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

5. Dopo che l'applicazione è in esecuzione su Kubernetes, fai clic sulla voce Stato dell'attività Esegui su Kubernetes nella sezione Sessioni di sviluppo. Si aprirà una finestra con una scheda Output che include l'URL dell'applicazione. Per aprire questo URL, premi Control (o Command su macOS) e fai clic sull'indirizzo.

   Puoi anche trovare l'applicazione nella panoramica dei workload nella Google Cloud console. Per ulteriori informazioni sull'applicazione in esecuzione, inclusi l'indirizzo IP esterno e il numero di porta, fai clic sul nome nell'elenco.

Suggerimenti per la risoluzione dei problemi

Se utilizzi un cluster preesistente, per impostarlo come attivo e ottenere le credenziali del cluster:

1. In VS Code, 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.

   

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

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

4. Se ti viene 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 debug.

   Cloud Code crea i container, ne esegue il push nel registro, applica le configurazioni di Kubernetes al cluster e restituisce l'indirizzo IP che puoi utilizzare per navigare nell'applicazione in tempo reale.

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 oppure premi 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 sul 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.

   

   Quando invii una nuova richiesta all'applicazione, il debugger si interrompe al primo punto di interruzione attivo.

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

   

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

   Dopo la ricompilazione e il nuovo deployment dell'app, prendi nota del valore aggiornato di res._contentLength.

   

Dopo l'avvio della sessione di debug, il riquadro Sessioni di sviluppo mostra la visualizzazione dei log strutturati. 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 dei log.

Apri un terminale nel container

Per aprire un terminale nel container:

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

     

3. Fai clic con il tasto destro del mouse sul container 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.

Libera spazio

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 sul nome del cluster e poi fai clic su open_in_new Apri nella Google Cloud console.
3. Fai clic su Elimina e poi su Elimina.

Per eliminare il progetto (e le risorse associate, inclusi eventuali 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, eliminerai anche tutto il lavoro che hai 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 URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella Google Cloud console, 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 progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Valuta la possibilità di importare un'applicazione esistente in VS Code e di configurare Cloud Code.
• Affronta configurazioni più avanzate Google Cloud di e Kubernetes con il supporto per l'editing di YAML di Cloud Code.
• Scopri il supporto per il debug specifico per la lingua fornito da Cloud Code.
• Accelera lo sviluppo con la sincronizzazione dei file e il ricaricamento a caldo.
• Crea e configura un cluster GKE
• Configura cluster privati
• Personalizza la tua esperienza con Cloud Code configurando le impostazioni pertinenti.
• Esegui il deployment delle applicazioni su cluster GKE ARM64, AMD64 o con architettura mista.