Implantar e atualizar com um ambiente de desenvolvimento integrado

Se você desenvolver aplicativos para serem executados no Google Kubernetes Engine, será possível usar um ambiente de desenvolvimento integrado e o plug-in do Cloud Code para simplificar as principais tarefas de desenvolvimento, como testar e depurar localmente e implantar em um cluster de teste.

Escolha um projeto e um cluster do Google Cloud

Ao implantar seu app no GKE mais adiante neste tutorial, você precisa especificar um projeto do Google Cloud e um cluster do GKE.

  1. Acessar a página de Clusters do GKE.

    Acessar Clusters

  2. Escolha um projeto que contenha um cluster do GKE.

  3. Anote o nome do projeto e do cluster.

    Você precisará dessas informações mais tarde.

Criar um aplicativo no editor do Cloud Shell

  1. No console do Google Cloud , abra o Cloud Shell clicando em Cloud Shell na barra de tarefas.

  2. Clique em Abrir editor.

  3. Aguarde a inicialização do editor do Cloud Shell.

  4. No editor do Cloud Shell, clique em Visualizar > Paleta de comandos.

  5. Pesquise Cloud Code: novo aplicativo e clique nele.

  6. Selecione Aplicativo do Kubernetes e selecione Go: Hello World.

    Cada framework de linguagem oferece experiências um pouco diferentes, e este tutorial descreve os recursos disponíveis para o Go.

  7. Na caixa de diálogo "Save", clique em Create new application.

    O editor do Cloud Shell é atualizado e mostra os arquivos de origem do aplicativo na visualização do Explorer.

O app contém:

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

  • Uma especificação de implantação do Kubernetes, hello.deployment.yaml.

  • Uma especificação de serviço do Kubernetes que define um balanceador de carga para o aplicativo, hello.service.yaml.

  • Um arquivo Skaffold que processa o fluxo de trabalho para criar e implantar o aplicativo skaffold.yaml.

Executar o aplicativo no ambiente de desenvolvimento

Quando possível, execute aplicativos no seu ambiente de desenvolvimento antes de implantar no GKE. Isso pode ajudar a identificar possíveis problemas sem usar a cota Google Cloud .

Para executar o aplicativo no ambiente do editor do Cloud Shell:

  1. No editor do Cloud Shell, clique em Terminal > Novo terminal.

  2. Inicie um cluster executando o seguinte comando:

    minikube start

    O minikube é uma implementação leve do Kubernetes que cria uma VM no ambiente local e implanta um cluster simples contendo apenas um nó.

    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 minikube, vai ser exibida uma mensagem semelhante a esta:

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

Depois de configurar o minikube, crie e execute o app:

  1. Na barra de status do editor do Cloud Shell, clique em Cloud Code.

  2. Selecione Run on Kubernetes.

  3. Se solicitado, confirme que quer usar o contexto atual do minikube.

    O editor do Cloud Shell cria seu app e o implanta no cluster do minikube.

  4. Acesse o status da implantação na visualização Sessões de desenvolvimento.

    Quando a implantação estiver concluída, uma marca de seleção verde aparecerá ao lado de URLs de encaminhamento. O ícone giratório aparece ao lado de Registros de aplicativos de stream.

  5. Para acessar seu aplicativo, vá para baixo no painel Sessões de desenvolvimento e encontre URLs de encaminhamento de portas > serviço.

  6. Mantenha o ponteiro do mouse sobre go-hello-world-external e clique em Abrir URL.

Editar seu app

Quando você altera um arquivo de origem no aplicativo, o editor do Cloud Shell cria e implanta automaticamente o aplicativo no cluster ao qual você está conectado. Nesse caso, você está conectado ao cluster do minikube.

Para editar e reimplantar o app no cluster do minikube local:

  1. Modifique o arquivo main.go para exibir "Está reimplantado!". O arquivo será salvo automaticamente.

  2. Veja a visualização das Sessões de desenvolvimento enquanto seu app é recriado e implantado.

  3. Acesse o aplicativo reimplantado da mesma maneira que antes:

    1. No painel Sessões de desenvolvimento, localize URLs de encaminhamento de portas > serviço.

    2. Mantenha o ponteiro do mouse sobre go-hello-world-external e clique em Abrir URL.

Explorar os registros do app

  1. Na barra de menus do editor do Cloud Shell, selecione View > Command Palette.

  2. Pesquise Cloud Code: ver registros e clique nele.

    O Visualizador de registros é aberto.

  3. Em Implantação, selecione go-hello-world.

    Isso filtra o Visualizador de registros para exibir apenas registros do seu aplicativo go-hello-world.

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

  5. Para conferir os registros gerados recentemente no visualizador de registros, clique em Atualizar.

Implantar seu app em um cluster do GKE

  1. Adicione o cluster do GKE à lista de clusters em que é possível implantar:

    1. Na visualização Kubernetes, clique em Adicionar um cluster ao KubeConfig.

    2. Na caixa de diálogo Escolher uma plataforma, clique em Google Kubernetes Engine.

    3. Se for solicitado que você ative a API Google Cloud , clique em Sim.

    4. Aguarde o Cloud Shell Editor encontrar os clusters no seu projeto doGoogle Cloud .

    5. Na caixa de diálogo Criar ou escolher um cluster do GKE, selecione o nome do cluster que você criou, hello-world-cluster.

  2. Na barra de status do editor do Cloud Shell, clique em Cloud Code e selecione Executar no Kubernetes.

  3. Quando solicitado a selecionar um contexto para a solicitação de implantação, escolha Usar contexto atual, definido para o cluster do GKE.

  4. Na caixa de diálogo Escolher repositório de imagens, selecione gcr.io/PROJECT_NAME.

    O editor do Cloud Shell cria seu aplicativo em um contêiner e o armazena no repositório selecionado.

  5. Veja a visualização das Sessões de desenvolvimento enquanto seu app é recriado e implantado.

  6. Para acessar mensagens de registro detalhadas à medida que o aplicativo é implantado no GKE, clique no nó Implantar no cluster na visualização Sessões de desenvolvimento.

  7. Para acessar seu aplicativo em execução:

    1. Feche a visualização clicando no título Sessões de desenvolvimento.

    2. Abra a visualização do Kubernetes.

    3. Expanda seu cluster do GKE.

    4. Acesse Namespaces > padrão > Serviços > go-hello-world-external > IPs externos.

    5. Mantenha o ponteiro do mouse sobre o endereço IP e clique em Abrir URL.

Você criou e implantou um app do GKE em um ambiente de desenvolvimento integrado.