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

Implantar um app do Kubernetes com o Cloud Code para VS Code

Esta página mostra rapidamente os primeiros passos com o Cloud Code.

Você configurará um novo aplicativo do Kubernetes usando um aplicativo de amostra &Hello 39; Hello World, criará um cluster, executará o aplicativo neste cluster, depurará o código em execução, visualizará os registros do aplicativo ativo e conectará um terminal ao contêiner em execução.

Se você estiver usando uma máquina Apple que usa silicon M-Series, use o Cloud Build para implantar no Cloud Run, que é compatível apenas com imagens x86. Isso pode gerar cobranças. O Cloud Code ajuda a criar imagens x86 usando o Cloud Build. Para mais informações, consulte Suporte do Cloud Code ao silício da série Apple M.

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 verificar se o faturamento está ativado em um projeto.

  4. Ative a API Google Kubernetes Engine.

    Ative a API

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

  6. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

  7. Ative a API Google Kubernetes Engine.

    Ative a API

  8. Instale o Git. O Git é necessário para copiar amostras na sua máquina.

Como instalar o Cloud Code

  1. Instale o Visual Studio Code na sua máquina, caso ainda não tenha feito isso.

  2. Para todas as plataformas do Cloud, instale o cliente do Docker (autenticado com o registro do Docker) no PATH da máquina. A pasta de instalação precisa estar visível em uma no PATH).

    • Para verificar se o Docker já está instalado, execute docker -v.
    • Se você estiver usando o Windows Home, consulte Instalar o Docker Desktop no Windows Home.
    • Se você usa o WSL, mas não consegue instalar o Docker para computadores, use o minikube em vez de desenvolvimento local com o Cloud Code.

    O Cloud Code instala automaticamente a CLI kubectl, Skaffold e gcloud.

  3. Instale o Cloud Code usando uma das seguintes opções:

    • Abra o VS Code e instale o Cloud Code.
    • Abra o Visual Studio Code na sua máquina. Usando oExtensões visualizaçãoÍcone de extensão no VS Code (o ícone quadrado precisa estar disponível na barra de tarefas à esquerda), pesquise e clique noCloud Code e clique emInstalar de dados.

    Se você estiver executando o Cloud Code para VS Code no Apple Silly-Series, você será solicitado a instalar o Rosetta 2 ou desativar as dependências do Auto, que exigem que o Rosetta 2 funcione no seu sistema.

    Após a conclusão da instalação, você verá a página de boas-vindas do Cloud Code e uma coleção de aplicativos de exemplo em "Apps para iniciantes" que podem ser usados para configurar rapidamente um novo aplicativo. A barra de status do Cloud Code, com ações comuns do Cloud Code, está disponível na barra de status do VS Code.

Como criar um aplicativo

  1. Na paleta de comandos (pressione Cmd/Ctrl+Shift+P), execute Cloud Code: New Application e escolha Kubernetes Application

  2. Escolha um app "Hello World" no idioma que preferir.

    Por exemplo, escolher Node.js: Hello World cria um aplicativo inicial Hello World do Node.js.

  3. Salve o novo aplicativo.

    Uma notificação confirmará que seu aplicativo foi criado e que uma nova janela será aberta.

crie um cluster do GKE;

Para criar um cluster padrão do Google Kubernetes Engine (GKE), siga estas etapas:

  1. Clique em Ícone do Cloud Code Código do Cloud e expanda a seção Kubernetes.

  2. Clique em + Adicionar um cluster ao KubeConfig e selecione Google Kubernetes Engine.

  3. Quando a ativação do contêiner for solicitada, selecione Sim.

  4. Escolha Padrão 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, use o projeto criado, defina a zona como us-central1-a e defina o nome do cluster como my-first-cluster.

  7. Clique em Criar. A criação do cluster leva alguns minutos.

  8. Após a criação do cluster, clique em Atualizar visualização do cluster do Kubernetes Atualizar na seção expandida do Kubernetes.

  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 e ver seu app

