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 exemplo 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.

Use seu próprio aplicativo

Para saber como usar um projeto, consulte Usar o Cloud Code com um aplicativo do Kubernetes.

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 Cloud Code: desenvolver no Kubernetes, é possível personalizar sua 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 imagem para enviar por push as imagens. Acesse Executar > Editar configurações para definir o registro de imagens nas suas Configurações de execução/depuração.

Consulte a guia sobre como armazenar sua imagem de 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 skaffold.yaml.

Também é possível configurar a inicialização nas configurações de execução/depuração. Para editar suas configurações, vá para Executar > Editar configurações.

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

Execute o aplicativo

Depois de configurar um aplicativo, você pode executá-lo em um cluster do Kubernetes e 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.

  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, depois 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 mudanças, recriar e limpar

Se o modo de exibição estiver definido como Sob demanda em sua configuração de inicialização e você quiser para fazer alterações no aplicativo e, em seguida, recriar e reimplantar a aplicativo:

  1. Faça e salve as mudanças.

  2. Clique no ícone Trigger Build and Deploy 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.

Após a interrupção do aplicativo, todos os recursos do Kubernetes implantados são excluído do cluster. Para mudar esse comportamento, use o método cleanUp na 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 mostra clusters, namespaces, nós e 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 esses recursos.

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

A seguir

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.