Como executar um aplicativo do Kubernetes Engine com o Cloud Code

Saiba como configurar um app simples do Kubernetes, executá-lo em um cluster do Google Kubernetes Engine (GKE), visualizar e depurar o código em execução.


Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientações


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  5. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

Como criar um aplicativo

  1. Inicie o editor do Cloud Shell
  2. Na barra de status do Cloud Code, selecione Novo aplicativo.

  3. Escolha Aplicativo do Kubernetes como o tipo de aplicativo.

  4. Na lista de aplicativos de amostra (Node.js, Python com frameworks Flask e Django, Java, Go), escolha um aplicativo Hello World.

    Por exemplo, escolher Go: Hello World cria um aplicativo inicial Hello Hello World.

  5. Selecione uma pasta como o local do aplicativo e clique em Criar novo aplicativo.

    O editor do Cloud Shell carrega o aplicativo em um novo espaço de trabalho. Depois que o espaço de trabalho for carregado, o app poderá ser acessado na visualização de explorador.

Como testar o aplicativo localmente

Para executar seu aplicativo em um cluster local do Kubernetes no Cloud Code, siga estas etapas:

  1. No terminal, execute o seguinte comando:

    minikube start
    
  2. Quando o cluster do minikube estiver pronto, clique na barra de status do Cloud Code e selecione Executar no Kubernetes. Confirme se quer usar o contexto do minikube.

  3. Se necessário, autorize as chamadas do Cloud Code para a API do Google Cloud.

  4. À medida que seu aplicativo é criado, é possível monitorar o progresso no painel de saída. Depois de criá-lo, é possível iniciar o aplicativo com o link exibido no painel de saída.

Como editar o aplicativo

Para editar o aplicativo, siga estas instruções:

  1. Com a visualização do Explorer, encontre o arquivo main.go na pasta cmd > hello-world.
  2. Modifique "Hello, world!" para a mensagem que escolher.

    Depois de fazer essa alteração, você perceberá que o aplicativo será recriado pelos registros no painel de saída.

  3. Quando o aplicativo terminar de criar e implantar, inicie-o com o link no painel de saída para visualizar o aplicativo atualizado.

Como visualizar os registros do aplicativo

Para analisar o aplicativo enquanto ele está em execução, acesse os registros usando o visualizador de registros:

  1. Para iniciar o visualizador de registros, digite "Cloud Code: visualizar registros" usando a paleta de comandos (acessível com Ctrl/Cmd+Shift+P).

    Essa visualização permite filtrar e navegar pelos registros do aplicativo.

  2. Selecione Implantação ou Pod para ver os registros do seu aplicativo.

  3. Atualize o aplicativo no navegador e veja os novos registros gerados clicando no botão de atualização de registros.

Como criar um cluster do GKE

Para criar um cluster do GKE, siga estas etapas:

  1. Para abrir o Kubernetes Explorer, clique em Ícone do Kubernetes Explorer Cloud Code - Kubernetes.
  2. No cabeçalho do painel do Kubernetes Explorer, clique em + Add a Cluster to KubeConfig.
  3. Escolha Google Kubernetes Engine e clique em + Criar um novo cluster do GKE.
  4. Escolha Padrão ou Autopilot como o tipo de cluster.
  5. Clique em Abrir para permitir que o Cloud Code abra o Console do Cloud.
  6. No Console do Cloud, configure seu cluster.
  7. Clique em Criar. A criação do cluster leva alguns minutos.
  8. Depois que o cluster for criado, no Kubernetes Explorer, clique em Atualizar visualização do cluster do Kubernetes Atualizar.
  9. Depois que o nome do novo cluster aparecer na lista, clique no nome dele. Seu novo cluster é adicionado à configuração e configurado para ser o contexto ativo.

Como executar o app

Agora é possível executar o aplicativo e visualizá-lo ao vivo. Além disso, o Cloud Code monitora seu sistema de arquivos em busca de alterações para que você possa editar e executar o aplicativo quase em tempo real.

Para executar seu aplicativo, siga estas etapas:

  1. Use a barra de status do Cloud Code e selecione Executar no Kubernetes.
  2. Confirme se você está usando o novo cluster como o contexto do app.
  3. Dependendo do contexto escolhido, pode ser solicitado que você escolha um registro de imagem para enviar as imagens.
  4. No painel de saída, é possível acompanhar o progresso do aplicativo em execução.
  5. Depois que o aplicativo estiver em execução, a janela de saída exibirá um endereço IP. Ctrl/Cmd + clique para usar esse endereço vinculado para acessar o aplicativo.

Como fazer a limpeza

Depois do encerramento do aplicativo, todos os recursos do Kubernetes implantados durante a execução são excluídos automaticamente. Para evitar cobranças na sua conta por outros recursos usados neste guia de início rápido, exclua o projeto ou o cluster que você criou.

Para excluir apenas o cluster, siga estas etapas:

  1. No Kubernetes Explorer, passe o cursor sobre o nome do cluster e clique em Ícone para abrir no Cloud Console Abrir no Console do Cloud.
  2. Clique em Excluir e depois em Excluir.

Para excluir o projeto (e os recursos associados, incluindo os clusters):

  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 em Excluir.

  3. Digite o ID do projeto para confirmar e clique em Encerrar.

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

A seguir