API Compute Engine

Arquitetura do aplicativo

O aplicativo inclui os seguintes componentes do Compute Engine:

• Rede VPC: uma rede virtual no Google Cloud que pode fornecer conectividade global por meio de rotas e regras de firewall próprias.
• Regra de firewall: um firewall do Google Cloud que permite autorizar ou negar o tráfego para suas instâncias.
• Modelo de instância: um modelo usado para criar cada instância de VM no grupo de instâncias gerenciadas.
• Grupo de instâncias gerenciadas regional: um grupo de instâncias de VM que executam o mesmo aplicativo em várias zonas.
• Endereço IP externo estático global: um endereço IP estático acessível em redes externas e que pode ser anexado a um recurso global.
• Balanceador de carga global: um balanceador de carga que permite que as instâncias de back-end sejam distribuídas por várias regiões. Use o balanceador de carga global quando seus usuários precisarem acessar os mesmos aplicativos e conteúdo e você quiser fornecer acesso usando um único endereço IP anycast.
• Verificação de integridade: uma política usada pelo balanceador de carga para avaliar a capacidade de resposta do aplicativo em cada instância da VM.

Como lançar o aplicativo da Web

Neste tutorial, é usado um aplicativo da Web armazenado no GitHub. Para saber mais sobre como o aplicativo foi implementado, consulte o repositório GoogleCloudPlatform/python-docs-samples no GitHub.

Inclua um script de inicialização em um modelo de instância para lançar o aplicativo da Web em todas as VMs em um grupo de instâncias. Além disso, execute o grupo de instâncias em uma rede VPC dedicada para impedir que as regras de firewall deste tutorial interfiram nos recursos existentes em execução no seu projeto.

Criar uma rede VPC

O uso de uma rede VPC protege os recursos existentes no seu projeto de serem afetados pelos recursos que você criará para este tutorial. Uma rede VPC também é necessária para restringir o tráfego recebido para que ele passe pelo balanceador de carga.

Crie uma rede VPC para encapsular as regras de firewall para o aplicativo da Web de demonstração:

1. No Console do Google Cloud, acesse a página Redes VPC.

   Acessar redes VPC

2. Clique em Criar rede VPC.

3. Em Nome, insira web-app-vpc.

4. Defina o Modo de criação da sub-rede como Automático.

5. Na parte inferior da página, clique em Criar.

Aguarde o término da criação da rede VPC antes de continuar.

Criar regra de firewall

Após a criação da rede VPC, configure uma regra de firewall para permitir o tráfego HTTP na rede VPC:

1. No console do Google Cloud, abra a página Firewalls.

   Acessar Firewalls

2. Clique em Criar regra de firewall.

3. No campo Nome, use allow-web-app-http.

4. Defina Rede como web-app-vpc.

5. Em Destinos, selecione Todas as instâncias na rede.

6. Defina Filtro de origem como IPv4 ranges.

7. Em Intervalos de IP de origem, insira 0.0.0.0/0 para permitir o acesso a todos os endereços IP.

8. Em Protocolos e portas, selecione Portas e protocolos especificados.
   Marque TCP e insira 80 para permitir o acesso do tráfego HTTP.

9. Clique em Criar.

Criar um modelo de instância

Crie um modelo que você usará para criar um grupo de instâncias da VM. Cada instância criada a partir do modelo inicia um aplicativo da Web de demonstração por meio de um script de inicialização.

1. No Console do Google Cloud, acesse a página Modelos de instância.

   Acessar "Modelos de instância"

2. Clique em Criar modelo de instância.

3. Em Nome, insira load-balancing-web-app-template.

4. Em Configuração da máquina, defina Tipo de máquina como e2-micro.

5. Em Firewall, selecione Permitir tráfego HTTP.

6. Expanda a seção Opções avançadas.

7. Expanda a seção Gerenciamento.

8. Na seção Automação, insira o seguinte script de inicialização:

   sudo apt update && sudo apt -y install git gunicorn3 python3-pip
   git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
   cd python-docs-samples/compute/managed-instances/demo
   sudo pip3 install -r requirements.txt
   sudo gunicorn3 --bind 0.0.0.0:80 app:app --daemon
   

   O script recebe, instala e inicia o aplicativo da Web quando a instância da VM é iniciada.

