Como usar um aplicativo atual

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

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

Inicialização automática de projetos

Se o Cloud Code não detectar uma configuração existente do Skaffold, você será solicitado a ajudá-lo a defini-la:

  • Se o projeto tiver um Dockerfile, estiver configurado para Jib ou puder ser criado com pacotes de criação e recursos do Kubernetes, o Cloud Code exibirá uma notificação para criar um. skaffold.yaml, se ainda não houver, 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

  • Ao clicar nessa notificação, sua configuração será criada automaticamente, se possível.

    Se a criação automática de configuração 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 mapeamentos entre as imagens e os criadores detectados.

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

Como alternativa, você também pode definir uma configuração do Skaffold usando a opção de menu "Add Kubernetes Support":

  • Navegue até Ferramentas > Cloud Code > Kubernetes e selecione Adicionar suporte do Kubernetes. Essa opção analisa os recursos do Kubernetes do seu 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 seu projeto no Kubernetes e uma para desenvolvimento em um cluster do Kubernetes.
  • Depois que o suporte for adicionado, será possível começar a executar e depurar o projeto imediatamente no Kubernetes usando as configurações de execução recém-adicionadas.

Como criar a configuração do Cloud Code Skaffold manualmente

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

Para criar um YAML do Skaffold manualmente, siga estas instruções para aproveitar o suporte a modelos ao vivo:

  • Crie um novo arquivo chamado skaffold.yaml no diretório raiz do projeto. Para isso, clique com o botão direito em > New > File.
  • Com o cursor no novo arquivo, use Ctrl+Space para exibir as sugestões de modelo dinâmico e escolha o modelo Skaffold desejado.

    Como usar o modelo YAML do Skaffold

  • Preencha o campo de imagem com o nome da imagem do projeto e o campo de manifesto com uma lista dos recursos do Kubernetes a serem implantados no ambiente de desenvolvimento integrado.

    Exemplo para compilações baseadas no Dockerfile:

    build:
      artifacts:
        - image: image_name
    deploy:
      kubectl:
        manifests:
          - k8s/web.yaml
          - k8s/backend.yaml
    

    Exemplo de seção de criação para projetos Maven/Gradle do Java com o plug-in Jib (a seção de implantação permanece a mesma):

    build:
    artifacts:
    - image: image_name
      jib: {}
    

    Se você quiser definir configurações de criação, teste e implantação para contextos diferentes, é possível ter perfis diferentes. 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: {}
    
  • Assim que o skaffold.yaml estiver válido, o plug-in solicitará a criação de objetos de execução do Kubernetes automaticamente.

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

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 (Google Container Registry, DockerHub, repositório particular etc.), edite os destinos de execução e especifique-o como um repositório de imagens padrão na execução. configurações de segmentaçã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 > Onde as imagens do contêiner são armazenadas?.

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 as preferências de imagem do contêiner, consulte o guia Como configurar 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 "Build/Deploy" das configurações de execução do Run (Edit Configurations...). > Desenvolver no Kubernetes ou Executar no Kubernetes, é possível definir as configurações de versão do seu perfil padrão.

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

Para mais informações sobre como especificar as configurações de criação da sua imagem, consulte o guia Como configurar preferências de criação de imagem de contêiner.

Como receber suporte

Para enviar feedback, relate um problema no GitHub ou faça uma pergunta no Stack Overflow.