Usa un'applicazione esistente in Cloud Code for IntelliJ

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:

Notifica con un link per creare le configurazioni di esecuzione di Cloud Code Kubernetes

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

    Specifica le impostazioni di build da utilizzare nella configurazione Skaffold

    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.

  2. 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:

  1. Crea un nuovo file denominato skaffold.yaml nella directory radice del progetto (fai clic con il tasto destro del mouse > Nuovo > File).

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

    Utilizzo del modello YAML Skaffold

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

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

    Crea una notifica di destinazione 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.

Repository di immagini predefinito nella configurazione di esecuzione impostato con il formato "gcr.io/" e con opzioni di completamento automatico in base al progetto corrente e al cluster attivo

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.

Impostazioni di build visualizzate nella scheda Build/Deploy

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

Ricevi assistenza

Per inviare feedback o segnalare un problema relativo al tuo IDE IntelliJ, vai a Strumenti > Cloud Code > Guida / Informazioni > Invia feedback o segnala un problema per segnalare un problema relativo a GitHub oppure poni una domanda su Stack Overflow.