9. Expanda a seção Rede.

10. Na seção Interfaces de rede, clique em Adicionar uma interface de rede. e selecione a rede web-app-vpc. Isso força cada instância criada com este modelo a ser executada na rede criada anteriormente.

11. Clique em Criar.

Aguarde o término da criação do modelo antes de continuar.

Criar um grupo de instâncias gerenciadas regional

Para executar o aplicativo da Web, use o modelo de instância para criar um grupo de instâncias gerenciadas regional:

1. No Console do Google Cloud, acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

2. Clique em Criar grupo de instâncias.

3. Selecione Novo grupo gerenciado de instâncias (sem estado).

4. Em Nome, insira load-balancing-web-app-group.

5. Em Modelo de instância, selecione load-balancing-web-app-template.

6. Defina o Número de instâncias como 6. Se esse campo estiver desativado, desative o escalonamento automático primeiro.

7. Para Local, selecione Várias zonas.

8. Em Região, selecione us-central1.

9. Em Zonas, selecione as seguintes zonas na lista suspensa:

   • us-central1-b
   • us-central1-c
   • us-central1-f

10. Selecione Permitir redistribuição de instâncias.

11. Em Modo de escalonamento automático, selecione Desativado: não fazer escalonamento automático.

12. Clique em Criar. Isso redireciona você de volta à página Grupos de instâncias.

13. Para verificar se suas instâncias estão executando o aplicativo da Web de demonstração corretamente, siga estas etapas:

    1. Na página Grupos de instâncias, clique em load-balancing-web-app-group para ver as instâncias nesse grupo.

    2. Em IP externo, clique em um endereço IP para conectar essa instância. Uma nova guia do navegador será aberta, exibindo o aplicativo de demonstração da Web:

       

       Quando terminar, feche a guia do navegador com o aplicativo de demonstração da Web.

Como configurar o balanceador de carga

Para usar um balanceador de carga para direcionar o tráfego para seu aplicativo da Web, é preciso reservar um endereço IP externo para receber todo o tráfego de entrada. Em seguida, crie um balanceador de carga que aceite o tráfego desse endereço IP e redirecione esse tráfego para o grupo de instâncias.

Reservar um endereço IP estático

Use um endereço IP externo estático global para fornecer ao balanceador de carga um único ponto de entrada para receber todo o tráfego do usuário. O Compute Engine preserva endereços IP estáticos, mesmo se você alterar ou excluir qualquer recurso afiliado do Google Cloud. Isso permite que o aplicativo da Web sempre tenha o mesmo ponto de entrada, mesmo que outras partes do aplicativo possam mudar.

1. No Console do Google Cloud, acesse a página Endereços IP externos.

   Acessar Endereços IP externos

2. Clique em Reservar endereço estático.

3. Em Nome, insira web-app-ipv4.

4. Defina Versão IP como IPv4.

5. Configure Tipo como Global.

6. Clique em Reservar.

Criar um balanceador de carga

Nesta seção, explicamos as etapas necessárias para criar um balanceador de carga global que direciona o tráfego HTTP.

Esse balanceador de carga usa um front-end para receber tráfego de entrada e um back-end para distribuir esse tráfego para instâncias íntegras. Como o balanceador de carga é composto por vários componentes, essa tarefa é dividida em várias partes.

• Configuração de back-end
• Configuração de front-end
• Analisar e finalizar

Conclua todas as etapas para criar o balanceador de carga.

Iniciar a configuração

1. No console do Google Cloud, acesse a página Balanceamento de carga.

   Acessar o "Balanceamento de carga"

2. Clique em Criar balanceador de carga.
3. Em Tipo de balanceador de carga, selecione Balanceador de carga de aplicativo (HTTP/HTTPS) e clique em Próxima.
4. Em Voltado ao público ou interno, selecione Voltado ao público (externo) e clique em Próxima.
5. Em Implantação global ou de região única, selecione Melhor para cargas de trabalho globais e clique em Próxima.
6. Em Geração do balanceador de carga, selecione Balanceador de carga de aplicativo externo global e clique em Próxima.
7. Clique em Configurar.