Agora que está tudo pronto, você pode executar seu app e visualizá-lo ativo. 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. Clique na barra de status do Cloud Code e selecione Executar no Kubernetes.
  2. Confirme se quer usar o contexto do cluster atual ou alternar para outro.
  3. Se solicitado, escolha um registro de imagem para enviar as imagens.

    Uma janela de saída será exibida para acompanhar o andamento do aplicativo em execução. Também é possível ver uma transmissão ao vivo dos registros dos pods em execução na saída do terminal.

  4. Depois que o aplicativo estiver em execução no Kubernetes, a janela de saída exibirá um endereço IP. Para usar esse endereço IP vinculado para acessar seu aplicativo, pressione Ctrl/Cmd e clique no endereço.

Dicas de solução de problemas

Se você estiver usando um cluster preexistente, para defini-lo como ativo e receber as credenciais dele, siga estas etapas:

  1. Clique em Ícone do Cloud Code Código do Cloud e expanda a seção Kubernetes.

  2. Clique com o botão direito do mouse no nome do cluster e clique em Definir como cluster ativo.

Como depurar o aplicativo

Para depurar o aplicativo, siga estes passos:

  1. Clique na barra de status do Cloud Code e selecione Depurar no Kubernetes.

  2. Se solicitado, confirme se quer usar o contexto do cluster atual ou mudar para um preferido.

    O Cloud Code usa as configurações cloudcode.kubernetes no arquivo .vscode/launch.json para executar seu aplicativo e anexar uma sessão do depurador a ele.

    Em seguida, o Cloud Code cria seus contêineres, os envia para o registro, aplica as configurações do Kubernetes ao cluster e retorna o endereço IP que pode ser usado para navegar no aplicativo ativo.

  3. Antes de anexar a sessão de depuração, você precisará confirmar ou inserir o diretório no contêiner remoto em que o programa será encontrado ou pressionar ESC para pular a depuração.

  4. Para adicionar um ponto de interrupção à linha no 9, abra o src/app.js e clique na margem do editor.

    Os círculos preenchidos em vermelho indicam pontos de interrupção ativos, enquanto os círculos vazios em cinza indicam pontos de interrupção desativados. Para um controle mais preciso do ponto de interrupção, use a seção Pontos de interrupção na visualização de depuração do VS Code.

    Seção "Pontos de interrupção" no painel esquerdo da Visualização de depuração que permite adicionar, remover e desativar pontos de interrupção

    Quando você envia uma nova solicitação ao aplicativo, o depurador é pausado no primeiro ponto de interrupção ativo.

    No exemplo a seguir, em Local na seção Variables, observe que o valor de res._contentLength; para Hello, world! é 13.

    Aplicativo pausado no ponto de interrupção e seções de pilha de chamadas e variáveis preenchidas com valores no escopo

  5. Edite a string enviada na linha 8 a Hello, goodbye! e reinicie a ação Debug no Kubernetes.

    Depois que o app for recriado e reimplantado, anote o valor atualizado de res._contentLength.

    App pausado no ponto de interrupção com valores atualizados

Depois que a sessão de depuração for iniciada, o painel Sessões de desenvolvimento exibirá a visualização de geração de registros estruturada. Quando uma tarefa começa, ela é exibida com um ícone de semicírculo girando Ícone de progresso.

Se uma tarefa for bem-sucedida, uma marca de seleção verde Ícone de sucesso será exibida ao lado da etapa.

Para ver detalhes de uma etapa, clique nela no painel Sessão de desenvolvimento. O painel "Saída" exibe a etapa na geração de registros.

Como abrir um terminal no contêiner

Para abrir um terminal no contêiner, siga estas instruções:

  1. Clique em Ícone do Cloud Code Código do Cloud e expanda a seção Kubernetes.

  2. Expanda as seguintes seções:

    • A seção do seu cluster preferido
    • A seção Namespaces e a seção de namespaces preferidos
    • A seção Pods e a seção do pod preferido
    • A seção Contêineres

    Ícone do Cloud Code

  3. Clique com o botão direito do mouse no contêiner em que você quer abrir um terminal e clique em Get Terminal.

    Isso iniciará o terminal. Agora você tem acesso a um shell no contêiner em execução.

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 cluster e o projeto criados.

Se você estiver usando o Google Cloud e quiser excluir apenas seu cluster, siga estas etapas:

  1. No explorador do Kubernetes, passe o cursor sobre o nome do cluster e clique em Ícone de abrir no Console do Cloud 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