Usa un'applicazione esistente in Cloud Code for IntelliJ

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:

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

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

    Specifica le impostazioni di build da utilizzare nella configurazione Skaffold

    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.

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

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

  2. Con il cursore nel nuovo file, premi Ctrl+Space per visualizzare i suggerimenti per i modelli attivi, quindi scegli il modello Skaffold desiderato.

    Utilizzo del modello YAML Skaffold

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

  4. Dopo che Cloud Code avrà determinato che il file skaffold.yaml è valido, fai clic sulla richiesta per creare le configurazioni di esecuzione di Kubernetes.

    Creazione della notifica relativa alla destinazione 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.

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

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.

Impostazioni di build visualizzate nella scheda Build/Deployment

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

Ricevi 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 oppure fai una domanda su Stack Overflow.