Configuração básica

1. Em Nome do balanceador de carga, insira web-app-load-balancer.

Configuração de back-end

1. No painel esquerdo da página Criar balanceador de carga de aplicativo externo global, clique em Configuração de back-end.
2. Clique em Criar ou selecione serviços e buckets de back-end para abrir um menu suspenso. Clique em Serviços de back-end e em Criar um serviço de back-end.
3. Na nova janela, para o Nome do aplicativo de back-end, insira web-app-backend.
4. Defina Grupo de instâncias como load-balancing-web-app-group.
5. Defina Números de portas como 80. Isso permite o tráfego HTTP entre o balanceador de carga e o grupo de instâncias.
6. Em Modo de balanceamento, selecione Utilização.
7. Clique em Concluído para criar o back-end.

8. Crie a verificação de integridade para o back-end do balanceador de carga:

   1. Em Verificação de integridade, selecione Criar uma verificação de integridade (ou Criar outra verificação de integridade) no menu suspenso. Uma nova janela será aberta.
   2. Na nova janela, em Nome, digite web-app-load-balancer-check.
   3. Defina Protocolo como HTTP.
   4. Em Porta, digite 80.
   5. Para este tutorial, defina o Caminho da solicitação como /health, que é o caminho a que o aplicativo da Web de demonstração está configurado para responder.

   6. Defina os seguintes Critérios de integridade:

      1. Defina Intervalo de verificação como 3 segundos. Isso define o período entre o início de uma sondagem e o início da próxima.
      2. Defina Tempo limite como 3 segundos. Isso define o tempo que o Google Cloud aguardará pela resposta de uma sondagem. O valor precisa ser menor ou igual ao intervalo de verificação.
      3. Defina Limite íntegro como 2 sucessos consecutivos. Isso define o número sequencial de sondagens que precisam ser bem-sucedidas para que a instância seja considerada íntegra.
      4. Defina Limite não íntegro como 2 falhas consecutivas. Isso define o número de falhas seguidas em sondagens para que a instância seja considerada não íntegra.

   7. Clique em Salvar e continuar para criar a verificação de integridade.

9. Clique em Criar para criar o serviço de back-end.

Configuração de front-end

1. No painel esquerdo da página Criar balanceador de carga de aplicativo externo global, clique em Configuração de front-end.
2. Na página Configuração de front-end, em Nome, digite web-app-ipv4-frontend.
3. Defina Protocolo como HTTP.
4. Defina Versão do IP como IPv4.
5. Defina Endereço IP como web-app-ipv4.
6. Defina Porta como 80.
7. Clique em Concluído para criar o front-end.

Analisar e finalizar

1. Verifique suas configurações de balanceamento de carga antes de criar o balanceador de carga:

   1. No painel esquerdo da página Criar balanceador de carga de aplicativo externo global, clique em Analisar e finalizar.

   2. Na página Analisar e finalizar, verifique as seguintes configurações de back-end:

      • O Serviço de back-end é web-app-backend.
      • O Protocolo do endpoint é HTTP.
      • A Verificação de integridade é web-app-load-balancer-check.
      • O Grupo de instâncias é load-balancing-web-app-group.

   3. Na mesma página, verifique se o Front-end usa um endereço IP com um Protocolo HTTP.

2. No painel esquerdo da página Criar balanceador de carga de aplicativo externo global, clique em Criar para concluir a criação do balanceador de carga.

Pode ser necessário aguardar alguns minutos para que a criação do balanceador de carga seja concluída.

Simular uma interrupção de zona

É possível observar a funcionalidade do balanceador de carga simulando a indisponibilidade generalizada de uma interrupção de zona. Essa simulação força todas as instâncias localizadas em uma zona especificada a relatar um status não íntegro no caminho da solicitação /health. Quando essas instâncias relatam um status não íntegro, elas geram uma falha na verificação de integridade do balanceamento de carga, solicitando que o balanceador de carga pare de direcionar o tráfego para elas.

