Panoramica di Cloud Code for IntelliJ Kubernetes

Questa pagina fornisce una panoramica dello sviluppo di Kubernetes in Cloud Code.

Utilizzare Kubernetes Explorer in Cloud Code

Kubernetes Explorer ti consente di accedere alle informazioni sui cluster, sui nodi, sui carichi di lavoro e altro ancora direttamente dall'IDE.Kubernetes Puoi anche impostare un contesto corrente, riprodurre in streaming e visualizzare i log, aprire un terminale interattivo e cercare le descrizioni delle risorse con Kubernetes Explorer.

Kubernetes Explorer di Cloud Code

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 o aggiungere nuovi file Kubeconfig da Kubernetes Explorer. I file kubeconfig sono file YAML contenenti i dettagli del cluster Kubernetes, il certificato e il token segreto per l'autenticazione al 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, utilizza Kubernetes Explorer, accessibile dal riquadro laterale a destra. In alternativa, puoi accedere utilizzando Strumenti > Cloud Code > Kubernetes > Visualizza Esplora cluster.

Quando avvii una sessione di sviluppo o di debug, la sezione Sessioni di sviluppo mostra la visualizzazione dei log strutturati.

Riquadro Sessioni di sviluppo

Azioni di base

Kubernetes Explorer è basato su kubectl.Kubernetes Se hai configurato il file di configurazione kubectl per accedere ai tuoi cluster, puoi utilizzare Kubernetes Explorer per aggiungere cluster, sfogliare tutti gli spazi dei nomi, le risorse e i nodi disponibili per i tuoi cluster, indipendentemente dal fatto che si trovino nel contesto attivo o inattivo.

Le azioni Kubernetes generali disponibili, accessibili tramite le relative icone in Kubernetes Explorer, sono:

  • Nuova app Kubernetes da un'icona di esempio Creare una nuova applicazione Kubernetes da un esempio
  • Icona Aggiorna esploratore Aggiornare lo spazio di esplorazione
  • icona Apri Documenti Apri la documentazione di Kubernetes di Cloud Code in un browser web

Altre azioni comuni di debug di Kubernetes, accessibili tramite le relative icone in Kubernetes Explorer, sono:

  • Icona Run Esegui la configurazione di esecuzione/debug corrente.
  • Icona di debug Avvia la configurazione di esecuzione in modalità di debug.
  • Icona di interruzione del debug Interrompi una sessione di debug attiva.

Copiare il nome di una risorsa

Puoi copiare qualsiasi nome della risorsa Kubernetes negli appunti (inclusi i nomi dei contenitori e dei cluster). Per copiare il nome di una risorsa, fai clic con il tasto destro del mouse sulla risorsa e scegli Copia nome risorsa.

Copiare il nome di una risorsa utilizzando il menu di scelta rapida

Aggiorna le risorse

Kubernetes Explorer rileva le modifiche e si aggiorna automaticamente in base agli aggiornamenti.Kubernetes Per forzare l'aggiornamento di qualsiasi risorsa Kubernetes per recuperare le informazioni più recenti, fai clic con il tasto destro del mouse sulla risorsa e scegli Aggiorna.

Aggiornare i pod utilizzando il menu di scelta rapida

Puoi anche forzare un aggiornamento dell'intero Kubernetes Explorer utilizzando il pulsante di aggiornamento di Kubernetes Explorer. Pulsante di aggiornamento di Kubernetes Explorer

Descrivi le risorse

Per visualizzare i dettagli di qualsiasi risorsa non del cluster, fai clic con il tasto destro del mouse sulla risorsa, poi seleziona Descrivi. Le informazioni sulle risorse sono presentate nel riquadro della console di Kubernetes Explorer.

Opzione Descrivi disponibile quando fai clic con il tasto destro del mouse su una risorsa appropriata all'interno di Kubernetes Explorer e scegli Descrivi

