Começar a usar o Cloud Code para IntelliJ para Kubernetes

O Cloud Code permite criar um aplicativo do Kubernetes com base em uma amostra ou de um projeto atual.

Criar um aplicativo a partir de um modelo

O Cloud Code vem com uma coleção de exemplos de código para você começar rapidamente. Para criar um aplicativo do Kubernetes usando uma amostra existente, siga estas etapas:

1. Acesse Arquivo > Novo projeto.
2. Selecione Cloud Code: Kubernetes.
3. Selecione um modelo na lista de aplicativos iniciais.

4. Escolha um nome para seu projeto.

   Depois de clicar em Concluir, o Cloud Code clonará o modelo escolhido e abrirá o projeto recém-criado para uso.

   Para modelos Java, será necessário importar projetos Maven para sincronizar seu pom.xml. Clique em "Adicionar como projeto Maven". Além disso, importe os projetos Maven necessários ao clicar em "Importar alterações".

5. Os destinos de execução do ambiente de desenvolvimento integrado e de desenvolvimento do Kubernetes para o projeto são criados automaticamente e prontos para execução.

   Opcional: também é possível criar manualmente os destinos de execução:

   1. Selecione a lista suspensa Run Configuration e clique em Edit Configurations.
   2. Clique em + Add New Configuration para adicionar uma nova configuração de execução.
   3. Navegue até Cloud Code: Kubernetes
   4. Insira um nome para a nova configuração (o padrão é "Sem nome").
   5. Clique em OK para criar seu destino de execução.
   Observação: se você tiver feito login no Google Cloud no seu ambiente de desenvolvimento integrado e tiver um projeto padrão definido, o Cloud Code usará seu contêiner padrão. repositório de imagens. Para especificar uma imagem de contêiner diferente, siga as Configurações de imagem do contêiner.

Usar seu próprio aplicativo

Para conferir as etapas de uso de um projeto atual, consulte Usar o Cloud Code com um aplicativo do Kubernetes.

Observação: para desenvolver e testar um aplicativo, crie e execute o aplicativo em um cluster que não seja de produção.
Para alterações que serão lançadas para produção, use um fluxo de trabalho automatizado de CI/CD.

Definir o contexto do Kubernetes

Antes de executar o aplicativo, verifique se você está configurado para implantar o aplicativo no contexto de sua preferência. É possível especificar isso na sua configuração.

Se você quiser alternar seu contexto atual, use o Kubernetes Explorer, acessível no painel da barra lateral à direita ou usando Ferramentas > Cloud Code > Kubernetes > Ver explorador de clusters.

Para otimizar seu loop de desenvolvimento escolhendo rapidamente as alterações de arquivo de um determinado tipo sem precisar recriar uma imagem, você pode ativar a sincronização de arquivos e a recarga dinâmica.

Configuração

Ao usar a configuração de execução Cloud Code: Develop on Kubernetes, é possível personalizar a implantação definindo as configurações disponíveis.

Para adicionar ou editar configurações, acesse Executar > Editar configurações.

Opções de armazenamento de imagens de contêiner

Se você escolheu um cluster remoto como contexto, escolha um registro de imagem para enviar as imagens. Acesse Executar > Editar configurações para definir o registro de imagem nas Configurações de execução/depuração.

Consulte o guia sobre como armazenar sua imagem do contêiner para mais detalhes.

Configurações da versão

O Cloud Code é compatível com tipos de artefato do Docker, Jib e Buildpacks. Consulte o guia Como configurar as preferências de criação de imagens de contêiner para saber como definir o builder preferencial e as configurações relevantes.

Personalizar a configuração de inicialização

Para configurar como o aplicativo é executado, personalize o arquivo skaffold.yaml.

Também é possível configurar a inicialização nas Configurações de execução/depuração. Para editar as configurações, acesse Executar > Editar configurações.

Para mais informações sobre como personalizar a configuração de inicialização, consulte o Kubernetes no Cloud Code.

Observação: o Cloud Code foi criado para funcionar com o Cloud Build. Para criar um aplicativo atual usando Google Cloud infraestrutura, consulte a documentação do Skaffold para o Cloud Build.

