Primeiros passos com 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 usando um modelo

O Cloud Code vem com uma coleção de modelos de amostra de código para que você comece rapidamente. Para criar um aplicativo do Kubernetes usando uma amostra atual, 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 de contêiner.

Use seu próprio aplicativo

Para ver os passos para usar um projeto atual, consulte Usar o Cloud Code com um aplicativo atual 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 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, ative a sincronização de arquivos e a recarga dinâmica.

Configuração

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

Para adicionar ou editar configurações, acesse Run > Edit Configurations.

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

Se você escolheu um cluster remoto como contexto, escolha um registro de imagens para enviar as imagens. Acesse Run > Edit Configurations para definir o registro de imagem nas suas Run/Debug Configurations.

Consulte o guia sobre como armazenar a 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 Como configurar o guia de 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 suas configurações, acesse Executar > Editar configurações.

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

Observação: o Cloud Code foi criado para funcionar com o Cloud Build. Para criar um aplicativo atual com a infraestrutura do Google Cloud, 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 particular do Autopilot, é possível que encontre um erro de extração de imagem ao extrair uma imagem fora do registro do projeto, por exemplo, usando o Docker Hub. Para resolver esse problema, hospede a imagem no Container Registry ou forneça acesso de saída à Internet para os nós particulares.

1. Clique no ícone "Executar" na sua ação preferida. 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 Tools > Cloud Code > Kubernetes > View 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 mudanças no aplicativo e, em seguida, recriar e reimplantar o aplicativo:

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 Stop ou pressione Ctrl/Cmd + F2.

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

Armazenar segredos

Se o código inclui dados possivelmente confidenciais, 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 Gerenciador de secrets.

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 visualizar detalhes do recurso.

A seguir

• Conheça as opções de build com buildpacks, Jib ou Docker.
• Use a sincronização de arquivos e a recarga automática 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 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.