Per visualizzare i dettagli di una risorsa, puoi anche fare clic su una risorsa qualsiasi. Se sono associati, i metadati sono disponibili nel riquadro Dettagli della risorsa nell'esploratore Kubernetes.

Visualizzazione dei metadati delle risorse nel riquadro Dettagli della risorsa disponibile nella seconda metà di Kubernetes Explorer

Opzioni Skaffold

  • Configurazione Skaffold: seleziona un file di configurazione skaffold.yaml. Verrà rilevato automaticamente se nel progetto è presente un skaffold.yaml.
  • Profilo di deployment: seleziona un profilo tra le opzioni disponibili configurate nel file skaffold.yaml.
  • Variabili di ambiente: consente di configurare variabili di ambiente aggiuntive da passare al processo di deployment di Skaffold. I flag Skaffold possono anche essere configurati come variabili di ambiente da utilizzare 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.
  • Lunghezza: consente di impostare il livello di dettaglio dell'output su trace, debug, info, warn, error o fatal. Il livello di dettagli 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 di sistema corrente, se esistente.

    Se preferisci non eseguire il deployment nel contesto corrente, 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 lo arresta al termine del deployment. Se un cluster minikube è già in esecuzione, Cloud Code utilizza il cluster minikube esistente per il deployment.
    • Cambia contesto e esegui il deployment in: modifica il contesto corrente sul sistema in base al contesto specificato al momento del deployment.

      Selezione del contesto di deployment di Kubernetes in una configurazione Kubernetes di Cloud Code

  • 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 dei deployment

Personalizzare la configurazione di avvio

Per configurare il modo in cui viene eseguita l'applicazione, puoi personalizzare il file skaffold.yaml.

Puoi anche configurare il lancio nelle configurazioni di esecuzione/debug. Per modificare le configurazioni, vai a Esegui > Modifica configurazioni.

Visualizza il file YAML remoto

Per visualizzare il codice YAML di una risorsa nel cluster, direttamente da Kubernetes Explorer. Vai 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 il file YAML di un pod facendo clic con il tasto destro del mouse sulla relativa etichetta in Kubernetes Explorer e scegliendo "Visualizza YAML remoto".

Visualizza i log

Puoi eseguire lo streaming e visualizzare i log delle risorse Kubernetes nella console Kubernetes Explorer per monitorarne l'avanzamento.

Dopo aver compilato e eseguito l'applicazione in modalità normale o di sviluppo, puoi monitorare i log in streaming dall'applicazione dall'IDE.

Visualizzazione dei log in streaming dall'applicazione Java Hello World

Puoi anche visualizzare i log di un servizio specifico andando a Kubernetes Explorer.

Per selezionare la risorsa da cui vuoi visualizzare i log, ad esempio un pod, un deployment o un servizio:

  1. Fai clic con il tasto destro del mouse sulla risorsa e seleziona Avvia flusso di log. In alternativa, puoi eseguire lo streaming dei log per i singoli container in esecuzione nei pod.

    I log vengono visualizzati nella console di Kubernetes Explorer.

Per visualizzare lo stato delle risorse nel deployment:

  • Stati di pod, deployment e nodi: accanto alle etichette di queste risorse Kubernetes sono presenti indicatori di stato colorati: rosso per lo stato di errore, giallo per inizio/terminazione/avviso e verde per lo stato corretto e desiderato.

    Il segno di spunta verde accanto all'etichetta del pod indica lo stato integro

  • 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.

    Opzione Descrivi disponibile quando fai clic con il tasto destro del mouse su una risorsa appropriata nel riquadro Kubernetes Explorer e scegli Descrivi

Avvia un terminale

Per i pod e i contenitori, puoi aprire un terminale interattivo facendo clic con il tasto destro del mouse sul pod o sul contenitore e selezionando Ottieni terminale.

Apertura di un terminale interattivo

Azioni specifiche per le risorse

Kubernetes Explorer mostra cluster, spazi dei nomi, nodi, carichi di lavoro (ad esempio deployment, replicaset, pod e container), servizi e ingressi, configurazioni (ad esempio secret e mappe di configurazione) e 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 Kubernetes Explorer.