1. Monitore para quais zonas o balanceador de carga está direcionando o tráfego.

   1. No Console do Google Cloud, acesse o Cloud Shell.

      Abra o Cloud Shell

      O Cloud Shell é aberto em um painel do Console do Google Cloud. A inicialização da sessão pode levar alguns segundos.

   2. Salve o endereço IP externo estático do seu balanceador de carga:

      1. Para ver o endereço IP externo da regra de encaminhamento do front-end do balanceador de carga, digite o seguinte comando no seu terminal:

         gcloud compute forwarding-rules describe web-app-ipv4-frontend --global
         

         Copie EXTERNAl_IP_ADDRESS da saída:

         IPAddress: EXTERNAl_IP_ADDRESS
         ...
         

      2. Crie uma variável bash local:

         export LOAD_BALANCER_IP=EXTERNAl_IP_ADDRESS
         

         em que EXTERNAl_IP_ADDRESS é o endereço IP externo que você copiou.

   3. Para monitorar a quais zonas o balanceador de carga está direcionando o tráfego, execute o seguinte script bash:

      while true
      do
              BODY=$(curl -s "$LOAD_BALANCER_IP")
              NAME=$(echo -n "$BODY" | grep "load-balancing-web-app-group" | perl -pe 's/.+?load-balancing-web-app-group-(.+?)<.+/\1/')
              ZONE=$(echo -n "$BODY" | grep "us-" | perl -pe 's/.+?(us-.+?)<.+/\1/')
      
              echo $ZONE
      done
      

      Esse script tenta se conectar continuamente ao aplicativo da Web por meio do endereço IP para o front-end do balanceador de carga e mostra em qual zona o aplicativo da Web está sendo executado para cada conexão.

      A saída resultante precisa incluir as zonas us-central1-b, us-central1-c e us-central1-f:

      us-central1-f
      us-central1-b
      us-central1-c
      us-central1-f
      us-central1-f
      us-central1-c
      us-central1-f
      us-central1-c
      us-central1-c
      

      Mantenha esse terminal aberto.

2. Enquanto o monitoramento estiver em execução, comece a simular a interrupção da zona.

   1. No Cloud Shell, abra uma segunda sessão de terminal clicando no botão add Adicionar.

   2. Crie uma variável bash local para o ID do projeto:

      export PROJECT_ID=PROJECT_ID
      

      em que PROJECT_ID é o ID do projeto atual, que é exibido em cada nova linha no Cloud Shell:

      user@cloudshell:~ (PROJECT_ID)$
      

   3. Crie uma variável bash local para a zona que você quer desativar. Para simular uma falha da zona us-central1-f, use o seguinte comando:

      export DISABLE_ZONE=us-central1-f
      

      Em seguida, execute o seguinte script bash. Esse script faz com que as instâncias do aplicativo da Web de demonstração na zona desativada produzam respostas não íntegras para a verificação de integridade do balanceador de carga. Respostas não íntegras solicitam que o balanceador de carga direcione o tráfego para longe dessas instâncias.

      export MACHINES=$(gcloud --project=$PROJECT_ID compute instances list --filter="zone:($DISABLE_ZONE)" --format="csv(name,networkInterfaces[0].accessConfigs[0].natIP)" | grep "load-balancing-web-app-group")
      for i in $MACHINES;
      do
        NAME=$(echo "$i" | cut -f1 -d,)
        IP=$(echo "$i" | cut -f2 -d,)
        echo "Simulating zonal failure for zone $DISABLE_ZONE, instance $NAME"
        curl -q -s "http://$IP/makeUnhealthy" >/dev/null --retry 2
      done
      

      Após um pequeno atraso, o balanceador de carga para de direcionar o tráfego para as zonas não íntegras. Portanto, a saída da primeira janela do terminal para de listar a zona us-central1-f:

      us-central1-c
      us-central1-c
      us-central1-c
      us-central1-b
      us-central1-b
      us-central1-c
      us-central1-b
      us-central1-c
      us-central1-c
      

      Isso indica que o balanceador de carga está direcionando o tráfego apenas para instâncias íntegras e com resposta.

      Mantenha os dois terminais abertos.

   4. No segundo terminal, crie uma variável bash local para a zona que você quer restaurar. Para restaurar o tráfego para a zona us-central1-f, use o seguinte comando:

      export ENABLE_ZONE=us-central1-f
      

      Em seguida, execute o seguinte script bash. Esse script faz com que as instâncias do aplicativo da Web de demonstração na zona ativada produzam respostas íntegras à verificação de integridade do balanceador de carga. Respostas íntegras solicitam ao balanceador de carga que comece a distribuir o tráfego de volta para essas instâncias.

      export MACHINES=$(gcloud --project=$PROJECT_ID compute instances list --filter="zone:($ENABLE_ZONE)" --format="csv(name,networkInterfaces[0].accessConfigs[0].natIP)" | grep "load-balancing-web-app-group")
      for i in $MACHINES;
      do
        NAME=$(echo "$i" | cut -f1 -d,)
        IP=$(echo "$i" | cut -f2 -d,)
        echo "Simulating zonal restoration for zone $ENABLE_ZONE, instance $NAME"
        curl -q -s "http://$IP/makeHealthy" >/dev/null --retry 2
      done
      

      Após alguns minutos, a saída da primeira janela de terminal lista gradualmente a zona us-central1-f de novo:

      us-central1-b
      us-central1-b
      us-central1-c
      us-central1-f
      us-central1-c
      us-central1-c
      us-central1-b
      us-central1-c
      us-central1-f
      

      Isso indica que o balanceador de carga está direcionando o tráfego de entrada para todas as zonas novamente.

      Feche os dois terminais quando encerrar.

