Questa pagina fornisce una panoramica dello sviluppo di Kubernetes in Cloud Code.
Utilizzare 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, generare flussi di dati e visualizzare i log, aprire un terminale interattivo e cercare descrizioni delle risorse con Kubernetes Explorer.
Cloud Code utilizza il file kubeconfig predefinito, situato nella directory $HOME/.kube
su MacOS/Linux o %USERPROFILE%\.kube
su Windows, per il recupero delle risorse Kubernetes. Puoi cambiare file o aggiungerne di nuovi
da Kubernetes Explorer. I file kubeconfig sono file YAML contenenti 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.
Accedi 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, la sezione Sessioni di sviluppo mostra la visualizzazione del logging strutturato.
Azioni di base
Kubernetes Explorer è basato su kubectl
. Se hai configurato il file di configurazione kubectl
per accedere ai cluster, puoi utilizzare Explorer Kubernetes per aggiungere cluster e sfogliare tutti gli spazi dei nomi, le risorse e i nodi disponibili per i cluster, indipendentemente dal contesto attivo o inattivo.
Le azioni generali di Kubernetes disponibili, accessibili tramite le relative icone in Kubernetes Explorer, sono:
- Crea una nuova applicazione Kubernetes da un esempio
- Aggiorna Spazio di esplorazione
- Apri la documentazione di Kubernetes di Cloud Code in un browser web
Altre azioni di debug comuni di Kubernetes, accessibili tramite le relative icone in Kubernetes Explorer, sono:
- Esegui la configurazione Esegui/Debug attuale.
- Avvia la configurazione di esecuzione in modalità di debug.
- Interrompi una sessione di debug attiva.
Copia un nome risorsa
Puoi copiare qualsiasi nome di risorsa Kubernetes negli appunti, 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 rileva le modifiche e si aggiorna automaticamente per riflettere gli aggiornamenti. Per forzare un aggiornamento di una risorsa Kubernetes in modo da recuperare 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.Descrizione delle 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 delle risorse, puoi anche fare clic su una risorsa qualsiasi. Se sono associati a metadati, questi sono disponibili nel riquadro Dettagli risorsa in Kubernetes Explorer.
Opzioni Skaffold
- Configurazione Skaffold: seleziona un file di configurazione
skaffold.yaml
. Verrà rilevato automaticamente se nel tuo progetto è presente unskaffold.yaml
. - 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. I flag Skaffold possono essere configurati anche 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.
- Livello di dettaglio: ti consente di impostare il livello di dettaglio di output su
trace
,debug
,info
,warn
,error
ofatal
. Il livello di dettaglio predefinito èwarn
.
Opzioni Kubernetes
Contesto di deployment: rappresenta il contesto Kubernetes con cui viene eseguito il deployment dell'applicazione. Il comportamento predefinito, se non viene specificato un contesto di deployment, è il deployment nel contesto attuale del sistema, se esistente.
Se preferisci non eseguire il deployment nel contesto attuale, nella sezione Deployment delle impostazioni di esecuzione/debug puoi scegliere di:
- Esegui il deployment localmente in un cluster minikube: avvia un cluster minikube gestito da Cloud Code per eseguire l'app e arresta il cluster dopo l'arresto del deployment. Se è già in esecuzione un cluster minikube, Cloud Code utilizza per il deployment il cluster minikube esistente.
Cambia contesto ed esegui il deployment: al momento del deployment, cambia il contesto attuale sul tuo sistema nel contesto specificato.
Elimina i deployment al termine: elimina i deployment Kubernetes al termine del processo. Questo è il comportamento predefinito. In alternativa, puoi attivare/disattivare questa impostazione per impedire l'eliminazione
Personalizzare la configurazione di lancio
Per configurare l'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. Accedi a una risorsa in Kubernetes Explorer, ad esempio un pod, 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 delle risorse Kubernetes nella console Explorer di Kubernetes per monitorarne l'avanzamento.
Dopo che l'applicazione è stata creata e eseguita in modalità normale o di sviluppo, potrai monitorare i flussi di log dell'applicazione dall'interno del tuo IDE.
Puoi anche visualizzare i log di un servizio specifico accedendo a Kubernetes Explorer.
Per selezionare la risorsa da cui 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 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 presentano indicatori di stato colorati accanto alle relative etichette: rosso per lo stato non riuscito, giallo per avvio/terminazione/avviso e verde per stato integro e desiderato.
Descrizioni delle risorse di cui è stato eseguito il deployment: puoi eseguire un
kubectl describe
sulle risorse di cui hai eseguito il deployment per visualizzarne i dettagli facendo clic con il tasto destro del mouse e scegliendo Descrivi.
Avvia un terminale
Per i pod e i container, puoi aprire un terminale interattivo facendo clic con il tasto destro del mouse sul pod o del container e selezionando Ottieni terminale.
Azioni specifiche per la risorsa
Kubernetes Explorer visualizza cluster, spazi dei nomi, nodi, carichi di lavoro (ad esempio deployment, set di repliche, pod e container), servizi e oggetti Ingress, configurazioni (come secret e mappe di configurazione) e spazio di archiviazione (ad esempio volumi). Con Kubernetes Explorer, puoi eseguire azioni univoche su alcune di queste risorse.
Puoi accedere a Kubernetes Explorer dal riquadro laterale o andare a Strumenti > Cloud Code > Kubernetes > Visualizza Explorer cluster.
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 in Kubernetes Explorer.
Viene visualizzata la finestra di dialogo Aggiungi cluster, dove puoi scegliere il progetto e il cluster da utilizzare o crearne uno nuovo.
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 il simbolo di Kubernetes viene visualizzato 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 ti consente di accedere rapidamente a uno spazio dei nomi nel tuo cluster. I contesti vengono normalmente 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 per lo spazio dei nomi, utilizza il comando kubectl config set-context
nel terminale per impostare un contesto con il cluster, l'utente e lo spazio dei nomi preferiti.
i pod
- Visualizza i log:visualizza 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 presentano indicatori di stato colorati accanto alle loro etichette:
- Rosso: il pod è in uno stato di errore
- Giallo: il pod è in fase di avvio o di arresto
- Verde: il pod è integro e in esecuzione
Container
- Visualizza i log:visualizza i log di un container nella console di Kubernetes Explorer.
- Ottieni 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.
I deployment attivi hanno indicatori di stato colorati accanto alle etichette e ai conteggi delle repliche attuali/totali:
- Giallo: il deployment non ha disponibilità minima o presenta problemi di immagine.
- Verde: il deployment è integro e aveva una disponibilità minima.
Nodi
Accanto ai nomi dei nodi del cluster sono presenti indicatori di stato colorati:
- Giallo: il nodo presenta un problema delle risorse, ad esempio 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 nel 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 la sincronizzazione dei file e il ricaricamento a caldo per velocizzare lo sviluppo.
- Esegui il debug dell'applicazione in Cloud Code