Criar e implantar um app da Web conteinerizado

Saiba como criar um app da Web conteinerizado usando o editor do Cloud Shell, fazer testes locais dele e o implantar em um cluster do Google Kubernetes Engine (GKE).


Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações


Antes de começar

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

Criar seu app da Web

Use o editor do Cloud Shell como ambiente para criar seu app. O editor vem pré-carregado com as ferramentas necessárias para desenvolver no Cloud.

Siga estas instruções para criar seu app:

  1. Inicie o editor do Cloud Shell

  2. Se for preciso autorizar o Cloud Code a usar suas credenciais para fazer uma chamada de API do Google Cloud, clique em Autorizar.

  3. Abra o menu Cloud Code na barra de status.

  4. Selecione Novo aplicativo.

  5. Selecione Aplicativo do Kubernetes como o tipo de app de exemplo.

  6. Na lista de apps de exemplo do Kubernetes, selecione Go:Hello World.

  7. Selecione uma pasta para ser o local do app e clique em Criar novo aplicativo.

O editor do Cloud Shell vai carregar seu app em um novo espaço de trabalho. Após a atualização, seu app pode ser acessado pela visualização de explorador.

Testar seu app em um cluster local

Agora que você criou seu app, é possível executá-lo em um cluster local do Kubernetes no Cloud Shell:

  1. Para abrir um terminal do Cloud Shell, selecione Terminal > Novo terminal.
  2. Para iniciar o cluster do minikube local, no prompt de comando do terminal, execute o seguinte:

    minikube start
    

    A configuração do cluster do minikube pode levar alguns minutos para ser concluída.

  3. Se for preciso autorizar o Cloud Shell a realizar chamadas das APIs do Cloud, clique em Autorizar.

    Depois de configurar o cluster, vai ser exibida uma mensagem semelhante a esta:

    Done! kubectl is now configured to
    use "minikube" cluster...
    

Depois de configurar o cluster local, crie e execute este app:

  1. Abra o menu Cloud Code na barra de status.
  2. Selecione Executar no Kubernetes.
  3. Se solicitado, confirme que quer usar o contexto atual do minikube.

    Esse processo demora uns minutos, e é possível consultar o status da implantação na visualização das Sessões de desenvolvimento.

    Clique em nós diferentes na visualização das Sessões de desenvolvimento para mostrar trechos de registro relacionados à fase de implantação selecionada.

  4. Depois que o app for criado e implantado, encontre o nó de encaminhamento de portas do seu serviço: na visualização Sessões de desenvolvimento, expanda URLs de encaminhamento de portas > serviço > go-hello-world-external.

  5. Para iniciar o app, mantenha o ponteiro sobre go-hello-world-external e clique em Abrir URL.

Editar seu app

Para entender os componentes do app Hello World, consulte o diagrama no arquivo readme.md. No geral, o app consiste em:

  • Um app da Web go-hello-world básico, main.go, que retorna uma resposta modelo "Em execução" para todas as solicitações recebidas.
  • Um serviço de go-hello-world-external do balanceador de carga, hello.service.yaml, que expõe o app descrevendo um Serviço do Kubernetes.

Para modificar o aplicativo:

  1. Modifique o arquivo main.go para mostrar "Está reimplantado!". O arquivo será salvo automaticamente.
  2. Aguarde um minuto até que o app conclua a criação e a implantação e monitore o progresso do aplicativo à medida que é recriado. Para isso, use a visualização das Sessões de desenvolvimento.

  3. Depois que o app for criado e implantado, encontre o nó de encaminhamento de portas do seu serviço em: Sessões de desenvolvimento > URLs de encaminhamento de porta > serviço > go-hello-world-external.

  4. Para iniciar o app, mantenha o ponteiro sobre go-hello-world-external e clique em Abrir URL.

Explorar os registros do app

Para analisar o app durante a execução, use o visualizador de registros para monitorar os registros do app:

  1. Inicie o visualizador de registros abrindo a Palette de comandos (acessível com Ctrl/Cmd+Shift+P ou Visualizar > Palette de comandos) e execute Cloud Code: visualizar registros.

    Essa visualização permite que você filtre e navegue pelos registros do seu app.

  2. Especifique os filtros de Implantação para explorar os registros do seu app, go-hello-world.

  3. Alterne para a guia com seu app que mostra a mensagem "Está reimplantado!". Atualize a página no navegador e retorne à guia do Cloud Shell.

  4. Para conferir os registros gerados recentemente no Visualizador de registros, clique em Atualizar.

Criar um cluster do Google Kubernetes Engine

Para criar um novo cluster do Google Kubernetes Engine e implantar o app, siga estas instruções:

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

  2. Clique em . Adicione um cluster ao KubeConfig e clique em Google Kubernetes Engine no menu Escolha rápida.

  3. Quando solicitado a ativar container.googleapis.com, clique em Sim.

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

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

  6. Clique em Abrir para permitir que o Cloud Shell abra o 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 visualização do cluster do Kubernetes 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.

Implantar seu app em um cluster do GKE

Implante seu app no cluster novo:

  1. No menu Cloud Code, que pode ser acessado pela barra de status, selecione Executar no Kubernetes.

  2. Confirme o cluster recém-criado como o contexto do seu app.

  3. Confirme a opção padrão para seu registro de imagem.

  4. Aguarde um minuto até que o app conclua a criação e a implantação e monitore o progresso do aplicativo à medida que é recriado. Para isso, use a visualização das Sessões de desenvolvimento.

  5. Depois que o app for criado e implantado, encontre o nó de encaminhamento de portas do seu serviço: na visualização Sessões de desenvolvimento, expanda URLs de encaminhamento de portas > serviço > go-hello-world-external.

  6. Para iniciar o app, mantenha o ponteiro sobre go-hello-world-external e clique em Abrir URL.

Limpar

Para excluir apenas o cluster criado para este guia de início rápido:

  1. Mantenha o cursor sobre o nome do cluster e clique em Ícone "Abrir no console do Google Cloud" Abrir no console do Google Cloud.
  2. Clique em Excluir e em Excluir.

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

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