Usa un'applicazione esistente in Cloud Code for IntelliJ

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:

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

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

    Specifica le impostazioni di build da utilizzare nella configurazione Skaffold

    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.

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

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

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

    Utilizzo del modello YAML di Skaffold

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

  4. Dopo che Cloud Code ha stabilito che il file skaffold.yaml è valido, fai clic sul prompt per creare le configurazioni di esecuzione di Kubernetes.

    Crea una notifica relativa al target 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.

Repository di immagini predefinito nella configurazione di esecuzione impostato con "gcr.io/" e vengono presentate le opzioni di completamento automatico in base al progetto attuale e al cluster attivo

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.

Impostazioni di compilazione visualizzate nella scheda Compila/Esegui il deployment

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

Assistenza

Per inviare 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. fai una domanda su Stack Overflow.