Riquadro Kubernetes Explorer aperto utilizzando la scheda sulla barra delle app a destra

Per visualizzare i dettagli delle risorse di cui è stato eseguito il deployment, fai clic con il tasto destro del mouse su un'etichetta della risorsa in Kubernetes Explorer e poi su Descrivi.

Opzione Descrivi disponibile quando fai clic con il tasto destro del mouse su una risorsa appropriata nel riquadro Kubernetes Explorer e scegli 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 o creare un nuovo cluster.

Al termine, fai clic su Ok e accedi al cluster scelto e alle relative risorse sottostanti tramite Kubernetes Explorer.

Aggiunta di un cluster GKE con la finestra di dialogo Kubernetes Explorer con i campi per i nomi del progetto e del cluster

  • Imposta come contesto corrente:imposta il cluster specificato come attivo in modo che il contesto kubectl configurato acceda a questo cluster per impostazione predefinita.

    Impostare un cluster come contesto corrente con Kubernetes Explorer

Kubernetes Explorer si aggiorna automaticamente e vedrai il simbolo Kubernetes accanto al cluster appropriato.

Se in un cluster sono configurati più contesti, potrai scegliere uno dei contesti disponibili da impostare come contesto corrente.

Scegliere e impostare un cluster attivo da un elenco di più contesti con Kubernetes Explorer

Spazi dei nomi

  • Imposta come contesto corrente:imposta uno spazio dei nomi come attivo in modo che il contesto kubectl configurato acceda a questo spazio per impostazione predefinita.

    Impostare lo spazio dei nomi come contesto corrente utilizzando il menu di scelta rapida

Se questa azione va a buon fine, Kubernetes Explorer si aggiorna automaticamente e accanto allo spazio dei nomi viene visualizzato un asterisco per indicare che fa parte del contesto corrente.

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 solitamente creati automaticamente quando avvii un cluster minikube o GKE. Se non vedi l'opzione Imposta come contesto corrente per un determinato spazio dei nomi e vuoi creare un contesto per questo, utilizza il comando kubectl config set-context nel terminale per impostare un contesto con il cluster, l'utente e lo spazio dei nomi preferiti.

Pod

  • Visualizza log:visualizza i log di un pod nella console di Kubernetes Explorer.
  • Ottieni terminale:Ottieni terminale per un pod nella console Kubernetes Explorer.

    Inoltre, i pod in esecuzione hanno indicatori di stato colorati accanto alle etichette:

    • Rosso: il pod è in uno stato di errore
    • Giallo: il pod è in fase di avvio o di interruzione
    • Verde: il pod è integro e in esecuzione
Segno di spunta verde accanto al pod che indica lo stato integro

Container

  • Visualizza i log: visualizza i log di un contenitore nella console di Kubernetes Explorer.
  • Ottieni terminale: Ottieni terminale per un contenitore nella console di Kubernetes Explorer.
Streaming dei log da un contenitore utilizzando il menu di scelta rapida per esportarli nella console di Kubernetes Explorer

Deployment

  • Visualizza i log: visualizza i log di un deployment nella console Kubernetes Explorer.

    I deployment attivi hanno indicatori di stato colorati accanto alle etichette e ai conteggi delle repliche correnti/totali:

    • Giallo: il deployment non ha disponibilità minima o presenta problemi con le immagini.
    • Verde: il deployment è integro e ha avuto una disponibilità minima.
Icone di deployment verdi che indicano lo stato integro

Nodi

I nodi del cluster hanno indicatori di stato colorati accanto ai nomi:

  • Giallo: il nodo ha un problema di 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:

Elenco delle definizioni di risorse personalizzate nell'esploratore

Passaggi successivi

Assistenza

Per inviare un feedback o segnalare un problema nell'IDE IntelliJ, vai a Strumenti > Cloud Code > Guida / Informazioni > Invia feedback o segnala un problema per segnalare un problema su GitHub.