(Opcional) Como restringir o tráfego recebido

Ao criar o grupo de instâncias gerenciadas regional, é possível acessar cada instância diretamente por meio do seu endereço IP temporário externo. No entanto, agora que você preparou um balanceador de carga e um endereço IP estático externo, talvez você queira modificar o firewall da rede para que o tráfego de entrada precise passar pelo balanceador de carga.

Se você quiser restringir o tráfego de entrada ao balanceador de carga, modifique o firewall da rede para desativar o endereço IP externo temporário de cada instância.

1. Edite a regra de firewall para restringir o tráfego HTTP, para que o aplicativo da Web possa ser acessado apenas pelo balanceador de carga:

   1. No Console do Google Cloud, acesse a página Firewalls.

      Acessar Firewalls

   2. Em Nome, clique em allow-web-app-http.

   3. Clique em Editar.

   4. Modifique os Intervalos de IPs de origem para permitir apenas testes de verificação de integridade:

      1. Exclua 0.0.0.0/0.
      2. Na mesma linha, digite 130.211.0.0/22 e pressione Tab.
      3. Na mesma linha, digite 35.191.0.0/16 e pressione Tab.

   5. Clique em Salvar.

2. Confirme que não é possível se conectar ao aplicativo da Web através do endereço IP externo temporário de uma instância específica:

   1. No Console do Google Cloud, acesse a página Grupos de instâncias.

      Acesse grupo de instâncias

   2. Clique em load-balancing-web-app-group para ver as instâncias nesse grupo.

   3. Em IP externo, clique em um endereço IP para conectar essa instância. Uma nova guia do navegador é aberta, mas o aplicativo da Web não é mostrado. Por fim, a página mostrará um erro de tempo limite.

      Quando terminar, feche a guia do navegador da instância.

3. Verifique se é possível se conectar ao aplicativo da Web usando o balanceador de carga:

   1. No Console do Google Cloud, acesse a página Balanceamento de carga.

      Acesse Balanceamento de carga

   2. Em Nome, clique em web-app-load-balancer para expandir o balanceador de carga que você acabou de criar.

   3. Para se conectar ao aplicativo da Web por meio dos endereços IP estáticos externos, veja Front-end e IP:Porta e copie o endereço IP. Em seguida, abra uma nova guia do navegador e cole o endereço IP na barra de endereços. Isso mostrará o aplicativo de demonstração da Web.

      

      Observe que, sempre que você atualiza a página, o balanceador de carga se conecta a diferentes instâncias em diferentes zonas. Isso acontece porque você não está se conectando diretamente a uma instância, você está se conectando ao balanceador de carga, que seleciona a instância para redirecionar o acesso.

      Quando terminar, feche a guia do navegador com o aplicativo de demonstração da Web.