Se hai già configurato un progetto con manifest Kubernetes, un Dockerfile o Jib per creare le tue 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.
Dopo aver configurato il codice YAML Skaffold, assicurati di specificare dove vengono archiviate le immagini container dove verrà eseguito il push dell'immagine del progetto.
bootstrap automatico del progetto
Il progetto deve avere uno o più manifest 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 aiutare a configurarla.
Prerequisiti
Il tuo progetto deve soddisfare i seguenti prerequisiti affinché ti venga richiesto di creare un file skaffold.yaml
ed eseguire le configurazioni necessarie:
(Opzione 1) Il progetto dispone di un Dockerfile ed è configurato per Jib oppure
(Opzione 2) Il progetto può essere creato utilizzando Buildpacks e dispone di risorse Kubernetes.
Imposta la configurazione dell'esecuzione di Kubernetes
Se i prerequisiti sono soddisfatti, Cloud Code ti invierà una notifica per creare un file skaffold.yaml
(se non ne esiste già uno) e le eventuali configurazioni di esecuzione necessarie:
Fai clic sulla notifica. In questo modo, se possibile, viene creata automaticamente la configurazione.
Se la creazione automatica della configurazione Skaffold non è possibile a causa del rilevamento di più immagini o builder, Cloud Code mostrerà una finestra di dialogo in cui ti verrà chiesto di fornire le mappature tra le immagini e i builder rilevati.
In alternativa, puoi anche impostare una configurazione Skaffold andando a Strumenti > Cloud Code > Kubernetes e selezionando Aggiungi supporto Kubernetes.
Questa opzione analizza le risorse Kubernetes del progetto e genera un file
skaffold.yaml
(se non ne esiste già uno) e le configurazioni di esecuzione necessarie. Le due configurazioni di esecuzione generate includono una per l'esecuzione del progetto su Kubernetes e l'altra per lo sviluppo su un cluster Kubernetes.Una volta aggiunto il supporto, puoi iniziare a eseguire e a eseguire il debug del tuo progetto su Kubernetes utilizzando le configurazioni di esecuzione appena aggiunte.
Creare manualmente una configurazione Cloud Code Skaffold
Puoi scegliere di creare manualmente un nuovo file skaffold.yaml
o aggiungerne
uno esistente al 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 principale del progetto (fai clic con il tasto destro del mouse su > Nuovo > File).Con il cursore nel nuovo file, premi
Ctrl+Space
per visualizzare i suggerimenti per i modelli attivi, quindi scegli il modello Skaffold desiderato.Compila il campo Image con il nome dell'immagine del progetto e nel campo Manifest con un elenco delle risorse Kubernetes di cui vuoi eseguire il deployment dall'IDE.
Dopo che Cloud Code avrà determinato che il file
skaffold.yaml
è valido, fai clic sulla richiesta per creare le configurazioni di esecuzione di Kubernetes.
Esempi di configurazioni di Cloud Code Skaffold
Build basate su Dockerfile:
build: artifacts: - image: image_name deploy: kubectl: manifests: - k8s/web.yaml - k8s/backend.yaml
Crea una sezione per i progetti Java Maven/Gradle con il plug-in Jib (la sezione per il deployment rimane la stessa dell'esempio precedente):
build: artifacts: - image: image_name jib: {}
Se vuoi definire configurazioni di build, test e deployment per contesti diversi, puoi avere profili diversi. Ecco un esempio di un 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 progetto con Helm, consulta la documentazione di Helm.
Specificare dove vengono archiviate le immagini container
Archiviazione delle immagini container
Prima di eseguire il deployment dell'applicazione, devi definire un repository di immagini predefinito da utilizzare con il progetto.
Per impostazione predefinita, il progetto è configurato per utilizzare il nome dell'immagine specificato nei manifest Kubernetes. Puoi anche personalizzare questa specifica dell'immagine. Dopo aver configurato il 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 dell'esecuzione. Per le immagini di Google Container Registry, il campo è dotato di completamento automatico per aiutarti a trovare più rapidamente il repository di Container Registry.
Sono accessibili dalla finestra di dialogo di esecuzione/debug delle configurazioni nella barra delle attività in alto in Modifica configurazioni > Sviluppo su Kubernetes > Repository di immagini.
Per saperne di più sulla specifica delle preferenze per le immagini container, consulta la guida alla configurazione delle impostazioni delle immagini container.
Impostazioni build
Dopo aver impostato l'immagine container, puoi configurarne le impostazioni di build. Cloud Code supporta i tipi di artefatti Docker, Jib e Buildpacks.
Nella scheda Crea / Esegui il deployment delle impostazioni di configurazione Esegui (Modifica configurazioni > Sviluppa su Kubernetes), puoi configurare le impostazioni della build per il tuo profilo predefinito.
Per ulteriori informazioni sulla specifica delle impostazioni di build per l'immagine, consulta la guida alle preferenze per la creazione di immagini container.
Passaggi successivi
- Utilizza la sincronizzazione file e il ricaricamento a caldo per velocizzare lo sviluppo.
- Esegui il debug dell'applicazione in Cloud Code.