Inizia a utilizzare Cloud Code for IntelliJ per Kubernetes

Cloud Code consente di creare un'applicazione Kubernetes sulla base di un campione o di un progetto esistente.

Creare un'applicazione da un modello

Cloud Code include una raccolta di modelli di esempi di codice per aiutarti a iniziare rapidamente. Per creare un'applicazione Kubernetes utilizzando un esempio esistente, segui questi passaggi:

1. Apri File > Nuovo progetto.
2. Seleziona Cloud Code: Kubernetes.
3. Seleziona un modello dall'elenco delle applicazioni di base.

4. Scegli un nome per il progetto.

   Dopo aver fatto clic su Fine, Cloud Code clonerà il modello scelto e aprirà il progetto appena creato per l'utilizzo.

   Per i modelli Java, ti verrà chiesto di importare i progetti Maven per sincronizzare il file pom.xml. Fai clic su Aggiungi come progetto Maven. Inoltre, importa i progetti Maven necessari facendo clic su Importa modifiche.

5. Le destinazioni di esecuzione IDE per l'esecuzione e lo sviluppo di Kubernetes per il progetto vengono create automaticamente e pronte per l'esecuzione.

   (Facoltativo) In alternativa, puoi creare manualmente target di esecuzione:

   1. Seleziona il menu a discesa Esegui configurazione e fai clic su Modifica configurazioni.
   2. Fai clic su + Aggiungi nuova configurazione per aggiungere una nuova configurazione di esecuzione.
   3. Vai a Cloud Code: Kubernetes
   4. Inserisci un nome per la nuova configurazione (il valore predefinito è "Senza nome").
   5. Fai clic su OK per creare la destinazione della corsa.
   Nota: se hai eseguito l'accesso a Google Cloud nel tuo IDE e hai definito un progetto predefinito, Cloud Code utilizza il repository di immagini container predefinito. Per specificare un'immagine container diversa, consulta Configurare le impostazioni dell'immagine container.

Utilizza la tua applicazione

Per la procedura di utilizzo di un progetto esistente, consulta Utilizzare Cloud Code con un'applicazione Kubernetes esistente.

Nota: per sviluppare e testare un'app, crea ed esegui l'applicazione su un cluster non di produzione.
Per le modifiche che verranno implementate in produzione, utilizza un flusso di lavoro CI/CD automatizzato.

Imposta il contesto di Kubernetes

Prima di eseguire l'applicazione, assicurati di avere la configurazione necessaria per eseguire il deployment dell'app nel contesto Kubernetes preferito. Puoi specificarlo nella tua configurazione.

Se vuoi cambiare il tuo contesto attuale, puoi farlo con Kubernetes Explorer, accessibile dal riquadro della barra laterale a destra oppure utilizzando Strumenti > Cloud Code > Kubernetes > Visualizza Cluster Explorer.

Per ottimizzare il ciclo di sviluppo raccogliendo rapidamente le modifiche dei file di un determinato tipo senza dover ricreare un'immagine, puoi abilitare la sincronizzazione e il ricaricamento a caldo dei file.

Configurazione

Quando utilizzi la configurazione di esecuzione Cloud Code: sviluppa su Kubernetes, puoi personalizzare il deployment configurando le impostazioni disponibili.

Per aggiungere o modificare le configurazioni, vai a Esegui > Modifica configurazioni.

Opzioni di archiviazione delle immagini container

Se hai scelto un cluster remoto come contesto, scegli un registro di immagini in cui eseguire il push delle immagini. Vai a Esegui > Modifica configurazioni per impostare il registro di immagini in Configurazioni di esecuzione/debug.

Per ulteriori dettagli, consulta la guida all'archiviazione dell'immagine container.

Impostazioni build

Cloud Code supporta i tipi di artefatti Docker, Jib e Buildpacks. Consulta la guida alle preferenze per la creazione di immagini container per scoprire come impostare il generatore preferito e le relative impostazioni pertinenti.

Personalizza la configurazione del lancio

Per configurare la modalità di esecuzione dell'applicazione, puoi personalizzare il file skaffold.yaml.

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

Per saperne di più sulla personalizzazione della configurazione del lancio, consulta Kubernetes in Cloud Code.

