Introdução ao Cloud Code for 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 com base em um modelo

O Cloud Code inclui uma coleção de modelos de amostras 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. Acesse 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.

Usar 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 app, 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.

Defina 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 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 imagens em Run/Debug Configurations.

Para mais detalhes, consulte o guia sobre como armazenar a imagem do contêiner.

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 a forma como o aplicativo é executado, personalize o arquivo skaffold.yaml.

Também é possível definir a inicialização nas configurações de execução/depuração. Para editar suas configurações, acesse Run > Edit settings.

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, poderá encontrar um erro de extração de imagem ao extrair uma imagem fora do registro do projeto, por exemplo, ao usar o Docker Hub. Para resolver esse problema, hospede a imagem no Container Registry ou forneça acesso de saída à Internet para seus nós particulares.

1. Clique no ícone "Executar" na ação de execução de sua 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 de serviço para visualizar os URLs e, em seguida, clique no link de 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.

Mostrar 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 em Ferramentas > Cloud Code > Kubernetes > Ver 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 observação estiver definido como Sob demanda na configuração de inicialização e você quiser fazer alterações no aplicativo e, em seguida, recriar e reimplantar o aplicativo:

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

2. Clique no ícone Acionar criação 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 de interromper o aplicativo, todos os recursos do Kubernetes implantados são excluídos do cluster. Você pode mudar esse comportamento usando a sinalização cleanUp na sua configuração de inicialização.

Armazenar secrets

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, 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

• Explore suas opções de criação 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 de YAML do Cloud Code.

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.