Implantar um app do Kubernetes usando o desenvolvimento remoto

Implantar um app do Kubernetes usando o desenvolvimento remoto

Nesta página, mostramos como começar a usar o Cloud Code para VS Code rapidamente usando um ambiente de desenvolvimento remoto no Cloud Shell.

Neste guia de início rápido, você pulará a configuração e clonará um projeto no espaço de trabalho de desenvolvimento remoto com o clique de um botão, criará um cluster, executará um aplicativo do Kubernetes nesse cluster, depurará o código em execução, visualizará os registros do aplicativo ativo e, além disso, conectará um terminal ao contêiner em execução.

Observação: para conferir as etapas de configuração da depuração remota no Chrome OS, consulte Criar um fluxo de trabalho de desenvolvimento com o Cloud Code em um Pixelbook.

Antes de começar

Para configurar recursos de suporte e acessar o Cloud Shell, no ambiente de desenvolvimento remoto no Google Cloud que você usa neste guia de início rápido, no VS Code, conclua as seguintes etapas:

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Instale o Visual Studio Code na sua máquina, caso ainda não tenha feito isso.
7. Instale a extensão Remote - SSH do Visual Studio Code.
8. Instale o Git. O Git é necessário para copiar amostras na sua máquina.
9. Instale o plug-in do Cloud Code, caso ainda não tenha feito isso.

Como iniciar o Cloud Code

Quando você abre o Visual Studio Code conectado a um ambiente de desenvolvimento remoto no Cloud Shell, o ambiente tem todas as ferramentas necessárias para desenvolver aplicativos do Kubernetes.

1. Para começar o trabalho no seu local de trabalho de desenvolvimento remoto, escolha a linguagem preferida para o projeto clonado e clique no botão Abrir com o Cloud Code:

   Node.js

   Abrir com Cloud Code

   Java

   Abrir com Cloud Code

   Python

   Abrir com Cloud Code

   Go

   Abrir com Cloud Code

   O VS Code inicia e clona um projeto no espaço de trabalho de desenvolvimento remoto.

2. Se você ainda não tiver os pré-requisitos configurados, receberá uma solicitação para instalá-los.

Criar um cluster do GKE

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

1. Clique em Cloud Code e abra a seção Kubernetes.

2. Clique em adicionar Adicionar um cluster ao KubeConfig e, em seguida, clique em Google Kubernetes Engine no menu Seleção rápida.

3. Quando solicitado a ativar container.googleapis.com, selecione Sim.

4. Clique em + Criar um novo cluster do GKE.

5. Escolha Padrão como o tipo de cluster.

6. Clique em Abrir para que o Cloud Code abra a console do Google Cloud.

7. No console do Google Cloud, use o projeto que você criou, defina a zona como us-central1-a e defina o nome do cluster como my-first-cluster.

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

9. Após a criação do cluster, no menu Escolha rápida, clique em atualizar Atualizar.

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

Executar e conferir o app

Agora que está tudo pronto, você pode executar seu app e visualizá-lo ativo. O Cloud Code monitora seu sistema de arquivos em busca de alterações para que você possa editar e executar o app quase em tempo real.

Para executar seu aplicativo, siga estas etapas:

1. Na barra de status do Cloud Code, clique no nome do projeto ativo.

   

2. No menu de seleção rápida exibido, selecione Executar no Kubernetes.

3. Confirme se quer usar o contexto do cluster atual ou alternar para outro.

4. Se solicitado, escolha um registro de imagem para enviar as imagens. Se você estiver criar um novo registro de imagem usando gcr.io/PROJECT_ID; garantir que o registro de imagem esteja no mesmo projeto que o cluster.

   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.

5. 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 sua aplicativo, pressione Ctrl/Cmd e clique no endereço.

Dicas de solução de problemas

Se você estiver usando um cluster preexistente, para configurar o cluster como ativo e receber as credenciais, siga estas etapas:

1. Clique em Cloud Code e abra a seção Kubernetes.

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

Depurar o app

Para depurar o aplicativo, siga estes passos:

1. Na barra de status do Cloud Code, clique no nome do projeto ativo.

   

2. No menu de seleção rápida exibido, selecione Depurar no Kubernetes.

3. Se solicitado, autentique suas credenciais para executar e depurar um aplicativo localmente.

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

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

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

   

   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 Variáveis, observe que o valor de res._contentLength; para Hello, world! é 13.

   

7. Edite a string enviada inline no 8 para Hello, goodbye! e reinicie a ação Depurar no Kubernetes.

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

   

Após o início da sessão de depuração, o painel Sessões de desenvolvimento é exibido. a visualização da geração de registros estruturada. Quando uma tarefa começa, ela aparece com um semicírculo girando progress_activity.

Se uma tarefa for bem-sucedida, uma marca de seleção check_circle vai aparecer ao lado da etapa.

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

Abra um terminal no seu contêiner.

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

1. Clique em Cloud Code e expanda a interface do Kubernetes nesta seção.

2. Abra as seguintes seções:

   • Seção do seu cluster preferido
   • a seção Namespaces e, em seguida, a seção do namespace de sua preferência
   • a seção Pods e, em seguida, a seção do seu pod preferido

   • Seção Contêineres

     

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 inicia um terminal. Agora você tem acesso a um shell dentro do contêiner em execução.

Limpar

Após a interrupção do aplicativo, todos os recursos do Kubernetes implantados durante da 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 se quer reutilizá-lo.

Para excluir o cluster, siga estas etapas:

1. Clique em Cloud Code e abra o explorador Kubernetes.
2. Mantenha o ponteiro sobre o nome do cluster e clique em open_in_new Abrir no console do Google Cloud.
3. Clique em Excluir e em Excluir.

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

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

A seguir

• Considere importar um aplicativo existente para o VS Code e configurar o Cloud Code.
• Lide com a configuração mais avançada do Google Cloud e do Kubernetes com o suporte de edição YAML do Cloud Code.
• Descubra o suporte de depuração específico do idioma fornecido pelo Cloud Code.
• Acelere seu desenvolvimento com a sincronização de arquivos e a recarga automática.
• Crie e configure um cluster do GKE
• Configure clusters particulares
• Personalize sua experiência com o Cloud Code definindo configurações relevantes.