Execute o aplicativo

Depois de configurar um aplicativo, é possível executá-lo em um cluster do Kubernetes e visualizá-lo ao vivo, aproveitando skaffold dev. É possível executar o aplicativo em um cluster local (como Minikube ou Docker Desktop), Google Kubernetes Engine ou qualquer outro provedor de nuvem.

**Observação**: se você estiver trabalhando com um cluster privado do Autopilot, poderá encontrar um erro de extração de imagem ao extrair uma imagem fora do registro de imagens para seu projeto, como ao usar o Docker Hub. Para resolver esse problema, é possível hospedar a imagem no Artifact Registry ou fornecer acesso de saída à Internet para os nós particulares.

1. Clique no ícone "Executar" na sua ação de preferência. Veja os registros do aplicativo recebidos na janela de saída na guia Registros.

   Após o início da implantação, você verá a lista de portas encaminhadas do aplicativo implantado.

2. Após a conclusão da implantação, você receberá uma notificação de que novos URLs de serviço estão disponíveis. Clique na guia URLs do serviço para visualizar os URLs e, em seguida, clique no link do URL para abrir o navegador com o aplicativo em execução.

   Como alternativa, é possível abrir o Log de eventos e clicar no link para abrir o navegador com o aplicativo em execução.

   O painel Recursos implantados mostra o que você implantou durante a sessão de desenvolvimento.

Ver registros

Além de ver os registros de pods em execução como uma transmissão ao vivo na saída do terminal enquanto você está desenvolvendo e executando o aplicativo, é possível ver os registros de um pod específico navegando até o Kubernetes Explorer.

Para ver os registros de um pod específico, siga estas etapas:

1. Navegue até o Kubernetes Explorer. Ele pode ser acessado no painel lateral à direita ou usando Ferramentas > Cloud Code > Kubernetes > Visualizar o Cluster Explorer.

2. Selecione o pod do qual você quer ver os registros.

3. Clique com o botão direito do mouse no pod e clique em Fazer streaming de registros. Como alternativa, é possível transmitir registros de contêineres individuais executados em pods.

   O Console do Kubernetes Explorer exibe os registros.

Fazer alterações, recriar e limpar

Se o modo de exibição estiver definido como Sob demanda na configuração de inicialização e você quiser fazer alterações no aplicativo e recriá-lo e reimplantá-lo:

1. Faça e salve as alterações.

2. Clique no ícone Acionar build e implantação ou pressione Option + Ctrl/Cmd + Comma para recriar e reimplantar o aplicativo.

3. Para interromper a execução do aplicativo, clique no ícone Parar ou pressione Ctrl/Cmd + F2.

Depois que você interrompe o aplicativo, todos os recursos implantados do Kubernetes são excluídos do cluster. É possível alterar esse comportamento usando a cleanUp flag na configuração de inicialização.

Armazenar secrets

Se o código inclui dados sensíveis, como chaves de API, senhas e certificados, é recomendável armazená-los como secrets. O Cloud Code permite armazenar esses secrets com segurança no Gerenciador de secrets e buscá-los de maneira programática quando precisar deles.

Para uma visão detalhada de como criar e gerenciar secrets com o Cloud Code, consulte o guia do Secret Manager.

Conferir detalhes do recurso

O Kubernetes Explorer exibe clusters, namespaces, nós, cargas de trabalho (como implantações, réplicas, pods e contêineres), serviços e entradas, configurações (como secrets e mapas de configuração) e armazenamento (como volumes). Com o Kubernetes Explorer, é possível executar ações exclusivas em alguns desses recursos.

Consulte a visão geral do Kubernetes para mais informações sobre como conferir detalhes do recurso.

A seguir

• Confira as opções de build com buildpacks, Jib ou Docker.
• Use a sincronização de arquivos e a recarga dinâmica para acelerar o desenvolvimento.
• Saiba mais sobre a assistência de edição YAML do Cloud Code.

Receber suporte

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Ferramentas > Cloud Code > Ajuda / Sobre > Enviar feedback ou informar um problema para informar um problema no GitHub.