Questa pagina fornisce una panoramica dello sviluppo di Kubernetes in Cloud Code.
Utilizza Kubernetes Explorer in Cloud Code
Kubernetes Explorer ti consente di accedere a informazioni su cluster, nodi, carichi di lavoro e altro ancora, direttamente dal tuo IDE. Puoi anche impostare un contesto attuale, eseguire il flusso di dati e visualizzare i log, aprire un terminale interattivo e cercare le descrizioni delle risorse con Kubernetes Explorer.
Cloud Code utilizza il file kubeconfig predefinito, che si trova nella directory $HOME/.kube
su MacOS/Linux o %USERPROFILE%\.kube
su Windows, per recuperare le risorse Kubernetes. Puoi cambiare file kubeconfig o aggiungerne di nuovi
da Kubernetes Explorer. I file kubeconfig sono file YAML che contengono i dettagli del cluster Kubernetes, il certificato e il token segreto per l'autenticazione nel cluster.
Per utilizzare un file kubeconfig diverso da quello predefinito, consulta la guida Utilizzare i file kubeconfig.
Accedere a Kubernetes Explorer
Per visualizzare e gestire le risorse Kubernetes, usa Kubernetes Explorer, accessibile dal riquadro laterale a destra. In alternativa, è possibile accedervi utilizzando Strumenti > Cloud Code > Kubernetes > Visualizza Esplora cluster.Quando avvii una sessione di sviluppo o debug, nella sezione Sessioni di sviluppo viene visualizzata la visualizzazione del logging strutturato.
Azioni di base
Kubernetes Explorer è basato sulla tecnologia kubectl
. Finché hai configurato il file di configurazione kubectl
per accedere ai cluster, puoi utilizzare Kubernetes Explorer per aggiungere cluster e sfogliare tutti gli spazi dei nomi, le risorse e i nodi disponibili per i cluster, indipendentemente dal fatto che si trovino nel contesto attivo o inattivo.
Le azioni generali disponibili di Kubernetes, accessibili tramite le rispettive icone in Kubernetes Explorer, sono:
- Crea una nuova applicazione Kubernetes da un esempio
- Aggiorna Spazio di esplorazione
- Apri la documentazione di Cloud Code per Kubernetes in un browser web
Altre azioni comuni di debug di Kubernetes, accessibili tramite le rispettive icone in Kubernetes Explorer, sono:
- Esegui l'attuale configurazione di esecuzione/debug.
- Avvia la configurazione di esecuzione in modalità di debug.
- Arresta una sessione di debug attiva.
Copia il nome di una risorsa
Puoi copiare negli appunti qualsiasi nome di risorsa Kubernetes (inclusi i nomi di container e cluster). Per copiare il nome di una risorsa, fai clic con il tasto destro del mouse sulla risorsa e scegli Copia nome risorsa.
Aggiorna risorse
Kubernetes Explorer monitora le modifiche e si aggiorna automaticamente per riflettere gli aggiornamenti. Per forzare un aggiornamento di una risorsa Kubernetes affinché recuperi le informazioni più recenti, fai clic con il tasto destro del mouse sulla risorsa e scegli Aggiorna.
Puoi anche forzare un aggiornamento dell'intero Kubernetes Explorer utilizzando il pulsante di aggiornamento di Kubernetes Explorer.Descrivi le risorse
Per visualizzare i dettagli di qualsiasi risorsa non cluster, fai clic con il tasto destro del mouse sulla risorsa e seleziona Descrivi. Le informazioni sulle risorse vengono presentate nel riquadro della console di Kubernetes Explorer.Per visualizzare i dettagli della risorsa, puoi anche fare clic su qualsiasi risorsa. Se sono allegati metadati, questi sono disponibili nel riquadro Dettagli risorsa di Kubernetes Explorer.
Opzioni Skaffold
- Configurazione Skaffold: consente di selezionare un file di configurazione
skaffold.yaml
. Verrà rilevata automaticamente se hai unskaffold.yaml
nel tuo progetto. - Profilo di deployment: seleziona un profilo tra le opzioni disponibili configurate nel file
skaffold.yaml
. - Variabili di ambiente: consentono di configurare variabili di ambiente aggiuntive da passare al processo di deployment di Skaffold. Inoltre, i flag Skaffold possono essere configurati come variabili di ambiente da usare in questo campo. Consulta la documentazione di riferimento dell'interfaccia a riga di comando Skaffold per un elenco completo delle variabili di ambiente Skaffold disponibili.
- Preferenze di lettura: consente di impostare il livello di dettaglio dell'output su
trace
,debug
,info
,warn
,error
ofatal
. Il livello di dettaglio predefinito èwarn
.
Opzioni Kubernetes
Contesto deployment: rappresenta il contesto Kubernetes con cui viene eseguito il deployment dell'applicazione. Se un contesto di deployment non è specificato, il comportamento predefinito prevede il deployment nel contesto attuale del sistema, se esistente.
Se preferisci non eseguire il deployment nel contesto attuale, nella sezione Deployment delle impostazioni Esegui/Debug, puoi scegliere di:
- Esegui il deployment localmente in un cluster minikube: avvia un cluster minikube gestito da Cloud Code per eseguire la tua app e arresta il cluster dopo l'arresto del deployment. Se un cluster minikube è già in esecuzione, Cloud Code utilizza il cluster minikube esistente per il deployment.
Cambia contesto ed esegui il deployment: cambia il contesto attuale sul sistema con quello specificato al momento del deployment.
Elimina deployment al termine: elimina i deployment Kubernetes quando il processo viene terminato. Questo è il comportamento predefinito. In alternativa, puoi attivare/disattivare questa impostazione per impedire l'eliminazione
Personalizza la configurazione del lancio
Per configurare la modalità di esecuzione dell'applicazione, puoi personalizzare il file skaffold.yaml
.
Visualizza YAML remoto
Per visualizzare il codice YAML di una risorsa nel tuo cluster, direttamente da Kubernetes Explorer. Vai a una risorsa, ad esempio un pod, in Kubernetes Explorer, fai clic con il tasto destro del mouse sul nome della risorsa e seleziona Visualizza YAML remoto.Il file YAML corrispondente alla risorsa specificata si apre in una nuova scheda dell'editor.
Visualizza i log
Puoi trasmettere e visualizzare i log dalle risorse Kubernetes nella console di Kubernetes Explorer per monitorarne l'avanzamento.
Dopo che l'applicazione è stata creata ed eseguita in modalità regolare o di sviluppo, potrai monitorare il flusso di log dei log dall'applicazione dall'interno del tuo IDE.
Puoi anche visualizzare i log di un servizio specifico passando a Kubernetes Explorer.
Per selezionare la risorsa di cui vuoi visualizzare i log, ad esempio un pod, un deployment o un servizio:
Fai clic con il tasto destro del mouse sulla risorsa e seleziona Avvia flusso di log. In alternativa, puoi trasmettere i flussi di log per i singoli container in esecuzione nei pod.
I log vengono inviati alla console di Kubernetes Explorer.
Per visualizzare lo stato delle risorse nel deployment:
Stati di pod, deployment e nodo: queste risorse Kubernetes sono contrassegnate da segni di stato colorati accanto alle etichette; rosso per lo stato non riuscito, giallo per avvio/terminazione/avviso e verde per lo stato integro e desiderato.
Descrizioni delle risorse di cui è stato eseguito il deployment: puoi eseguire un
kubectl describe
sulle risorse di cui è stato eseguito il deployment per visualizzarne i dettagli facendo clic con il tasto destro del mouse e scegliendo Descrivi.
Avvia un terminale
Per pod e container, puoi aprire un terminale interattivo facendo clic con il tasto destro del mouse sul pod o sul container e selezionando Ottieni terminale.
Azioni specifiche delle risorse
Kubernetes Explorer visualizza cluster, spazi dei nomi, nodi, carichi di lavoro (ad esempio deployment, set di repliche, pod e container), servizi e accessi, configurazioni (come secret e mappe di configurazione) e spazio di archiviazione (ad esempio i volumi). Con Kubernetes Explorer, puoi eseguire azioni univoche su alcune di queste risorse.
Puoi accedere a Kubernetes Explorer dal riquadro laterale o vai a Strumenti > Cloud Code > Kubernetes > Visualizza Cluster Explorer.
Per visualizzare i dettagli delle risorse di cui hai eseguito il deployment, fai clic con il tasto destro del mouse su un'etichetta della risorsa in Kubernetes Explorer, quindi fai clic su Descrivi.
Cluster
- Aggiungi un cluster Google Kubernetes Engine: aggiungi un cluster GKE Standard o Autopilot esistente o creane uno nuovo facendo clic su + Aggiungi cluster GKE all'interno di Kubernetes Explorer.
Viene visualizzata la finestra di dialogo Aggiungi cluster, in cui puoi scegliere il progetto e il cluster da utilizzare oppure creare un nuovo cluster.
Al termine, fai clic su OK e accedi al cluster scelto e alle risorse sottostanti tramite Kubernetes Explorer.Imposta come contesto attuale: imposta il cluster specificato come attivo in modo che il contesto
kubectl
configurato acceda a questo cluster per impostazione predefinita.
Kubernetes Explorer si aggiorna automaticamente e viene visualizzato il simbolo Kubernetes accanto al cluster appropriato.
Se un cluster ha più contesti configurati, puoi scegliere uno dei contesti disponibili da impostare come contesto attuale.
Spazi dei nomi
Imposta come contesto attuale: imposta uno spazio dei nomi come attivo in modo che il contesto
kubectl
configurato acceda a questo spazio dei nomi per impostazione predefinita.
Tieni presente che un contesto Kubernetes è una scorciatoia che consente di accedere rapidamente a uno spazio dei nomi nel cluster. In genere, i contesti vengono creati automaticamente all'avvio di un cluster minikube o GKE. Se non vedi l'opzione Imposta come contesto attuale per un determinato spazio dei nomi e vuoi creare un contesto, utilizza il comando kubectl config set-context
nel terminale per impostare un contesto con il cluster, l'utente e lo spazio dei nomi che preferisci.
i pod
- Visualizzazione dei log: consente di visualizzare i log di un pod nella console di Kubernetes Explorer.
Ottieni terminale: recupera terminale per un pod nella console di Kubernetes Explorer.
Inoltre, i pod in esecuzione sono contrassegnati da indicatori di stato colorati accanto alle etichette:
- Rosso: il pod è in stato di errore
- Giallo: il pod è in fase di avvio o arresto
- Verde: il pod è integro e in esecuzione
Container
- Visualizzazione dei log:consente di visualizzare i log di un container nella console di Kubernetes Explorer.
- Recupera terminale: recupera terminale per un container nella console di Kubernetes Explorer.
Deployment
Visualizza i log: visualizza i log di un deployment nella console di Kubernetes Explorer.
Le implementazioni live hanno indicatori di stato colorati accanto alle etichette e al numero di repliche correnti/totali:
- Giallo: il deployment non ha disponibilità minima o non presenta problemi relativi alle immagini.
- Verde: il deployment è integro e ha una disponibilità minima.
Nodi
I nodi del cluster sono contrassegnati da indicatori di stato colorati accanto ai nomi:
- Giallo: il nodo presenta un problema di risorse come la disponibilità di memoria o disco.
- Verde: il nodo è integro.
Definizioni di risorse personalizzate (CRD)
Kubernetes Explorer elenca tutte le definizioni di risorse personalizzate (CRD) installate e disponibili sul tuo cluster:
Passaggi successivi
- Inizia a utilizzare Cloud Code for IntelliJ per Kubernetes creando ed eseguendo il deployment di un'applicazione Kubernetes da un esempio di codice.
- Utilizza sincronizzazione file e ricaricamento a caldo per accelerare lo sviluppo.
- Eseguire il debug dell'applicazione in Cloud Code