Nota: Cloud Code è progettato per funzionare con Cloud Build. Per creare un'applicazione esistente utilizzando l'infrastruttura Google Cloud, consulta la documentazione di Skaffold per Cloud Build.

esegui l'applicazione

Dopo aver configurato un'applicazione, puoi eseguirla su un cluster Kubernetes e visualizzarla in tempo reale utilizzando skaffold dev. Puoi eseguire la tua applicazione su un cluster locale (come minikube o Docker Desktop), Google Kubernetes Engine o qualsiasi altro cloud provider.

Nota: se lavori con un cluster Autopilot privato, potresti riscontrare un errore di pull delle immagini quando esegui il pull di un'immagine all'esterno del registro delle immagini per il tuo progetto, ad esempio utilizzando Docker Hub. Per risolvere il problema, puoi ospitare l'immagine su Container Registry o fornire accesso a internet in uscita per i tuoi nodi privati.

1. Fai clic sull'icona Esegui in corrispondenza dell'azione di esecuzione che preferisci. Potrai quindi visualizzare i log delle applicazioni in entrata nella finestra di output della scheda Log.

   All'avvio del deployment, vedrai l'elenco delle porte di inoltro per l'applicazione di cui è stato eseguito il deployment.

2. Una volta completato il deployment, riceverai una notifica che indica la disponibilità di nuovi URL di servizio. Fai clic sulla scheda URL di servizio per visualizzare gli URL, quindi fai clic sul link dell'URL per aprire il browser con l'applicazione in esecuzione.

   In alternativa, puoi aprire il Log eventi e fare clic sul link per aprire il browser con l'applicazione in esecuzione.

   Il riquadro Risorse di cui è stato eseguito il deployment mostra gli elementi di cui hai eseguito il deployment durante la sessione di sviluppo.

visualizza i log

Oltre a visualizzare i log dei pod in esecuzione come live streaming nell'output del terminale durante lo sviluppo e l'esecuzione dell'applicazione, puoi visualizzare i log di un pod specifico accedendo a Kubernetes Explorer.

Per visualizzare i log di un pod specifico:

1. Vai a Kubernetes Explorer. Puoi accedere dal riquadro laterale a destra o utilizzando Strumenti > Cloud Code > Kubernetes > Visualizza Cluster Explorer.

2. Seleziona il pod di cui vuoi visualizzare i log.

3. Fai clic con il tasto destro del mouse sul pod, quindi fai clic su Avvia flusso di log. In alternativa, puoi trasmettere i flussi di log per i singoli container in esecuzione nei pod.

   I log vengono visualizzati nella console di Kubernetes Explorer.

Apporta modifiche, ricrea e pulisci

Se la modalità di visualizzazione è impostata su On demand nella configurazione del lancio e vuoi apportare modifiche all'applicazione, quindi ricreare ed eseguire nuovamente il deployment dell'applicazione:

1. Apporta e salva le modifiche.

2. Fai clic sull'icona Crea e implementa il trigger o premi Option + Ctrl/Cmd + Comma per ricreare l'applicazione ed eseguirne nuovamente il deployment.

3. Per interrompere l'esecuzione dell'applicazione, fai clic sull'icona Arresta o premi Ctrl/Cmd + F2.

Dopo aver arrestato l'applicazione, tutte le risorse Kubernetes di cui è stato eseguito il deployment vengono eliminate dal cluster. Puoi modificare questo comportamento utilizzando il flag cleanUp nella configurazione del lancio.

Archivia secret

Se il tuo codice include dati potenzialmente sensibili come chiavi API, password e certificati, ti consigliamo di archiviarli come secret. Con Cloud Code, puoi archiviare in modo sicuro questi secret in Secret Manager e recuperarli in modo programmatico quando ne hai bisogno.

Per informazioni dettagliate su come creare e gestire i secret con Cloud Code, consulta la guida di Secret Manager.

Visualizza dettagli risorsa

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.

Consulta la panoramica di Kubernetes per ulteriori informazioni sulla visualizzazione dei dettagli delle risorse.

Passaggi successivi

• Esplora le opzioni di build a tua disposizione con buildpack, Jib o Docker.
• Utilizza sincronizzazione file e ricaricamento a caldo per accelerare lo sviluppo.
• Scopri di più sull'assistenza per la modifica YAML di Cloud Code.

Richiedi 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 oppure fai una domanda su Stack Overflow.