Cloud Code installa e gestisce automaticamente minikube. Se
hai disattivato la gestione delle dipendenze, aggiungi il binario minikube a PATH.
Prima di iniziare
- Installa Git in modo che Cloud Code possa eseguire operazioni Git, come la clonazione di un esempio.
- Installa il plug-in Cloud Code se non l'hai ancora fatto.
Creare un'applicazione da un modello
Cloud Code include una raccolta di modelli di esempio di codice per iniziare rapidamente. Per creare un'applicazione Kubernetes utilizzando un esempio esistente, segui questi passaggi:
- Avvia la tavolozza dei comandi (premi
Ctrl/Cmd+Shift+Po fai clic su Visualizza > Tavolozza comandi) e poi esegui Cloud Code: New Application. - Seleziona Applicazione Kubernetes per il tipo di esempio.
- Seleziona un campione in base alla lingua che vuoi utilizzare tra le opzioni disponibili: NodeJS, Go, Python, Java.
Scegli una posizione preferita per l'applicazione sulla tua macchina locale e poi fai clic su Crea nuova applicazione per salvare.
Cloud Code clona l'esempio che hai scelto e apre il nuovo progetto per l'utilizzo.
Struttura dell'applicazione di esempio
Tutte le applicazioni di esempio di lingua hanno quasi la stessa struttura. Questa non è l'unica struttura supportata, ma è consigliata per iniziare.
Ad esempio, la struttura dell'applicazione Guestbook Node.js è la seguente:
.
|---- .vscode
| └---- launch.json
|---- kubernetes-manifests
| |---- guestbook-backend.deployment.yaml
| |---- guestbook-backend.service.yaml
| |---- guestbook-frontend.deployment.yaml
| |---- guestbook-frontend.service.yaml
| |---- mongo.deployment.yaml
| └---- mongo.service.yaml
|---- src
| |---- backend
| | |---- Dockerfile
| | |---- index.js
| | |---- app.js
| | └---- package.json
| |---- frontend
| |---- Dockerfile
| |---- index.js
| | |---- app.js
| └---- package.json
└---- skaffold.yaml
Se esaminiamo più da vicino questa app di esempio Kubernetes Guestbook Node.js, ecco alcuni file chiave e i relativi utilizzi:
- .vscode
extensions.json: prompt che richiede il download delle estensioni correlate all'apertura di questo progettolaunch.json: configurazione di avvio (di tipocloudcode.kubernetes) per eseguire o eseguire il debug dell'applicazione Kubernetestasks.json: informazioni di configurazione per Visual Studio Code Tasks
- kubernetes-manifests
guestbook-backend.deployment.yaml: Specifica pod per i nodi di backendguestbook-frontend.deployment.yaml: Specifica pod per i nodi frontendmongo.deployment.yaml: Specifica pod per il database
- src
(backend|frontend)/app.js: Codice Node.js con la logica del server web(backend|frontend)/Dockerfile: utilizzato per creare l'immagine container per il nostro programma
skaffold.yaml: un file di configurazione, che Cloud Code utilizza per creare, eseguire il deployment e il debug delle applicazioni Kubernetes
Utilizzare la propria applicazione
Per i passaggi per utilizzare un progetto esistente, consulta la sezione Utilizzare Cloud Code con un'applicazione Kubernetes esistente.
Imposta il contesto Kubernetes
Prima di eseguire l'applicazione, assicurati di aver configurato il deployment dell'app nel contesto Kubernetes che preferisci. Puoi specificarlo nella configurazione.
Configurazione
Quando utilizzi la configurazione di esecuzione Cloud Code: Develop on Kubernetes, puoi personalizzare la distribuzione configurando le impostazioni disponibili.
Per aggiungere o modificare le configurazioni, vai a Esegui > Apri configurazioni e poi modifica o aggiungi le configurazioni.Crea ed esegui il deployment in un cluster minikube
Avvia un cluster minikube
Cloud Code installa e gestisce automaticamente minikube. Se
hai disattivato la gestione delle dipendenze, aggiungi il binario minikube a PATH.
- Avvia la tavolozza dei comandi (premi
Ctrl/Cmd+Shift+Po fai clic su Visualizza > Tavolozza comandi) e poi esegui il comando Cloud Code: Control minikube. - Fai clic su minikube in Scegli un cluster (profilo) Minikube da controllare e poi fai clic su Avvia.
Esegui su minikube
- Avvia la tavolozza dei comandi ed esegui Cloud Code: Run on Kubernetes.
- Fai clic su Sì per Utilizzare il contesto attuale (minikube) per eseguire l'app?
Cloud Code esegue la tua app in un cluster minikube. Se richiesto, autorizza Cloud Shell a utilizzare le tue credenziali per effettuare una chiamata APIGoogle Cloud .
Visualizza i dettagli del deployment nella sezione Sessioni di sviluppo di Cloud Code.
Visualizza gli URL facendo clic su URL portforward nella sezione Sessioni di sviluppo, quindi fai clic sul link dell'URL per aprire il browser con l'applicazione in esecuzione.
Aprire un terminale interattivo per un container
- Fai clic su
Cloud Code ed espandi Explorer di Sessioni di sviluppo.
- Espandi Risorse di cui è stato eseguito il deployment, quindi espandi Pod.
- Fai clic con il tasto destro del mouse su un contenitore e poi fai clic su Ottieni terminale.
Mettere in pausa o arrestare un cluster minikube
- Avvia la tavolozza dei comandi (premi
Ctrl/Cmd+Shift+Po fai clic su Visualizza > Tavolozza comandi) e poi esegui il comando Cloud Code: Control minikube. - Dopo aver compilato l'opzione Scegli un cluster (profilo) Minikube da controllare, fai clic su minikube e poi su Arresta o Metti in pausa.
Crea e aggiungi un cluster da un altro cloud provider
Se utilizzi un cluster on-premise o un cluster di un altro provider come Azure o AWS, utilizza gli strumenti del provider per creare il cluster e aggiungerlo al tuo KubeConfig.
Collaborare con altri cluster locali
Oltre a minikube, puoi utilizzare Cloud Code se utilizzi Docker Desktop (per Mac o Windows).
Per far funzionare Cloud Code con un cluster locale, assicurati che la configurazione predefinita (ad esempio ~/.kube/config) contenga il cluster locale. Questo cluster deve essere impostato come contesto corrente.
Ad esempio, se utilizzi un cluster locale, docker-for-desktop, con
Docker Desktop, imposta il cluster preferito eseguendo il seguente comando:
kubectl config use-context docker-for-desktop
Passaggi successivi
- Utilizza la sincronizzazione dei file e il ricaricamento rapido per velocizzare lo sviluppo.
- Eseguire il debug dell'applicazione in Cloud Code