Guia de início rápido: como executar um aplicativo do Kubernetes com o Cloud Code

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

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

Também é possível usar um cluster hospedado em qualquer outra plataforma de nuvem ou um cluster local do Kubernetes com ferramentas como minikube e Docker Desktop.

Como instalar o plug-in

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

  1. Instale o ambiente de desenvolvimento integrado do JetBrains versão 2020.3 ou mais recente (como IntelliJ Ultimate/Comunidade, PyCharm Professional/Comunidade, WebStorm, GoLand, caso ainda não tenha feito isso.

  2. Se você estiver executando o Cloud Code em um silicone da série M M, receberá uma solicitação parainstalar 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.

  3. Para todas as plataformas em nuvem, verifique se o cliente Docker (autenticado com o registro do Docker) está instalado no PATH da máquina. A 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 Cloud SDK.

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

  5. Quando o ambiente de desenvolvimento integrado estiver aberto, atualize esta página.

    Agora é possível instalar o plug-in do Cloud Code clicando diretamente no botão abaixo:

    O botão inicia uma caixa de diálogo de instalação no ambiente de desenvolvimento integrado aberto. Clique em OK para configurar o Cloud Code.

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 minikube gerenciado pelo Cloud Code na próxima etapa, desenvolver seu 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).

    Repositório de imagens padrão na configuração de execução definido com o formato "gcr.io/" e opções de preenchimento automático apresentadas com base no projeto atual e no cluster ativo

  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.

    Como selecionar o contexto de implantação do Kubernetes em uma configuração do Kubernetes do Cloud Code

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

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

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

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

    Ícone do botão de execução para iniciar o ciclo de desenvolvimento no cluster do Kubernetes.

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

    Após o início da implantação, você verá a lista de portas encaminhadas do 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

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 é pausada nessa linha desejada.

    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 executar o aplicativo

Para executar um aplicativo no Kubernetes:

  1. Verifique se você definiu onde as imagens de contêiner são armazenadas para Executar 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 você está configurado para implantar o app no contexto de sua preferência.

    Escolha Edit Configurations... no seletor de configuração Run/Debug na barra de navegação. Na guia "Run" da sua configuração do Run on Kubernetes, você pode especificar sua preferência de implantação.

  3. Agora que o aplicativo está pronto para implantação, escolha Executar no Kubernetes no seletor de configuração de execução/depuração na barra de navegação para implantar o aplicativo.

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

  4. Clique em Run on Kubernetes Ícone do botão de execução.

  5. Assim como no desenvolvimento no Kubernetes, é possível ver os registros do aplicativo recebidos na janela de saída na guia Registros.

  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 alternativa, é possível abrir o Log de eventos e clicar no link para abrir o navegador com o aplicativo em execução ou acessar http://localhost:{number-number} para acessar. seu aplicativo recém-implantado

    Aplicativo em http://localhost:{port-number} exibindo "Olá mundo!"

Como ver registros

Além de ver uma transmissão ao vivo dos registros dos pods em execução na saída do terminal, à medida que você desenvolve e executa 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.

    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 no pod e selecione Fazer streaming de registros. 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

Como limpar

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 para este guia de início rápido e clique no ícone de lixeira ao lado dele.

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

A seguir

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

Você também pode participar do canal #cloud-code, que faz parte da comunidade do Google Cloud no Slack.