Implantar um app do Kubernetes com o Cloud Code for IntelliJ

Veja nesta página como começar a usar o Cloud Code.

Neste guia de início rápido, você irá configurar um novo aplicativo do Kubernetes usando um modelo inicial Hello World, executar o aplicativo em um cluster de sua escolha, iniciar a recriação contínua para desenvolver iterativamente seu aplicativo, depurar seu código aberto e veja os registros sendo transmitidos do aplicativo.

Antes de começar

  1. Para usar o Google Cloud, você precisará criar ou selecionar um projeto do Google Cloud e ativar o faturamento no seu projeto.

    Como alternativa, use um cluster hospedado em qualquer outra plataforma da nuvem ou em um cluster local do Kubernetes, com ferramentas como o Minikube ou o Docker Desktop.

  2. Instale o Git para que o Cloud Code possa executar operações do Git, como clonar uma amostra.

  3. Instale o plug-in do Cloud Code caso ainda não tenha feito isso.

Como criar um aplicativo

Para criar um novo aplicativo usando uma amostra existente:

  1. No seu IDE, abra Arquivo e Novo projeto e selecione Cloud Code: Kubernetes.

  2. Selecione um modelo "Hello World" na lista de aplicativos iniciais. Lista de modelos disponíveis: Python, Go, NodeJS, Java hello world e aplicativos de livro de visitas

  3. 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, você precisa importar os projetos Maven necessários para sincronizar seu pom.xml. Clique em Adicionar como projeto Maven e em Importar alterações.

Como escolher um cluster

Para desenvolver seu aplicativo, você precisará de um cluster do Kubernetes associado, hospedado localmente com o minikube ou uma plataforma de nuvem, como um cluster do Google Kubernetes Engine.

Cluster local

Se você ainda não tiver um cluster para usar neste guia de início rápido, poderá executar o aplicativo com um cluster minikube local gerenciado pelo Cloud Code. O Cloud Code inicia um cluster minikube para executar seu aplicativo e o interrompe quando a implantação é interrompida. Se um cluster do minikube já estiver em execução, o Cloud Code reutilizará esse cluster para implantação.

Você pode optar por usar esse cluster do Cloud Code gerenciado pelo Cloud Code na próxima etapa, o desenvolvimento do aplicativo, definindo-o como sua preferência de implantação.

Cluster baseado no Cloud Platform

Se você já tiver um cluster configurado para trabalhar com ferramentas do Kubernetes (como o kubectl) que possam ser usadas neste guia de início rápido, o Cloud Code implantará nele automaticamente. Prossiga para o desenvolvimento do aplicativo para confirmar que o cluster de sua preferência está definido como o contexto atual.

Se não tiver, crie uma usando as instruções específicas da plataforma da nuvem. Para o GKE, siga o guia Como criar um cluster.

Desenvolver um aplicativo

Para iniciar o desenvolvimento do aplicativo no Kubernetes:

  1. Se você estiver executando em um cluster hospedado em uma plataforma de nuvem, defina onde suas imagens de contêiner estão armazenadas para Desenvolver no Kubernetes.

    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á automaticamente o repositório de imagens do contêiner padrão (gcr.io/{project_id}, em que {project_id} faz referência ao padrão).

  2. Verifique se o contexto preferencial do Kubernetes está definido. Isso pode ser especificado na configuração do Develop no Kubernetes (acessível em Executar > Editar configurações > Desenvolver no Kubernetes). na guia "Executar" e na seção "Preferências de implantação".

    É possível implantar em um contexto atual (padrão), localmente em um cluster minikube ou em outro contexto disponível.

    Por padrão, o aplicativo Kubernetes é executado no modo sob demanda com a opção Sob demanda selecionada. Se preferir, você pode selecionar a opção Salvar no arquivo.

  3. Escolha o destino de execução Develop on Kubernetes no seletor de configuração Run/Debug na barra de navegação.

    Configurações de execução de implantação do Kubernetes

    Isso garante que todas as alterações de código sejam criadas, enviadas e implantadas automaticamente em uma nova versão do aplicativo.

  4. Para iniciar o ciclo de desenvolvimento no cluster do Kubernetes, clique na ação de execução Desenvolver no Kubernetes.

  5. Na guia Registros da janela de saída, veja os registros de aplicativos recebidos.

    Depois que a implantação for iniciada, você verá a lista de portas encaminhadas para o aplicativo implantado.

  6. Quando a implantação for bem-sucedida, você receberá uma notificação de que novos URLs de serviço estarã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 visualizar serviços encaminhados por porta na guia "URLs de serviç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.

Depuração do aplicativo

O Cloud Code é compatível com a aplicação de alterações durante a depuração.

Para depurar seu aplicativo, faça o seguinte:

  1. Clique na ação de depuração Ícone da ação de depuração para Desenvolver no Kubernetes para iniciar o ciclo de desenvolvimento no modo de depuração no cluster do Kubernetes.

    Como iniciar o ciclo de desenvolvimento do cluster do Kubernetes no modo de depuração

  2. O Cloud Code anexará uma sessão de depuração. Quando a operação for concluída, a janela da ferramenta de depuração será aberta, confirmando a conexão (na guia "Console").

    Agora é possível depurar no cluster ativo do Kubernetes.

  3. Clique na divisão na linha executável do código em que você quer adicionar um ponto de interrupção.

    Os círculos preenchidos em vermelho indicam pontos de interrupção ativos, enquanto os círculos vazios destacados em vermelho indicam pontos de interrupção desativados.

  4. Quando você envia uma nova solicitação ao aplicativo, ela é interrompida nessa linha escolhida.

    Sessão do depurador do Kubernetes

  5. Para encerrar a sessão de depuração, clique no ícone de parada na configuração de execução do Develop on Kubernetes.

Como ver registros

Além de ver uma transmissão ao vivo dos registros dos pods em execução na saída do terminal durante o desenvolvimento e a execução do 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.

    Painel do Kubernetes Explorer aberto usando a guia na barra de tarefas do lado direito

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

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

    Isso gera registros para o console do Kubernetes Explorer.

    Streaming de registros de um pod usando o menu do botão direito do mouse para gerar registros no Console do Kubernetes Explorer

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

  1. Acesse a página "Projetos" no Console do Google Cloud.

    Acessar a página "Projetos"

  2. Selecione o projeto que você criou neste guia de início rápido e clique no ícone de lixeira ao lado para excluí-lo.

    Isso encerrará o projeto e programará a remoção dele.

A seguir