Usar um aplicativo existente no Cloud Code for IntelliJ

Se você já tiver um projeto configurado com manifestos do Kubernetes, um Dockerfile ou Jib para criar as imagens, abra e use-o com o plug-in. A única configuração extra necessária é um arquivo YAML do Skaffold, que pode ser gerado automaticamente ou criado usando o modelo fornecido.

Depois de configurar o YAML do Skaffold, especifique onde as imagens de contêiner são armazenadas para onde a imagem do projeto está prestes a ser enviada.

Inicialização automática de projetos

O projeto precisa ter um ou mais manifestos do Kubernetes. Se o Cloud Code detectar qualquer manifesto do Kubernetes no projeto, ele tentará inicializar.

Se o Cloud Code não detectar uma configuração do Skaffold atual, será solicitado que você o ajude a defini-lo.

Pré-requisitos

Seu projeto precisa atender aos seguintes pré-requisitos para que seja solicitado que você crie um arquivo skaffold.yaml e execute as configurações necessárias:

  • (Opção 1) Seu projeto tem um Dockerfile e está configurado para o Jib.

  • (Opção 2) Seu projeto pode ser compilado usando o Buildpacks e tem recursos do Kubernetes.

Definir a configuração de execução do Kubernetes

Se os pré-requisitos forem atendidos, o Cloud Code solicitará uma notificação para criar um arquivo skaffold.yaml (se ainda não houver um) e as configurações de execução necessárias:

Notificação com um link para criar as configurações de execução do Kubernetes do Cloud Code

  1. Clique na notificação. Se possível, a configuração será criada automaticamente.

    Se a criação automática da configuração do Skaffold não for possível devido à detecção de várias imagens ou builders, o Cloud Code exibirá uma caixa de diálogo solicitando que você forneça mapeamentos entre as imagens e os builders detectados.

    Especificar as configurações de criação a serem usadas na configuração do Skaffold

    Também é possível definir uma configuração do Skaffold em:Ferramentas >Cloud Code >Kubernetes e ao selecionarAdicionar compatibilidade com o Kubernetes de dados.

    Essa opção analisa os recursos do Kubernetes do projeto e gera um arquivo skaffold.yaml (se ainda não houver), bem como as configurações de execução necessárias. As duas configurações de execução geradas incluem uma para executar o projeto no Kubernetes e outra para o desenvolvimento em um cluster do Kubernetes.

  2. Depois que o suporte for adicionado, comece a executar e depurar imediatamente seu projeto no Kubernetes usando as configurações de execução recém-adicionadas.

Criar manualmente uma configuração do Cloud Code Skaffold

É possível criar manualmente um novo arquivo skaffold.yaml ou adicionar um existente ao projeto.

Para criar um arquivo skaffold.yaml manualmente usando modelos em tempo real, siga estas etapas:

  1. Crie um novo arquivo chamado skaffold.yaml no diretório raiz do projeto (clique com o botão direito do mouse > New > File).

  2. Com o cursor no novo arquivo, use Ctrl+Space para exibir as sugestões do modelo ativo e escolha o modelo Skaffold que você quer.

    Como usar o modelo YAML do Skaffold

  3. Preencha o campo de imagem com o nome da imagem do projeto e o campo de manifestos com uma lista dos recursos do Kubernetes que você quer implantar do ambiente de desenvolvimento integrado.

  4. Depois que o Cloud Code determinar que o arquivo skaffold.yaml é válido, clique no prompt para criar configurações de execução do Kubernetes.

    Criar notificação de objetos de execução do Kubernetes

Exemplos de configurações do Cloud Code Skaffold

  • Builds com base em Dockerfile:

    build:
      artifacts:
        - image: image_name
    deploy:
      kubectl:
        manifests:
          - k8s/web.yaml
          - k8s/backend.yaml
    
  • Seção de build para projetos Java Maven/Gradle com o plug-in Jib (a seção de implantação permanece igual ao exemplo acima):

    build:
    artifacts:
    - image: image_name
      jib: {}
    
  • Se você quiser definir configurações de compilação, teste e implantação para diferentes contextos, é possível ter perfis distintos. Veja um exemplo de um perfil do Cloud Build para configurar o Cloud Code para criar imagens com o Cloud Build:

    profiles:
    # use the cloudbuild profile to build images using Google Cloud Build
    - name: cloudbuild
      build:
        googleCloudBuild: {}
    
  • Se você quiser implantar seu projeto com o Helm, consulte a documentação do Helm.

Como especificar onde as imagens de contêiner são armazenadas

Armazenamento de imagens de contêiner

Antes de implantar o aplicativo, é preciso definir um repositório de imagens padrão para usar com seu projeto.

Por padrão, o projeto é configurado para usar o nome da imagem especificado nos manifestos do Kubernetes. Também é possível personalizar essa especificação de imagem. Depois de configurar o repositório de sua preferência (Artifact Registry, Container Registry, DockerHub, repositório particular etc.), edite as configurações de execução e especifique-o como um repositório de imagens padrão nas configurações de execução. Para imagens do Google Container Registry, o campo vem preenchido automaticamente para ajudar a encontrar seu repositório do Container Registry mais rapidamente.

Elas podem ser acessadas na caixa de diálogo "Executar/Depurar configurações" na barra de tarefas superior, em Editar configurações > Desenvolver no Kubernetes > Repositório de imagens.

Repositório de imagens padrão na configuração de execução definido com o formato "gcr.io/" e opções de preenchimento automático apresentadas com base no projeto atual e no cluster ativo

Para mais informações sobre como especificar suas preferências de imagem de contêiner, consulte o guia Como definir configurações de imagem de contêiner.

Configurações da versão

Depois de definir a imagem do contêiner, é possível definir as configurações de criação. O Cloud Code é compatível com tipos de artefato do Docker, Jib e Buildpacks.

Na guia Criar / implantar das configurações de execução Editar configurações > Desenvolver no Kubernetes), defina as configurações do build no perfil padrão.

Configurações da versão exibidas na guia "Criar/Implantar"

Para saber mais sobre como especificar as configurações de build para sua imagem, consulte o guia Como configurar as preferências de build de imagem de contêiner.

A seguir

Receba ajuda

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Help / About > Envie feedback ou informe um problema para informar um problema no GitHub ou faça uma pergunta no Stack Overflow.