Se hai già un progetto configurato con manifest di Kubernetes, un Dockerfile o Jib per compilare le immagini, puoi aprirlo e utilizzarlo con il plug-in. L'unica configurazione aggiuntiva necessaria è un file YAML di Skaffold che può essere generato automaticamente o creato utilizzando il modello fornito.
Dopo aver configurato il tuo YAML Skaffold, assicurati di specificare dove le immagini container sono archiviate in cui verrà eseguito il push dell'immagine del progetto.
Bootstrap del progetto automatico
Il progetto deve avere uno o più manifest Kubernetes. Se Cloud Code rileva qualsiasi manifest Kubernetes nel progetto, tenterà di eseguire l'avvio.
Se Cloud Code non rileva una configurazione Skaffold esistente, ti verrà chiesto di aiutarti a configurarlo.
Prerequisiti
Il progetto deve soddisfare i seguenti prerequisiti per poter creare un file skaffold.yaml
ed eseguire le configurazioni necessarie:
(Opzione 1) Il progetto ha un Dockerfile ed è configurato per Jib o
(Opzione 2) Il progetto è generabile con Buildpacks e include Kubernetes Google Cloud.
Configurare la configurazione di esecuzione di Kubernetes
Se i prerequisiti sono soddisfatti, Cloud Code ti chiederà di creare un file skaffold.yaml
(se non esiste già) e le eventuali configurazioni di esecuzione necessarie:
Fai clic sulla notifica. Se possibile, viene creata automaticamente la configurazione.
Se la creazione automatica della configurazione di Skaffold non è possibile a causa del rilevamento di più immagini o compilatori, Cloud Code mostrerà una finestra di dialogo che ti chiede di fornire le mappature tra le immagini e i compilatori rilevati.
In alternativa, puoi anche impostare una configurazione di Skaffold andando alla pagina Strumenti > Cloud Code > Kubernetes e selezionando Aggiungi Kubernetes assistenza.
Questa opzione analizza le risorse Kubernetes del tuo progetto e genera un
skaffold.yaml
(se non ne esiste già uno) ed esecuzione necessaria configurazioni. Le due configurazioni di esecuzione generate includono una da eseguire il tuo progetto su Kubernetes e uno per lo sviluppo su un cluster Kubernetes.Dopo aver aggiunto il supporto, puoi iniziare a eseguire e a eseguire il debug del progetto su Kubernetes utilizzando le configurazioni di esecuzione appena aggiunte.
Creare manualmente una configurazione Skaffold di Cloud Code
Puoi scegliere di creare manualmente un nuovo file skaffold.yaml
o di aggiungerne uno esistente
al tuo progetto.
Per creare un file skaffold.yaml
manualmente utilizzando i modelli in tempo reale:
Crea un nuovo file denominato
skaffold.yaml
nella directory radice del progetto (fai clic con il pulsante destro del mouse > Nuovo > File).Con il cursore nel nuovo file, premi
Ctrl+Space
per visualizzare i suggerimenti di modelli in tempo reale e poi scegli il modello Skaffold che preferisci.Compila il campo image con il nome dell'immagine del progetto e il campo manifest con un elenco delle risorse Kubernetes di cui vuoi eseguire il deployment dall'IDE.
Dopo che Cloud Code ha stabilito che il file
skaffold.yaml
è valido, fai clic sul prompt per creare le configurazioni di esecuzione di Kubernetes.
Esempi di configurazioni di Skaffold per Cloud Code
Build basate su Dockerfile:
build: artifacts: - image: image_name deploy: kubectl: manifests: - k8s/web.yaml - k8s/backend.yaml
Sezione di compilazione per i progetti Java Maven/Gradle con il plug-in Jib (la sezione di deployment rimane invariata rispetto all'esempio precedente):
build: artifacts: - image: image_name jib: {}
Se vuoi definire le configurazioni di build, test e deployment contesti diversi, si possono avere profili diversi. Ecco un esempio di Profilo Cloud Build per configurare Cloud Code e creare immagini con Cloud Build:
profiles: # use the cloudbuild profile to build images using Google Cloud Build - name: cloudbuild build: googleCloudBuild: {}
Se vuoi eseguire il deployment del progetto con Helm, consulta la documentazione di Helm.
Specificare dove vengono archiviate le immagini container
Spazio di archiviazione delle immagini container
Prima di eseguire il deployment dell'applicazione, devi definire un'immagine predefinita da utilizzare con il progetto.
Per impostazione predefinita, il progetto è configurato in modo da utilizzare il nome dell'immagine specificato di Kubernetes. Puoi anche personalizzare le specifiche dell'immagine. Dopo aver configurato il tuo repository preferito (Artifact Registry, Container Registry, DockerHub, repository privato e così via), modifica le configurazioni di esecuzione e specificalo come repository di immagini predefinito nelle impostazioni di configurazione di esecuzione. Per le immagini di Google Container Registry, il campo dotato del completamento automatico per aiutarti a trovare il repository di Container Registry più velocemente.
Puoi accedervi dalla finestra di dialogo Esegui/Esegui il debug delle configurazioni nella barra delle app in alto in Modifica configurazioni > Sviluppa su Kubernetes > Repository di immagini.
Per ulteriori informazioni su come specificare le preferenze per le immagini container, consulta la guida alla configurazione delle impostazioni dell'immagine container.
Impostazioni di compilazione
Dopo aver impostato l'immagine del contenitore, puoi configurarne le impostazioni di compilazione. Cloud Code supporta i tipi di artefatti Docker, Jib e Buildpacks.
Nella scheda Crea / Esegui il deployment delle impostazioni di configurazione dell'esecuzione (Modifica configurazioni > Sviluppa su Kubernetes), puoi configurare le impostazioni di creazione per il tuo profilo predefinito.
Per saperne di più su come specificare le impostazioni di compilazione per l'immagine, consulta la guida alla configurazione delle preferenze di compilazione delle immagini container.
Passaggi successivi
- Utilizza la sincronizzazione dei file e il ricaricamento rapido per velocizzare lo sviluppo.
- Esegui il debug dell'applicazione in Cloud Code.