Esta página foi traduzida pela API Cloud Translation.
Switch to English

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ê receberá uma solicitação para ajudar a configurá-lo:

  • Caso seu projeto tenha um Dockerfile, esteja configurado para Jib ou seja compilado usando pacotes e tenha recursos do Kubernetes, o Cloud Code solicitará que você crie um skaffold.yaml (caso ainda não exista), bem como as configurações de execução necessárias.

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

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

    Se não for possível criar a configuração automática do Skaffold devido à detecção de várias imagens ou criadores, o Cloud Code exibirá uma caixa de diálogo solicitando a exibição de 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 do menu Adicionar suporte do Kubernetes:

  • Navegue até Ferramentas > Cloud Code > Kubernetes e selecione Adicionar suporte do Kubernetes. Essa opção analisa os recursos do Kubernetes do projeto e gera um arquivo skaffold.yaml, se ainda não houver um, e 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, você poderá começar a executar e depurar seu projeto 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 existente ao projeto.

Para criar um YAML do Skaffold manualmente, siga estas instruções para aproveitar o suporte de 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 do modelo ativo 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: {}
    
  • 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 de contêiner estã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 de contêiner, consulte o guia Como configurar as 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 (Edit Configurations... > Desenvolver no Kubernetes ou Executar no Kubernetes), defina as configurações da compilação para o perfil padrão.

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

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

Como receber suporte

Acesse o GitHub para enviar feedback e informar problemas ou o Stack Overflow (ambos em inglês) para fazer perguntas.