Se hai già un progetto già configurato con i manifest di Kubernetes, un Dockerfile o un Jib per creare le immagini, puoi aprirlo e utilizzarlo con il plug-in. L'unica configurazione aggiuntiva necessaria è un file YAML Skaffold, che può essere generato automaticamente o creato utilizzando il modello fornito.
Una volta completata la configurazione del file YAML Skaffold, assicurati di specificare la posizione di archiviazione delle immagini container in cui sta per essere inviata l'immagine di progetto.
bootstrap automatico del progetto
Il progetto deve avere uno o più manifest di Kubernetes. Se Cloud Code rileva qualsiasi manifest Kubernetes nel progetto, Cloud Code proverà a eseguire il bootstrap.
Se Cloud Code non rileva una configurazione Skaffold esistente, ti verrà chiesto di farlo.
Prerequisiti
Il tuo progetto deve soddisfare i seguenti prerequisiti per ricevere la richiesta di creare un file skaffold.yaml
ed eseguire le configurazioni necessarie:
(Opzione 1) Il progetto ha un Dockerfile ed è configurato per Jib, oppure
(Opzione 2) Il progetto può essere creato utilizzando Buildpacks e dispone di risorse Kubernetes.
Imposta la configurazione di esecuzione di Kubernetes
Se i prerequisiti sono soddisfatti, Cloud Code ti chiederà di ricevere una notifica per creare un file skaffold.yaml
(se non ne esiste già uno) e tutte le configurazioni di esecuzione necessarie:
Fai clic sulla notifica. La configurazione viene creata automaticamente, se possibile.
Se non è possibile creare automaticamente configurazioni Skaffold a causa del rilevamento di più immagini o builder, Cloud Code mostra una finestra di dialogo che richiede di fornire mappature tra le immagini e i builder generati.
In alternativa, puoi impostare una configurazione Skaffold andando a Strumenti > Cloud Code > Kubernetes e selezionando Aggiungi assistenza Kubernetes.
Questa opzione analizza le risorse Kubernetes del progetto e genera un file
skaffold.yaml
(se non ne esiste già) e le configurazioni di esecuzione necessarie. Le due configurazioni di esecuzione generate includono una per eseguire il progetto su Kubernetes e una per lo sviluppo su un cluster Kubernetes.Dopo aver aggiunto il supporto, puoi iniziare a eseguire e eseguire il debug del progetto su Kubernetes utilizzando le configurazioni di esecuzione appena aggiunte.
Crea manualmente una configurazione Cloud Skaffold
Puoi scegliere di creare manualmente un nuovo file skaffold.yaml
o di aggiungerne uno esistente al tuo progetto.
Per creare manualmente un file skaffold.yaml
utilizzando i modelli in tempo reale, segui questi passaggi:
Crea un nuovo file denominato
skaffold.yaml
nella directory radice del progetto (fai clic con il tasto destro del mouse > Nuovo > File).Con il cursore nel nuovo file, premi
Ctrl+Space
per visualizzare i suggerimenti per i modelli dal vivo e scegli il modello Skaffold che preferisci.Completa il campo immagine con il nome dell'immagine del progetto e il campo manifest con un elenco delle risorse Kubernetes che vuoi eseguire il deployment dall'IDE.
Dopo che Cloud Code ha stabilito che il file
skaffold.yaml
è valido, fai clic sulla richiesta per creare le configurazioni per l'esecuzione di Kubernetes.
Esempi di configurazioni Skaffold di Cloud Code
Build basate su Dockerfile:
build: artifacts: - image: image_name deploy: kubectl: manifests: - k8s/web.yaml - k8s/backend.yaml
Crea la sezione per i progetti Java Maven/Gradle con il plug-in Jib (la sezione deploy rimane invariata come nell'esempio precedente):
build: artifacts: - image: image_name jib: {}
Se vuoi definire configurazioni di build, test e deployment per contesti diversi, puoi avere profili diversi. Di seguito è riportato un esempio di profilo Cloud Build per configurare Cloud Code per 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 tuo progetto con Helm, consulta la documentazione di Helm.
Specificare dove vengono archiviate le immagini container
Archiviazione di immagini container
Prima di eseguire il deployment dell'applicazione, dovrai definire un repository di immagini predefinito da utilizzare con il progetto.
Per impostazione predefinita, il progetto è configurato per utilizzare il nome di immagini specificato nei manifest di Kubernetes. Puoi anche personalizzare questa specifica immagine. Dopo aver configurato il repository preferito (Artifact Registry, Container Registry, DockerHub, repository privato e così via), modifica le configurazioni delle esecuzioni e specificalo come repository di immagini predefinito nelle impostazioni di configurazione delle esecuzioni. Per le immagini Google Container Registry, il campo è dotato di completamento automatico per aiutarti a trovare il repository di Container Registry più rapidamente.
Sono accessibili dalla finestra di dialogo Configurazioni di esecuzione/debug sulla barra delle applicazioni in alto in Modifica configurazioni > Sviluppa su Kubernetes > Repository di immagini.
Per scoprire di più sulla specifica delle preferenze per le immagini container, consulta la configurazione delle impostazioni delle immagini container.
Impostazioni build
Dopo aver impostato l'immagine container, puoi configurare le relative impostazioni della build. Cloud Code supporta i tipi di elementi Docker, Jib e Buildpacks.
Nella scheda Crea / Esegui il deployment delle impostazioni di configurazione di Run (Modifica configurazioni > Sviluppa su Kubernetes), puoi configurare le impostazioni di build per il tuo profilo predefinito.
Per scoprire di più sulla specifica delle impostazioni di build per l'immagine, consulta la guida alla configurazione delle preferenze di build delle immagini container.
Passaggi successivi
- Utilizza sincronizzazione di file e ricarica a caldo per velocizzare lo sviluppo.
- Eseguire il debug dell'applicazione in Cloud Code.