Guia de início rápido: implantar um app do Kubernetes com o Cloud Code para IntelliJ

Implantar um app do Kubernetes com o Cloud Code para IntelliJ

Nesta página, mostramos 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 um exemplo.

Como instalar o plug-in

Para instalar o plug-in do Cloud Code, faça o seguinte:

  1. Instalar o IDE do JetBrains Versão 2019.2+ (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), caso ainda não tenha feito isso.

  2. Para todas as plataformas do Cloud, verifique se o cliente do Docker (autenticado com o registro do Docker) está instalado no PATH da máquina (a respectiva pasta precisa estar visível em um diretório no PATH). Para verificar se você já tem o Docker instalado, execute docker -v.

    O Cloud Code instala e gerencia automaticamente as seguintes dependências no seu ambiente de desenvolvimento integrado: minikube, kubectl, Skaffold e o Google Cloud SDK.

  3. Abra o IntelliJ IDEA ou qualquer ambiente de desenvolvimento integrado compatível do JetBrains.

  4. Depois que o ambiente de desenvolvimento integrado for aberto, atualize esta página.

  5. Para instalar o plug-in do Cloud Code, siga estas instruções:

  6. Na caixa de diálogo de instalação exibida no ambiente de desenvolvimento integrado, clique em OK para configurar o Cloud Code.

  7. Se você estiver executando o Cloud Code em um silicon série Apple M, será solicitado que você faça issoinstalar Rosetta 2 de dados. Isso permite que o Cloud Code instale o kubectl como uma dependência gerenciada.

    Se você preferir não instalar o Rosetta 2, desative as dependências gerenciadas (IntelliJ IDEA > Preferences > Tools > Cloud Code). > Dependencies) e instale sua própria versão do ARM do kubectl conforme descrito em Versões personalizadas de dependências.

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.

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 do botão de execuçã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

Limpeza

Para evitar cobranças na sua conta pelos recursos usados neste guia de início rápido, exclua o cluster e o projeto que você criou.

Se você estiver usando o Google Cloud e quiser excluir seu projeto (e os recursos associados, incluindo os clusters do GKE):

  1. Acesse a página "Projetos" no Console do 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.

Limpar

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

A seguir