Monitorar recursos de infraestrutura usando um app global do App Hub

---

Visualização — App Hub global applications

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O App Hub permite gerenciar e visualizar recursos de infraestrutura de Google Cloud projetos por meio de aplicativos do App Hub. Para criar esses aplicativos do App Hub, você precisa de um projeto de host do App Hub ao qual possa anexar projetos de serviço que contenham recursos do Google Cloud .

Neste tutorial, mostramos como configurar um app global do App Hub para vários projetos e visualizar os recursos dele. Usando vários projetos de serviço, você configura um balanceador de carga de aplicativo interno em um ambiente de VPC compartilhada. Em seguida, em um aplicativo global no projeto host do App Hub, você registra e monitora todos os recursos de infraestrutura dos projetos de serviço como serviços e cargas de trabalho do App Hub.

Este tutorial é destinado a pessoas que configuram e administram o App Hub. Você precisa ter alguma experiência com o Cloud Load Balancing.

Importante: os projetos host e de serviço no App Hub não são iguais a projetos host ou de serviço da VPC compartilhada e não têm os mesmos requisitos. Para mais informações, consulte VPC compartilhada e Host do App Hub e projetos de serviço.

Objetivos

• Configure um aplicativo do Global App Hub que contenha recursos em vários projetos.
• Monitore os recursos usando as métricas do sistema do aplicativo.

Custos

Para uma estimativa do custo dos recursos do Google Cloud usados pela solução de VM gerenciada com balanceamento de carga, consulte a estimativa pré-calculada na Google Cloud Calculadora de preços.

Use a estimativa como um ponto de partida para calcular o custo da implantação. É possível modificar a estimativa para refletir as alterações de configuração planejadas para os recursos usados na solução.

A estimativa pré-calculada tem como base suposições específicas, incluindo o seguinte:

• Os locais do Google Cloud em que os recursos são implantados.
• A quantidade de tempo em que os recursos são usados.

Para mais informações sobre os custos do App Hub, consulte a página Preços.

Antes de começar

Antes de configurar este tutorial, decida as funções e permissões para seus projetos e crie quatro Google Cloud . Um desses projetos é o host do App Hub, e os outros três são projetos de serviço do App Hub.

Papéis e permissões necessárias

Se você for o criador do projeto, receberá o papel de proprietário básico (roles/owner). Por padrão, esse papel do Identity and Access Management (IAM) inclui as permissões necessárias para acesso total à maioria dos recursos do Google Cloud.

Se você não é o criador do projeto, as permissões necessárias precisam ser concedidas ao principal apropriado. Por exemplo, um principal pode ser uma Conta do Google (para usuários finais) ou uma conta de serviço (para aplicativos e cargas de trabalho).

Para receber as permissões necessárias para gerenciar o acesso a um projeto, uma pasta ou uma organização, peça ao administrador para conceder a você os seguintes papéis do IAM no recurso em que você quer gerenciar o acesso (projeto, pasta ou organização):

• Para gerenciar o acesso a um projeto:
  • Administrador do App Hub (roles/apphub.admin)
  • Cloud Infrastructure Manager (roles/config.admin)
  • Função de administrador de VPC compartilhada do Compute (roles/compute.xpnAdmin)
  • Administrador de projetos do IAM (roles/resourcemanager.projectIamAdmin)
  • Administrador do Service Usage (roles/serviceusage.services.enable)
  • Administrador da conta de serviço (roles/iam.serviceAccounts.create)
• Para gerenciar o acesso a uma pasta: Função de administrador de VPC compartilhada do Compute (roles/compute.xpnAdmin)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Criar projetos de host e de serviço do App Hub

Console

1. No console Google Cloud , acesse a página do seletor de projetos.

   Acessar o seletor de projetos

2. Selecione ou crie um Google Cloud projeto para ser seu projeto de hospedagem do App Hub.

3. Enable the App Hub, Compute Engine, Service Management, and Service Usage APIs.

   Enable the APIs

4. Na mesma pasta do projeto host do App Hub, crie três novos projetos . Estes são os projetos de serviço do App Hub para o projeto host do App Hub.

5. Verifique se o faturamento está ativado para todos os projetos do .

6. Enable the App Hub, Compute Engine, Service Management, and Service Usage APIs.

   Enable the APIs

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Verifique se a versão mais recente da Google Cloud CLI está instalada. Execute o comando a seguir no Cloud Shell:

     gcloud components update

3. Crie ou selecione um novo projeto, HOST_PROJECT_ID, para ser o projeto host do App Hub.

   • Crie um Google Cloud projeto:

     gcloud projects create HOST_PROJECT_ID

   • Selecione o projeto Google Cloud que você criou:

     gcloud config set project HOST_PROJECT_ID

4. Verifique se o faturamento está ativado para todos os projetos do .

5. Ative as APIs App Hub, Compute Engine, Service Management e Service Usage:

   gcloud services enable apphub.googleapis.com \
      compute.googleapis.com \
      servicemanagement.googleapis.com \
      serviceusage.googleapis.com

6. Crie três novos projetos do Google Cloud para serem os projetos de serviço do App Hub para o projeto host do App Hub.

   1. Crie um projeto de serviço:

      gcloud projects create SERVICE_PROJECT_1_ID

      Substitua SERVICE_PROJECT_1_ID pelo ID do projeto de serviço 1.

   2. Selecione o projeto de serviço que você criou:

      gcloud config set project SERVICE_PROJECT_1_ID

   3. Ative as APIs Compute Engine, Service Management e Service Usage:

      gcloud services enable compute.googleapis.com \
        servicemanagement.googleapis.com \
        serviceusage.googleapis.com

   4. Defina a variável de configuração usada neste tutorial:

      export SERVICE_PROJECT_1_NUMBER= $(gcloud projects describe $(gcloud config get-value project) --format='value(projectNumber)')

   5. Repita a etapa anterior para criar SERVICE_PROJECT_2_ID e SERVICE_PROJECT_3_ID, ativar as APIs e definir a variável de configuração.

Prepare o ambiente

Se você já tiver um balanceador de carga de aplicativo interno em um ambiente de VPC compartilhada configurado em vários projetos, acesse a seção Conceder permissões do IAM neste documento.

Caso contrário, siga estas etapas para configurar um balanceador de carga de aplicativo interno em um ambiente de VPC compartilhada:

Figura 1. Serviços e cargas de trabalho do App Hub com um balanceador de carga e grupos de instâncias gerenciadas em uma VPC compartilhada.

1. No projeto de serviço 1, configure uma rede VPC compartilhada e duas sub-redes.
2. No projeto de serviço 2, crie o serviço de back-end do balanceador de carga com dois grupos de instâncias gerenciadas como back-ends.
3. No projeto de serviço 3, crie outro serviço de back-end do balanceador de carga com dois grupos de instâncias gerenciadas como back-ends.
4. No projeto de serviço 1, crie os componentes de front-end e o mapa de URL do balanceador de carga.

Confira a seguir o fluxo de processamento de solicitações da topologia implantada pela solução de VM gerenciada com balanceamento de carga.

1. Na rede VPC compartilhada, a VM cliente faz uma solicitação HTTP para o balanceador de carga de aplicativo interno no projeto de serviço 1.

2. O balanceador de carga usa as informações no mapa de URL e nos serviços de back-end para rotear a solicitação para os back-ends do grupo gerenciado de instâncias.

Configurar a rede e as sub-redes no projeto host da VPC compartilhada

Você precisa de uma rede VPC compartilhada com duas sub-redes: uma para o front-end e os back-ends do balanceador de carga e outra para os proxies do balanceador de carga.

Este exemplo usa a seguinte rede, região e sub-redes:

• Rede: o nome da rede é lb-network.

• Sub-rede para o front-end e os back-ends do balanceador de carga. uma sub-rede chamada lb-frontend-and-backend-subnet na região us-west1 usa 10.1.2.0/24 para o intervalo de IP primário.

• Sub-rede para proxies: uma sub-rede chamada proxy-only-subnet na região us-west1 usa 10.129.0.0/23 como o intervalo de IP primário.

Observação: é possível alterar o nome da rede, a região e os parâmetros das sub-redes. No entanto, nas etapas subsequentes deste guia, são usados os parâmetros de rede, região e sub-rede conforme descrito aqui.

Neste tutorial, designe o Projeto de serviço 1 como o projeto host da VPC compartilhada. Todas as etapas desta seção precisam ser realizadas no Projeto de serviço 1.

Configurar a sub-rede para o front-end e os back-ends do balanceador de carga

Essa etapa não precisa ser realizada sempre que você quiser criar um novo balanceador de carga. Você só precisa garantir que os projetos de serviço tenham acesso a uma sub-rede na rede VPC compartilhada (além da sub-rede somente proxy).

Console

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

   Acessar redes VPC

2. Clique em Criar rede VPC.
3. No campo Nome, use lb-network.
4. Defina o Modo de criação de sub-rede como Personalizado.

5. Na seção Nova sub-rede, insira as seguintes informações:

   • Name: lb-frontend-and-backend-subnet

   • Região: us-west1

   • Intervalo de endereços IP: 10.1.2.0/24

6. Clique em Concluído.

7. Clique em Criar.

gcloud

1. Defina o projeto como Projeto de serviço 1:

     gcloud config set project SERVICE_PROJECT_1_ID

2. Crie uma rede VPC com o comando gcloud compute networks create:

   gcloud compute networks create lb-network --subnet-mode=custom
   

3. Crie uma sub-rede na rede lb-network, região us-west1:

   gcloud compute networks subnets create lb-frontend-and-backend-subnet \
       --network=lb-network \
       --range=10.1.2.0/24 \
       --region=us-west1
   

Configurar a sub-rede somente proxy

A sub-rede somente proxy é usada por todos os balanceadores de carga regionais baseados no Envoy na região us-west1, na rede VPC lb-network. Só pode haver uma sub-rede somente proxy ativa por região, por rede.

Não realize esta etapa se já houver uma sub-rede somente proxy reservada na região us-west1 desta rede.

Importante: não tente atribuir endereços IP dessa sub-rede somente proxy à regra de encaminhamento ou aos back-ends do balanceador de carga. Atribua o endereço IP da regra de encaminhamento e os endereços IP da instância de back-end de um intervalo (ou intervalos) de sub-redes diferente, não este aqui. O Google Cloud reserva esse intervalo de sub-redes para Google Cloud-gerenciado proxies.

Console

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

   Acessar redes VPC

2. Clique no nome da rede VPC compartilhada: lb-network.
3. Clique na guia Sub-redes e em Adicionar sub-rede.
4. No painel Adicionar uma sub-rede, no campo Nome, digite proxy-only-subnet.
5. Na lista Região, selecione us-west1.
6. Defina Finalidade como Proxy gerenciado regional.
7. No campo Intervalo de endereços IP, insira 10.129.0.0/23.
8. Clique em Adicionar.

gcloud

Crie a sub-rede somente proxy com o comando gcloud compute networks subnets create.

gcloud compute networks subnets create proxy-only-subnet \
    --purpose=REGIONAL_MANAGED_PROXY \
    --role=ACTIVE \
    --region=us-west1 \
    --network=lb-network \
    --range=10.129.0.0/23

Conceder aos administradores do projeto de serviço acesso à sub-rede de back-end

Os administradores de projetos de serviço exigem acesso à sub-rede lb-frontend-and-backend-subnet para que possam provisionar os back-ends do balanceador de carga.

Um administrador de VPC compartilhada precisa conceder acesso à sub-rede de back-end aos administradores (ou desenvolvedores que implantarão recursos e back-ends que usam a sub-rede) do projeto de serviço. Veja instruções em Administradores de projetos de serviço para algumas sub-redes.

Observação : os administradores do projeto de serviço não precisam receber acesso à sub-rede somente proxy. No entanto, sem uma sub-rede somente proxy preexistente na região, os administradores de projetos de serviço não podem criar regras de encaminhamento para balanceadores de carga regionais baseados no Envoy nessa região.

Configurar regras de firewall no projeto de serviço 1

Este exemplo usa as seguintes regras de firewall:

• fw-allow-health-check uma regra de entrada, aplicável às instâncias cuja carga está sendo balanceada, que permite todo o tráfego TCP dos sistemas de verificação de integridade do Google Cloud em 130.211.0.0/22 e 35.191.0.0/16. Neste exemplo, usamos a tag de destino load-balanced-backend para identificar as instâncias a que ela se aplicará.

• fw-allow-proxies. Uma regra de entrada, aplicável às instâncias submetidas a balanceamento de carga, que permite o tráfego TCP em portas80 ,443 e 8080 dos proxies gerenciados do balanceador de carga. Neste exemplo, usamos a tag de destino load-balanced-backend para identificar as instâncias às quais ela deve se aplicar.

• fw-allow-ssh: uma regra de entrada, aplicável às instâncias cuja carga está sendo balanceada, que permite a conectividade SSH de entrada na porta TCP 22 proveniente de qualquer endereço. Você pode escolher um intervalo de IP de origem mais restritivo para esta regra. Por exemplo, é possível especificar apenas os intervalos de IP do sistema do qual você inicia sessões SSH. Este exemplo usa a tag de destino allow-ssh para identificar as máquinas virtuais (VMs) às quais a regra de firewall se aplica.

Sem essas regras de firewall, a regra padrão de negação de entrada bloqueará o tráfego que chega para as instâncias de back-end.

Console

1. No console do Google Cloud , acesse a página Políticas de firewall.

   Acesse as políticas de firewall

2. Clique em Criar regra de firewall para criar a regra que permite as verificações de integridade do Google Cloud :
• Nome: fw-allow-health-check
• Rede: lb-network
• Direção do tráfego: entrada
• Ação na correspondência: permitir
• Destinos: tags de destino especificadas
• Tags de meta: load-balanced-backend
• Filtro de origem: intervalos IPv4
• Intervalos IPv4 de origem: 130.211.0.0/22 e 35.191.0.0/16
• Protocolos e portas:
  • Escolha Protocolos e portas especificados.
  • Marque a caixa de seleção TCP e insira 80 como o número da porta.

  Como prática recomendada, limite esta regra somente aos protocolos e portas que correspondem aos usados por sua verificação de integridade. Se você usar tcp:80 para o protocolo e a porta, o Google Cloud poderá usar HTTP na porta 80 para entrar em contato com suas VMs, mas não poderá usar HTTPS na porta 443.

3. Clique em Criar.
4. Clique em Criar regra de firewall para criar a regra que permite as verificações de integridade do Google Cloud :
• Nome: fw-allow-proxies
• Rede: lb-network
• Direção do tráfego: entrada
• Ação na correspondência: permitir
• Destinos: tags de destino especificadas
• Tags de meta: load-balanced-backend
• Filtro de origem: intervalos IPv4
• Intervalos IPv4 de origem: 10.129.0.0/23
• Protocolos e portas:
  • Escolha Protocolos e portas especificados.
  • Marque a caixa de seleção TCP e insira 80, 443, 8080 como os números de porta.
5. Clique em Criar.
6. Clique em Criar regra de firewall para criar a regra que permite as verificações de integridade do Google Cloud :
• Nome: fw-allow-ssh
• Rede: lb-network
• Direção do tráfego: entrada
• Ação na correspondência: permitir
• Destinos: tags de destino especificadas
• Tags de meta: allow-ssh
• Filtro de origem: intervalos IPv4
• Intervalos IPv4 de origem: 0.0.0.0/0
• Protocolos e portas:
  • Escolha Protocolos e portas especificados.
  • Marque a caixa de seleção TCP e insira 22 como o número da porta.
7. Clique em Criar.

gcloud

1. Crie a regra de firewall fw-allow-health-check para permitir verificações de integridade doGoogle Cloud . Neste exemplo, todo o tráfego TCP de sondagens de verificação de integridade é permitido. No entanto, é possível configurar um conjunto mais restrito de portas para atender às suas necessidades.

   gcloud compute firewall-rules create fw-allow-health-check \
      --network=lb-network \
      --action=allow \
      --direction=ingress \
      --source-ranges=130.211.0.0/22,35.191.0.0/16 \
      --target-tags=load-balanced-backend \
      --rules=tcp
   

2. Crie a regra de firewall fw-allow-proxies para permitir que o tráfego da sub-rede somente proxy do Envoy chegue aos seus back-ends:

   gcloud compute firewall-rules create fw-allow-proxies \
      --network=lb-network \
      --action=allow \
      --direction=ingress \
      --source-ranges=10.129.0.0/23 \
      --target-tags=load-balanced-backend \
      --rules=tcp:80,tcp:443,tcp:8080
   

3. Crie a regra de firewall fw-allow-ssh para permitir a conectividade SSH com VMs que tenham a tag de rede allow-ssh:

   gcloud compute firewall-rules create fw-allow-ssh \
      --network=lb-network \
      --action=allow \
      --direction=ingress \
      --target-tags=allow-ssh \
      --rules=tcp:22
   

Reservar um endereço IPv4 interno estático

Os administradores de projetos de serviço podem reservar um endereço IPv4 ou IPv6 interno em uma sub-rede de uma rede VPC compartilhada. O objeto de configuração de endereço IP é criado no projeto de serviço, mas o valor dele vem do intervalo de endereços IPv4 disponíveis na sub-rede compartilhada escolhida.

Para reservar um endereço IP interno autônomo no projeto de serviço, siga as etapas a seguir.

Console

1. Configurar VPC compartilhada.

2. No console do Google Cloud , acesse a página VPC compartilhada.

   Acessar VPC compartilhada

3. Faça login como administrador de VPC compartilhada.

4. Selecione o projeto de serviço no seletor de projetos.

5. Acesse Rede VPC >Endereços IP.

6. Na página Endereços IP, clique em Reservar endereço IP estático interno.

7. No campo Nome, digite l7-ilb-ip-address como o nome do endereço IP.

8. Na lista Versão IP, selecione IPv4.

9. Em Rede, selecione lb-network.

10. Nas listas Sub-rede, selecione lb-frontend-and-backend-subnet.

11. Clique em Reservar.

gcloud

1. Se ainda não tiver feito isso, autentique-se na Google Cloud CLI como um Administrador de projeto de serviço de VPC compartilhada.

   gcloud auth login SERVICE_PROJECT_ADMIN
   

   Substitua SERVICE_PROJECT_ADMIN pelo nome do administrador do projeto de serviço da VPC compartilhada. Esses valores precisam ter o formato "nomedeusuário@seudomínio", por exemplo, [e-mail].

2. Use o comando compute addresses create para reservar um endereço IP:

   
   gcloud compute addresses create l7-ilb-ip-address \
       --project SERVICE_PROJECT_1_ID \
       --subnet=lb-frontend-and-backend-subnet \
       --region=us-west1 \
       --ip-version=IPV4
   

Outros detalhes sobre a criação de endereços IP estão publicados na documentação do SDK.

Configurar a VPC compartilhada no projeto de serviço 1

Para configurar a VPC compartilhada no Projeto de serviço 1, você designa o Projeto de serviço 1 como o projeto host da VPC compartilhada e os Projetos de serviço 2 e 3 como os projetos de serviço da VPC compartilhada. Mais adiante neste tutorial, ao criar os back-ends do MIG nos projetos de serviço 2 e 3, você poderá usar a mesma rede VPC e as sub-redes criadas anteriormente no projeto de serviço 1.

1. Ativar um projeto host.
2. Anexar um projeto de serviço.

3. Conceda o papel de usuário da rede do Compute (roles/compute.networkUser) aos projetos de serviço 2 e 3:

   Console

   1. No console do Google Cloud , acesse a página IAM.

      Acessar IAM

   2. Clique em Conceder acesso. O painel Conceder acesso será aberto.

   3. No campo Novos participantes, insira [e-mail].

      Você pode encontrar os números de projeto de serviço no painel do projeto:

      Ir para o painel

   4. Clique em Selecionar uma função e, no campo Filtro, insira Compute Network User.

   5. Selecione o papel Usuário da rede do Compute e clique em Salvar.

   6. Repita as etapas anteriores para conceder o papel Compute Network User ao Projeto de serviço 3 ([e-mail]).

   gcloud

   1. No projeto de serviço 1, conceda o papel de usuário da rede do Compute ao projeto de serviço 2.

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_1_ID \
       --member='serviceAccount:[e-mail]' \
       --role='roles/compute.networkUser'
      

      Substitua SERVICE_PROJECT_2_NUMBER pelo número do projeto de serviço 2.

   2. No projeto de serviço 1, conceda o papel de usuário da rede do Compute ao projeto de serviço 3.

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_1_ID \
       --member='serviceAccount::[e-mail]' \
       --role='roles/compute.networkUser'
      

      Substitua SERVICE_PROJECT_3_NUMBER pelo número do projeto de serviço 3.

Importante: não continue até configurar a VPC compartilhada e ativar os projetos host e de serviço da VPC compartilhada.

Criar um serviço de back-end e MIGs no projeto de serviço 2

Todas as etapas nesta seção precisam ser realizadas no projeto de serviço 2.

Console

1. Criar um modelo de instância. No console do Google Cloud , acesse a página Modelos de instância.

   Acesse "Modelos de instância"

   1. Clique em Criar modelo de instância.
   2. Digite um Nome para o modelo de instância: tutorial-ig-template-sp2.
   3. Na seção Local, selecione Regional (recomendado) e us-west1(Oregon) como a Região.
   4. Na seção Configuração da máquina, selecione N2 como a série.
   5. Verifique se Disco de inicialização está definido como uma imagem Debian, como Debian GNU/Linux 12 (bookworm): Estas instruções usam comandos disponíveis apenas no Debian, como apt-get. Se você precisar mudar o disco de inicialização, clique em Mudar.
      1. Em Sistema operacional, selecione Debian.
      2. Em Versão, selecione uma das imagens Debian disponíveis, como Debian GNU/Linux 12 (bookworm).
      3. Clique em Selecionar.
   6. Clique em Opções avançadas e em Rede.
   7. Insira as seguintes tags de rede: allow-ssh,load-balanced-backend.
   8. Na seção Interfaces de rede, selecione Redes compartilhadas comigo (do projeto host: SERVICE_PROJECT_1_ID).
   9. Selecione a sub-rede lb-frontend-and-backend-subnet na rede lb-network.
   10. Clique em Gerenciamento. Em Gerenciamento, insira o script a seguir no campo Script de inicialização.

       #! /bin/bash
       apt-get update
       apt-get install apache2 -y
       a2ensite default-ssl
       a2enmod ssl
       vm_hostname="$(curl -H "Metadata-Flavor:Google" http://metadata.google.internal/computeMetadata/v1/instance/name)"
       echo "Page served from: $vm_hostname" | tee /var/www/html/index.html
       systemctl restart apache2
       

   11. Clique em Criar.

2. criar um grupo gerenciado de instâncias. No console do Google Cloud , acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

   1. Clique em Criar grupo de instâncias.
   2. Escolha Novo grupo gerenciado de instâncias (sem estado). Para mais informações, consulte MIGs sem estado ou com estado.
   3. Digite um Nome para o grupo de instâncias: tutorial-sp2-mig-a.
   4. Em Modelo de instância, selecione tutorial-ig-template-sp2.
   5. Em Local, selecione Zona única.
   6. Em Região, selecione us-west1.

   7. Especifique o número de instâncias que você quer criar no grupo.

      Neste exemplo, especifique as seguintes opções em Escalonamento automático:

      • Em Modo de escalonamento automático, selecione Off:do not autoscale.
      • Em Número máximo de instâncias, insira 2.

   8. Clique em Criar.

3. Criar um serviço de back-end regional Como parte desta etapa, também criamos a verificação de integridade e adicionamos back-ends ao serviço de back-end. No console do Google Cloud , acesse a página Back-ends.

   Acessar back-ends

   1. Clique em Criar serviço de back-end.
   2. Na caixa de diálogo Criar serviço de back-end, clique em Criar ao lado de Serviço de back-end regional.
   3. Digite um Nome para o serviço de back-end: tutorial-backend-service-sp2.
   4. Em Região, selecione us-west1.
   5. Em Tipo de balanceador de carga, selecione Balanceador de carga de aplicativo interno regional (INTERNAL_MANAGED).
   6. Defina o Tipo de back-end como Grupo de instâncias.
   7. Na seção Back-ends, defina os seguintes campos:
      1. Defina o Grupo de instâncias como tutorial-sp2-mig-a.
      2. Digite os Números de porta: 80.
      3. Defina Modo de balanceamento como Utilização.
      4. Clique em Concluído.
   8. Na seção Verificação de integridade, clique em Criar uma verificação de integridade e defina os seguintes campos:
      1. Nome: tutorial-regional-health-check
      2. Protocolo: HTTP
      3. Porta: 80
      4. Clique em Salvar.
   9. Clique em Continuar.
   10. Clique em Criar.

4. Repita as etapas anteriores e crie um grupo gerenciado de instâncias, tutorial-sp2-mig-b, e adicione-o ao serviço de back-end, tutorial-backend-service-sp2.

gcloud

1. Selecione o projeto de serviço que você criou:

   gcloud config set project SERVICE_PROJECT_2_ID

2. Crie um modelo de instância de VM, tutorial-ig-template-sp2 com um servidor HTTP:

   gcloud compute instance-templates create tutorial-ig-template-sp2 \
       --region=us-west1 \
       --network=projects/SERVICE_PROJECT_1_ID/global/networks/lb-network \
       --subnet=projects/SERVICE_PROJECT_1_ID/regions/us-west1/subnetworks/lb-frontend-and-backend-subnet \
       --tags=allow-ssh,load-balanced-backend \
       --image-family=debian-12 \
       --image-project=debian-cloud \
       --metadata=startup-script='#! /bin/bash
       apt-get update
       apt-get install apache2 -y
       a2ensite default-ssl
       a2enmod ssl
       vm_hostname="$(curl -H "Metadata-Flavor:Google" \
       http://metadata.google.internal/computeMetadata/v1/instance/name)"
       echo "Page served from: $vm_hostname" | \
       tee /var/www/html/index.html
       systemctl restart apache2' \
       --project=SERVICE_PROJECT_2_ID
   

   Substitua:

   • SERVICE_PROJECT_1_ID: o ID do projeto host da VPC compartilhada.
   • SERVICE_PROJECT_2_ID: o ID do projeto de serviço, em que os back-ends do balanceador de carga e o serviço de back-end estão sendo criados.

3. Crie um grupo gerenciado de instâncias, tutorial-sp2-mig-a na região:

   gcloud compute instance-groups managed create tutorial-sp2-mig-a \
       --region=us-west1 \
       --size=2 \
       --template=tutorial-ig-template-sp2 \
       --project=SERVICE_PROJECT_2_ID
   

4. Defina a verificação de integridade HTTP, tutorial-regional-health-check:

   gcloud compute health-checks create http tutorial-regional-health-check \
     --region=us-west1 \
     --use-serving-port \
     --project=SERVICE_PROJECT_2_ID
   

5. Defina o serviço de back-end, tutorial-backend-service-sp2:

   gcloud compute backend-services create tutorial-backend-service-sp2 \
     --load-balancing-scheme=INTERNAL_MANAGED \
     --protocol=HTTP \
     --health-checks=tutorial-regional-health-check \
     --health-checks-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_2_ID
   

6. Adicione back-ends ao serviço de back-end com o comando gcloud compute backend-services add-backend:

   gcloud compute backend-services add-backend tutorial-backend-service-sp2 \
     --balancing-mode=UTILIZATION \
     --instance-group=tutorial-sp2-mig-a \
     --instance-group-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_2_ID
   

7. Crie outro grupo gerenciado de instâncias, tutorial-sp2-mig-b na região:

   gcloud compute instance-groups managed create tutorial-sp2-mig-b \
       --region=us-west1 \
       --size=2 \
       --template=tutorial-ig-template-sp2 \
       --project=SERVICE_PROJECT_2_ID
   

8. Adicione back-ends ao serviço de back-end:

   gcloud compute backend-services add-backend tutorial-backend-service-sp2 \
     --balancing-mode=UTILIZATION \
     --instance-group=tutorial-sp2-mig-b \
     --instance-group-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_2_ID
   

Criar um serviço de back-end e MIGs no projeto de serviço 3

Todas as etapas desta seção precisam ser realizadas no projeto de serviço 3.

Console

1. Criar um modelo de instância. No console do Google Cloud , acesse a página Modelos de instância.

   Acesse "Modelos de instância"

   1. Clique em Criar modelo de instância.
   2. Digite um Nome para o modelo de instância: tutorial-ig-template-sp3.
   3. Na seção Local, selecione Regional (recomendado) e us-west1(Oregon) como a Região.
   4. Na seção Configuração da máquina, selecione N2 como a série.
   5. Verifique se Disco de inicialização está definido como uma imagem Debian, como Debian GNU/Linux 12 (bookworm): Estas instruções usam comandos disponíveis apenas no Debian, como apt-get. Se você precisar mudar o disco de inicialização, clique em Mudar.
      1. Em Sistema operacional, selecione Debian.
      2. Em Versão, selecione uma das imagens Debian disponíveis, como Debian GNU/Linux 12 (bookworm).
      3. Clique em Selecionar.
   6. Clique em Opções avançadas e em Rede.
   7. Insira as seguintes tags de rede: allow-ssh,load-balanced-backend.
   8. Na seção Interfaces de rede, selecione Redes compartilhadas comigo (do projeto host: SERVICE_PROJECT_1_ID).
   9. Selecione a sub-rede lb-frontend-and-backend-subnet na rede lb-network.
   10. Clique em Gerenciamento. Em Gerenciamento, insira o script a seguir no campo Script de inicialização.

       #! /bin/bash
       apt-get update
       apt-get install apache2 -y
       a2ensite default-ssl
       a2enmod ssl
       vm_hostname="$(curl -H "Metadata-Flavor:Google" http://metadata.google.internal/computeMetadata/v1/instance/name)"
       echo "Page served from: $vm_hostname" | tee /var/www/html/index.html
       systemctl restart apache2
       

   11. Clique em Criar.

2. criar um grupo gerenciado de instâncias. No console do Google Cloud , acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

   1. Clique em Criar grupo de instâncias.
   2. Escolha Novo grupo gerenciado de instâncias (sem estado). Para mais informações, consulte MIGs sem estado ou com estado.
   3. Digite um Nome para o grupo de instâncias: tutorial-sp3-mig-a.
   4. Em Modelo de instância, selecione tutorial-ig-template-sp3.
   5. Em Local, selecione Zona única.
   6. Em Região, selecione us-west1.

   7. Especifique o número de instâncias que você quer criar no grupo.

      Neste exemplo, especifique as seguintes opções em Escalonamento automático:

      • Em Modo de escalonamento automático, selecione Off:do not autoscale.
      • Em Número máximo de instâncias, insira 2.

   8. Clique em Criar.

3. Criar um serviço de back-end regional Como parte desta etapa, também criamos a verificação de integridade e adicionamos back-ends ao serviço de back-end. No console do Google Cloud , acesse a página Back-ends.

   Acessar back-ends

   1. Clique em Criar serviço de back-end.
   2. Na caixa de diálogo Criar serviço de back-end, clique em Criar ao lado de Serviço de back-end regional.
   3. Digite um Nome para o serviço de back-end: tutorial-backend-service-sp3.
   4. Em Região, selecione us-west1.
   5. Em Tipo de balanceador de carga, selecione Balanceador de carga de aplicativo interno regional (INTERNAL_MANAGED).
   6. Defina o Tipo de back-end como Grupo de instâncias.
   7. Na seção Back-ends, defina os seguintes campos:
      1. Defina o Grupo de instâncias como tutorial-sp3-mig-a.
      2. Digite os Números de porta: 80.
      3. Defina Modo de balanceamento como Utilização.
      4. Clique em Concluído.
   8. Na seção Verificação de integridade, clique em Criar uma verificação de integridade e defina os seguintes campos:
      1. Nome: tutorial-regional-health-check
      2. Protocolo: HTTP
      3. Porta: 80
      4. Clique em Salvar.
   9. Clique em Continuar.
   10. Clique em Criar.

4. Repita as etapas anteriores e crie um grupo gerenciado de instâncias, tutorial-sp3-mig-b, e adicione-o ao serviço de back-end, tutorial-backend-service-sp3.

gcloud

1. Selecione o projeto de serviço que você criou:

   gcloud config set project SERVICE_PROJECT_3_ID

2. Crie um modelo de instância de VM, tutorial-ig-template-sp3 com um servidor HTTP:

   gcloud compute instance-templates create tutorial-ig-template-sp3 \
       --region=us-west1 \
       --network=projects/SERVICE_PROJECT_1_ID/global/networks/lb-network \
       --subnet=projects/SERVICE_PROJECT_1_ID/regions/us-west1/subnetworks/lb-frontend-and-backend-subnet \
       --tags=allow-ssh,load-balanced-backend \
       --image-family=debian-12 \
       --image-project=debian-cloud \
       --metadata=startup-script='#! /bin/bash
       apt-get update
       apt-get install apache2 -y
       a2ensite default-ssl
       a2enmod ssl
       vm_hostname="$(curl -H "Metadata-Flavor:Google" \
       http://metadata.google.internal/computeMetadata/v1/instance/name)"
       echo "Page served from: $vm_hostname" | \
       tee /var/www/html/index.html
       systemctl restart apache2' \
       --project=SERVICE_PROJECT_3_ID
   

   Substitua:

   • SERVICE_PROJECT_1_ID: o ID do projeto host da VPC compartilhada.
   • SERVICE_PROJECT_3_ID: o ID do projeto de serviço, em que os back-ends do balanceador de carga e o serviço de back-end estão sendo criados.

3. Crie um grupo gerenciado de instâncias, tutorial-sp3-mig-a na região:

   gcloud compute instance-groups managed create tutorial-sp3-mig-a \
       --region=us-west1 \
       --size=2 \
       --template=tutorial-ig-template-sp3 \
       --project=SERVICE_PROJECT_3_ID
   

4. Defina a verificação de integridade HTTP, tutorial-regional-health-check:

   gcloud compute health-checks create http tutorial-regional-health-check \
     --region=us-west1 \
     --use-serving-port \
     --project=SERVICE_PROJECT_3_ID
   

5. Defina o serviço de back-end, tutorial-backend-service-sp3:

   gcloud compute backend-services create tutorial-backend-service-sp3 \
     --load-balancing-scheme=INTERNAL_MANAGED \
     --protocol=HTTP \
     --health-checks=tutorial-regional-health-check \
     --health-checks-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_3_ID
   

6. Adicione back-ends ao serviço de back-end com o comando gcloud compute backend-services add-backend:

   gcloud compute backend-services add-backend tutorial-backend-service-sp3 \
     --balancing-mode=UTILIZATION \
     --instance-group=tutorial-sp3-mig-a \
     --instance-group-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_3_ID
   

7. Crie outro grupo gerenciado de instâncias, tutorial-sp3-mig-b na região:

   gcloud compute instance-groups managed create tutorial-sp3-mig-b \
       --region=us-west1 \
       --size=2 \
       --template=tutorial-ig-template-sp3 \
       --project=SERVICE_PROJECT_3_ID
   

8. Adicione back-ends ao serviço de back-end:

   gcloud compute backend-services add-backend tutorial-backend-service-sp3 \
     --balancing-mode=UTILIZATION \
     --instance-group=tutorial-sp3-mig-b \
     --instance-group-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_3_ID
   

Criar o mapa de URL e a regra de encaminhamento no projeto de serviço 1

Todas as etapas nesta seção precisam ser realizadas no projeto de serviço 1.

Console

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 Interno e clique em Próxima.
5. Em Implantação entre regiões ou região única, selecione Melhor para cargas de trabalho regionais e clique em Próxima.
6. Clique em Configurar.

Configuração básica

1. Insira um Nome para o balanceador de carga, tutorial-url-maps.
2. Na lista Região, selecione us-west1.

3. Na lista Rede, selecione lb-network (do Projeto: SERVICE_PROJECT_1_ID).

   Se você receber um aviso Sub-rede somente proxy necessária na rede VPC compartilhada, confirme se o administrador do projeto de host criou o proxy-only-subnet na região us-west1 na rede VPC compartilhada lb-network. A criação do balanceador de carga será bem-sucedida mesmo que você não tenha permissão para visualizar a sub-rede somente proxy nesta página.

4. Mantenha a janela aberta para continuar.

Configure o back-end

1. Clique em Configuração de back-end.
2. Clique em Serviços de back-end entre projetos.
3. No campo ID do projeto, insira o ID do projeto para o projeto de serviço 2.
4. No campo Nome do serviço de back-end, insira o nome do serviço de back-end do projeto de serviço 2 que você quer usar. Para este exemplo, é tutorial-backend-service-sp2.
5. Clique em Adicionar serviço de back-end.
6. No campo ID do projeto, insira o ID do projeto para o Projeto de serviço 3.
7. No campo Nome do serviço de back-end, insira o nome do serviço de back-end do projeto de serviço 3 que você quer usar. Para este exemplo, é tutorial-backend-service-sp3.
8. Clique em Adicionar serviço de back-end.

Configurar as regras de roteamento

1. Clique em Regras de roteamento.
2. Na seção Regras de host e caminho, no campo Host 2, insira *.
3. No campo Caminhos 2, digite /*.
4. Na lista suspensa Back-end 2, selecione tutorial-backend-service-sp2.
5. Clique em Adicionar regra de host e caminho.
6. No campo Host 3, insira tutorial-host.
7. No campo Caminhos 3, digite /*.

8. Na lista suspensa Back-end 3, selecione tutorial-backend-service-sp3.

   Observação: se um serviço de back-end não for adicionado às regras de host e de caminho do mapa de URL, o serviço de back-end vai permanecer não usado pelo balanceador de carga. Por isso, ele não vai aparecer nas páginas Detalhes e Editar do balanceador de carga.

9. Procure a marca de seleção azul à esquerda de Regras de host e caminho e clique no botão Atualizar.

   Saiba mais sobre gerenciamento de tráfego em Como configurar o gerenciamento de tráfego.

Configure o front-end

Para que o serviço de projetos cruzados faça referência, o front-end precisa usar a mesma rede (lb-network) do projeto host da VPC compartilhada que foi usada para criar o serviço de back-end.

1. Clique em Configuração de front-end.
2. Insira um nome para a regra de encaminhamento: l7-ilb-forwarding-rule.
3. Defina Protocolo como HTTP.
4. Defina o Sub-rede para lb-frontend-and-backend-subnet. Não selecione a sub-rede exclusiva de proxy para o front-end, mesmo que seja uma opção na lista.
5. Defina a Porta como 80.
6. No campo Endereço IP, mantenha a opção padrão, Temporário (automático).
7. Clique em Concluído.

Revise e finalize a configuração

• Clique em Criar.

gcloud

1. Selecione o projeto de serviço que você criou:

   gcloud config set project SERVICE_PROJECT_1_ID

2. Crie o mapa de URL, tutorial-url-maps, e defina o serviço padrão como o serviço de back-end criado no projeto de serviço 1:

   gcloud compute url-maps create tutorial-url-maps \
       --default-service=projects/SERVICE_PROJECT_2_ID/regions/us-west1/backendServices/tutorial-backend-service-sp2 \
       --region=us-west1 \
       --project=SERVICE_PROJECT_1_ID
   

   Substitua:

   • SERVICE_PROJECT_2_ID: o ID do projeto de serviço 2, em que os back-ends do balanceador de carga e o serviço de back-end são criados.
   • SERVICE_PROJECT_1_ID: o ID do projeto de serviço 1, em que o front-end do balanceador de carga está sendo criado.

3. Crie o proxy de destino, tutorial-http-proxy:

   gcloud compute target-http-proxies create tutorial-http-proxy \
     --url-map=tutorial-url-maps \
     --url-map-region=us-west1 \
     --region=us-west1 \
     --project=SERVICE_PROJECT_1_ID
   

4. Crie a regra de encaminhamento, l7-ilb-forwarding-rule, para processar o tráfego HTTP. Para que a referência de serviço entre projetos funcione, a regra de encaminhamento precisa usar a mesma rede (lb-network) do projeto host da VPC compartilhada que foi usada para criar o serviço de back-end.

   gcloud compute forwarding-rules create l7-ilb-forwarding-rule \
     --load-balancing-scheme=INTERNAL_MANAGED \
     --network=projects/SERVICE_PROJECT_1_ID/global/networks/lb-network \
     --subnet=projects/SERVICE_PROJECT_1_ID/regions/us-west1/subnetworks/lb-frontend-and-backend-subnet \
     --address=l7-ilb-ip-address \
     --ports=80 \
     --region=us-west1 \
     --target-http-proxy=tutorial-http-proxy \
     --target-http-proxy-region=us-west1 \
     --project=SERVICE_PROJECT_1_ID
   

5. Para enviar tráfego ao serviço de back-end, vincule o mapa de URLs ao serviço de back-end. Para mais informações, consulte Usar mapas de URL.

   1. Vincule o serviço de back-end tutorial-backend-service-sp2 no projeto de serviço 2 ao mapa de URL tutorial-url-maps e ao nome do correspondente de caminho tutorial-path-matcher-sp2:

      gcloud compute url-maps add-path-matcher tutorial-url-maps \
         --path-matcher-name=tutorial-path-matcher-sp2 \
         --default-service=projects/SERVICE_PROJECT_2_ID/regions/us-west1/backendServices/tutorial-backend-service-sp2 \
         --region=us-west1
      

   2. Vincule o serviço de back-end, tutorial-backend-service-sp3, no projeto de serviço 3 ao mapa de URL, tutorial-url-maps, e ao nome do correspondente de caminho, tutorial-path-matcher-sp3. Adicione uma nova regra de host, tutorial-host, com os hosts fornecidos para que a correspondência de caminho seja vinculada à nova regra de host.

      gcloud compute url-maps add-path-matcher tutorial-url-maps \
        --path-matcher-name=tutorial-path-matcher-sp3 \
        --default-service=projects/SERVICE_PROJECT_3_ID/regions/us-west1/backendServices/tutorial-backend-service-sp3 \
        --region=us-west1 \
        --new-hosts=tutorial-host
      

Testar o balanceador de carga

Para testar o balanceador de carga, primeiro crie uma VM de cliente de amostra. Em seguida, estabeleça uma sessão SSH com a VM e envie o tráfego dessa VM para o balanceador de carga.

Criar uma instância de VM de teste

Os clientes podem estar localizados no projeto host da VPC compartilhada ou em qualquer projeto de serviço conectado. Neste exemplo, você testa se o balanceador de carga está funcionando ao implantar uma VM cliente no projeto de serviço 1, que é designado como o projeto host da VPC compartilhada. O cliente precisa usar a mesma rede VPC compartilhada e estar na mesma região do balanceador de carga.

Todas as etapas nesta seção precisam ser realizadas no projeto de serviço 2.

Console

1. No console do Google Cloud , acesse a página Instâncias de VM.

   Acessar instâncias de VM

2. Clique em Criar instância.

3. No campo Nome, use client-vm.

4. Defina a Zona como us-west1-b.

5. Clique em Opções avançadas e em Rede.

6. Insira as seguintes tags de rede: allow-ssh,load-balanced-backend.

7. Na seção Interfaces de rede, selecione Redes compartilhadas comigo (do projeto host: SERVICE_PROJECT_1_ID).

8. Selecione a sub-rede lb-frontend-and-backend-subnet na rede lb-network.

9. Clique em Criar.

gcloud

Crie uma instância de VM de teste.

gcloud compute instances create client-vm \
    --image-family=debian-12 \
    --image-project=debian-cloud \
    --subnet=projects/SERVICE_PROJECT_1_ID/regions/us-west1/subnetworks/lb-frontend-and-backend-subnet \
    --zone=us-west1-b \
    --tags=allow-ssh \
    --project=SERVICE_PROJECT_2_ID

Enviar tráfego ao balanceador de carga

Use o SSH para se conectar à instância que você acabou de criar e teste se os serviços HTTP(S) nos back-ends podem ser acessados pelo endereço IP da regra de encaminhamento do balanceador de carga de aplicativo interno e se o tráfego está com balanceamento de carga entre as instâncias de back-end.

1. Extraia o valor do endereço IP do balanceador de carga:

   gcloud compute addresses list --filter="name=( 'l7-ilb-ip-address')"
   

   Você verá uma saída semelhante a esta:

   NAME: l7-ilb-ip-address
   ADDRESS/RANGE: 10.1.2.2
   TYPE: INTERNAL
   PURPOSE: GCE_ENDPOINT
   NETWORK:
   REGION: us-west1
   SUBNET: lb-frontend-and-backend-subnet
   STATUS: IN_USE
   

   Copie o ADDRESS/RANGE do serviço, por exemplo, 10.1.2.2 da saída para usar nas próximas etapas.

2. Conecte-se à instância do cliente com SSH:

   gcloud compute ssh client-vm \
      --zone=us-west1-b \
      --project=SERVICE_PROJECT_2_ID
   

3. Verifique se o endereço IP do balanceador de carga está exibindo o nome do host:

   1. Verifique se o endereço IP está exibindo o nome de host no Projeto de serviço 2:

      curl 10.1.2.2
      

      Você verá uma saída semelhante a esta:

      Page served from: tutorial-sp2-mig-a-10xk
      

   2. Verifique se o endereço IP está exibindo o nome de host no projeto de serviço 3:

      curl -H "Host: tutorial-host" 10.1.2.2
      

      Você verá uma saída semelhante a esta:

      Page served from: tutorial-sp3-mig-a-3d5h
      

Conceder permissões do IAM

Forneça as permissões e os papéis do IAM apropriados ao host do App Hub e aos projetos de serviço.

Console

1. No console Google Cloud , acesse a página do seletor de projetos.

   Acessar o seletor de projetos

2. Selecione o projeto host do hub de apps.

3. No console do Google Cloud , acesse a página IAM.

   Acessar IAM

4. Clique em Conceder acesso. O painel Conceder acesso será aberto.

5. No campo Novos participantes, insira o endereço de e-mail da pessoa que vai administrar o App Hub, a função Administrador do App Hub no projeto de hospedagem do App Hub.

6. Clique em Selecionar um papel e, no campo Filtro, insira App Hub.

7. Selecione a função Administrador do App Hub e clique em Salvar.

8. Em cada um dos projetos de serviço do App Hub, conceda a função de administrador do App Hub ao mesmo usuário.

gcloud

1. Para conceder as funções a pessoas que vão usar o App Hub, repita o comando a seguir substituindo as funções do IAM, conforme necessário. Para mais informações, consulte Papéis e permissões do App Hub.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/apphub.admin'

   Substitua HOST_PROJECT_ADMIN pelo usuário que tem a função de administrador do App Hub no projeto host do App Hub. Esse valor tem o formato username@yourdomain, por exemplo, [e-mail].

2. Conceda a função de administrador do App Hub no projeto de serviço às pessoas que administram o App Hub. Eles precisam ter o papel de administrador do App Hub para adicionar projetos de serviço ao projeto host. É necessário ter pelo menos uma pessoa com essa função para cada projeto de serviço.

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
      --member='user:HOST_PROJECT_ADMIN' \
      --role='roles/apphub.admin'

   Substitua SERVICE_PROJECT_ID pelo ID dos projetos de serviço.

Anexar os projetos de serviço

Os projetos de serviço são Google Cloud projetos que contêm recursos de infraestrutura que podem ser registrados em um aplicativo do App Hub. Para mais informações, consulte Projetos de serviço. Anexe os projetos de serviço em que você implantou os recursos ao projeto host do App Hub.

Console

1. No console do Google Cloud , acesse a página Configurações do App Hub.

   Acesse configurações

2. Na página Configurações, clique em Anexar projetos.

3. No painel que abrir, pesquise projetos na lista exibida e marque as caixas de seleção dos projetos que você quer adicionar como projetos de serviço.

4. Clique em Selecionar. A tabela Attached Service Project(s) mostra os projetos de serviço selecionados.

5. Clique em Fechar.

gcloud

1. Anexe os projetos de serviço 1, 2 e 3 ao projeto host do App Hub.

   gcloud apphub service-projects add SERVICE_PROJECT_1_ID \
     --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_2_ID \
     --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_3_ID \
     --project=HOST_PROJECT_ID
   

2. Confirme se você anexou os projetos de serviço do App Hub ao projeto host do App Hub:

   gcloud apphub service-projects list --project=HOST_PROJECT_ID
   

Depois de anexar o projeto de serviço ao projeto host do App Hub, você pode conferir todos os recursos do Google Cloud do projeto de serviço anexado como serviços e cargas de trabalho descobertos do App Hub. Para mais informações sobre como visualizar esses serviços e cargas de trabalho descobertos, consulte Conferir aplicativos, serviços e cargas de trabalho atuais.

Criar um aplicativo

Crie um aplicativo para ser o contêiner dos seus serviços e cargas de trabalho. Ao criar um aplicativo, é possível atribuir propriedades imutáveis, como um tipo de escopo ou local em que você quer registrar recursos e atributos variáveis, como criticidade e ambiente. É possível usar os atributos variáveis para filtrar as aplicações. Para mais informações, consulte Propriedades e atributos.

Neste tutorial, você vai criar um aplicativo Global para ajudar a gerenciar recursos globais e regionais em um único aplicativo. Se você quiser agrupar seus recursos de uma região específica, crie um aplicativo Regional e registre esses recursos. Para mais informações sobre como criar um aplicativo regional, consulte Configurar o App Hub.

Console

1. Verifique se você está no projeto host do App Hub.

2. No console do Google Cloud , acesse a página Aplicativos do App Hub.

   Acesse Aplicativos

3. Clique em Criar aplicativo.

4. Na página Criar aplicativo, no painel Escolher a região e o nome do aplicativo, selecione Global.

5. No campo Nome do aplicativo, digite tutorial-application. Esse nome é um identificador exclusivo e não pode ser alterado depois que você cria o aplicativo.

6. Insira um Nome de exibição, Tutorial e clique em Continuar. É um nome fácil de usar que pode ser atualizado. Para mais informações, consulte Atualizar um aplicativo atual.

7. No painel Adicionar atributos, na lista Gravidade, selecione Alta. A importância indica o quanto um aplicativo, serviço ou carga de trabalho é importante para as operações comerciais.

8. No campo Ambiente, para indicar o estágio do ciclo de vida do software, selecione Produção.

9. Clique em Continuar.

10. No painel Adicionar proprietários, adicione os seguintes detalhes para Proprietários do desenvolvedor, Proprietários do operador e Proprietários da empresa. É necessário inserir o endereço de e-mail do proprietário se você adicionar um nome de exibição.

    1. Insira o nome de exibição de um proprietário.
    2. Insira o endereço de e-mail do proprietário. Esse valor precisa ter o formato username@yourdomain, por exemplo, [e-mail].

11. Repita essas etapas para cada desenvolvedor, operador e proprietário de empresa.

12. Clique em Criar.

O novo aplicativo é criado e listado na página Aplicativos. Somente a regra de encaminhamento, o mapa de URL, o serviço de back-end e o grupo de instâncias gerenciadas (MIG, na sigla em inglês) ficam disponíveis como recursos descobertos no aplicativo App Hub. Para mais informações, consulte conceitos e modelo de dados.

gcloud

1. Selecione o projeto host do App Hub que você criou:

   gcloud config set project HOST_PROJECT_ID

2. Crie um novo aplicativo chamado tutorial-application na região global e atribua um nome de exibição, Tutorial. Esse nome de aplicativo, tutorial-application, é um identificador exclusivo e não pode ser alterado depois que você cria o aplicativo. O nome de exibição,Tutorial, é um nome fácil de usar que pode ser atualizado. Para mais informações, consulte Atualizar um aplicativo atual.

   gcloud apphub applications create tutorial-application \
       --display-name='Tutorial' \
       --scope-type=GLOBAL \
       --project=HOST_PROJECT_ID \
       --location=global
   

3. Liste os aplicativos no projeto host do App Hub:

   gcloud apphub applications list \
       --project=HOST_PROJECT_ID \
       --location=global
   

   Você verá uma saída semelhante a esta:

   ID                    DISPLAY_NAME  CREATE_TIME
   tutorial-application  Tutorial      2023-10-31T18:33:48
   

4. Atualize seu app com os atributos criticality-type, environment-type e proprietário:

   gcloud apphub applications update tutorial-application \
     --criticality-type='HIGH' \
     --environment-type='PRODUCTION' \
     --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
     --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
     --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
     --project=HOST_PROJECT_ID \
     --location=global
   

   Substitua:

   • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formato username@yourdomain, por exemplo, [e-mail].

   Observações:

   • criticality-type: indica a importância de um aplicativo, serviço ou carga de trabalho para as operações de negócios.
   • environment-type: indica as fases do ciclo de vida do software.

5. Confira os detalhes do app que você criou:

   gcloud apphub applications describe tutorial-application \
     --project=HOST_PROJECT_ID \
     --location=global
   

   O comando retorna informações no formato YAML, semelhante a este:

   attributes:
   businessOwners:
   – displayName: [DISPLAY-NAME-BUSINESS]
     email: [EMAIL-BUSINESS]
   criticality:
     type: HIGH
   developerOwners:
   – displayName: [DISPLAY-NAME-DEVELOPER]
     email: [EMAIL-DEVELOPER]
   environment:
     type: PRODUCTION
   operatorOwners:
   – displayName: [DISPLAY-NAME-OPERATOR]
     email: [EMAIL-OPERATOR]
   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: Tutorial
   name: projects/HOST_PROJECT_ID/locations/global/applications/tutorial-application
   scope:
     type: REGIONAL
   state: ACTIVE
   uid: 9d991a9d-5d8a-4c0d-b5fd-85e39fb58c73
   updateTime: '2023-10-31T18:33:48.343303819Z'
   

Registrar serviços e cargas de trabalho

O registro de serviços e cargas de trabalho os adiciona a um aplicativo que permite monitorar os recursos adicionados.

Console

1. No console do Google Cloud , acesse a página Aplicativos do App Hub.

   Acesse Aplicativos

2. Clique no nome do seu aplicativo, Tutorial. A guia Serviços e cargas de trabalho é mostrada com uma lista de serviços e cargas de trabalho registrados nos projetos de serviço do App Hub.

3. Registre um serviço:

   1. Na guia Serviços e cargas de trabalho, clique em Registrar serviço/carga de trabalho.
   2. Na página Registrar serviço ou carga de trabalho, no painel Selecionar recurso, clique em Procurar para selecionar o serviço ou a carga de trabalho como um Recurso.
   3. No painel Selecionar recurso, escolha o Nome do serviço, tutorial-backend-service-sp2, e clique em Selecionar.
   4. No painel Select resource, insira o Nome do recurso, tutorial-service-backend-sp2.
   5. Insira um Nome de exibição, Backend service (SP2) e clique em Continuar.
   6. No painel Add attributes, na lista Criticality, para indicar a importância do aplicativo, selecione High.
   7. No campo Ambiente, para indicar o estágio do ciclo de vida do software, selecione Produção.
   8. Clique em Continuar.
   9. No painel Adicionar proprietários, adicione os seguintes detalhes conforme necessário para Proprietários do desenvolvedor, Proprietários do operador e Proprietários da empresa. É necessário inserir o endereço de e-mail do proprietário se você adicionar um nome de exibição.
      1. Insira o nome de exibição de um proprietário.
      2. Insira o endereço de e-mail do proprietário. Esse valor precisa ter o formato username@yourdomain, por exemplo, [e-mail].
   10. Repita essas etapas para cada desenvolvedor, operador e proprietário de empresa.
   11. Clique em Registrar.

   Na guia Serviços e cargas de trabalho, na seção Serviços e cargas de trabalho registrados, você pode conferir o novo serviço adicionado.

4. Repita as etapas anteriores para registrar os outros serviços como tutorial-service-backend-sp3, tutorial-service-forwarding-rule e tutorial-service-url-map, respectivamente.
5. Para registrar uma carga de trabalho, repita as etapas anteriores para registrar um serviço com as seguintes exceções:
   1. No painel Registrar serviço ou carga de trabalho, na seção Escolher serviço ou carga de trabalho, selecione o Nome da carga de trabalho, tutorial-sp2-mig-a, e clique em Continuar.
   2. No painel Select resource, insira o Nome do recurso, tutorial-workload-sp2-mig-a.
   3. Insira um Nome de exibição, Instance group - A (SP2) e clique em Continuar.
6. Repita as etapas anteriores para registrar as outras cargas de trabalho como tutorial-workload-sp2-mig-a, tutorial-workload-sp2-mig-b, tutorial-workload-sp3-mig-a e tutorial-workload-sp3-mig-b, respectivamente.

gcloud

1. Adicione uma pessoa com permissões de editor do App Hub:

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
     --member='user:APP_HUB_EDITOR' \
     --role='roles/apphub.editor'
   

   Substitua APP_HUB_EDITOR pelo usuário que tem a função de editor do App Hub no projeto host do App Hub. Esse valor tem o formato username@yourdomain, por exemplo, [e-mail].

2. Listar todos os serviços descobertos no projeto host do App Hub. Esse comando retorna os serviços que estão disponíveis para registro em um aplicativo.

   gcloud apphub discovered-services list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Você verá uma saída semelhante a esta:

   ID                             SERVICE_REFERENCE                                                                                                                      SERVICE_PROPERTIES
   BACKEND_SERVICE_SP2_ID      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/us-west1/backendServices/tutorial-backend-service-sp2'}  {'gcpProject': 'projects/SERVICE_PROJECT_2_ID', 'location': 'us-west1'}
   BACKEND_SERVICE_SP3_ID      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_3_NUMBER]/regions/us-west1/backendServices/tutorial-backend-service-sp3'}  {'gcpProject': 'projects/SERVICE_PROJECT_3_ID', 'location': 'us-west1'}
   FORWARDING_RULE_SERVICE_ID  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/us-west1/forwardingRules/l7-ilb-forwarding-rule'}        {'gcpProject': 'projects/SERVICE_PROJECT_1_ID', 'location': 'us-west1'}
   URL_MAP_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/us-west1/urlMaps/tutorial-url-maps'}                     {'gcpProject': 'projects/SERVICE_PROJECT_1_ID', 'location': 'us-west1'}
   

   Copie os IDs do serviço, por exemplo, BACKEND_SERVICE_SP2_ID da saída para usar na próxima etapa.

3. Registre os serviços da etapa anterior no seu aplicativo. Copie os IDs de serviço do campo de saída na etapa anterior.

   gcloud apphub applications services create tutorial-service-backend-sp2 \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_SP2_ID' \
       --display-name='Backend service (SP2)' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   gcloud apphub applications services create tutorial-service-backend-sp3 \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_SP3_ID' \
       --display-name='Backend service (SP3)' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   gcloud apphub applications services create tutorial-service-forwarding-rule \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
       --display-name='Forwarding rule' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   gcloud apphub applications services create tutorial-service-url-map \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/URL_MAP_SERVICE_ID' \
       --display-name='URL map' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   Substitua:

   • BACKEND_SERVICE_SP2_ID: o serviço ID do serviço de back-end do projeto de serviço 2 que você quer registrar.
   • BACKEND_SERVICE_SP3_ID: o serviço ID do serviço de back-end do projeto de serviço 3 que você quer registrar.
   • FORWARDING_RULE_SERVICE_ID: o serviço ID da regra de encaminhamento do projeto de serviço 1 que você quer registrar.
   • URL_MAP_SERVICE_ID: o serviço ID do mapa de URL do projeto de serviço 1 que você quer registrar.

4. Liste todos os serviços registrados no aplicativo:

   gcloud apphub applications services list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   Você verá uma saída semelhante a esta:

   ID                               DISPLAY_NAME      SERVICE_REFERENCE                                                                                                                       CREATE_TIME
   tutorial-service-backend-sp2     Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/us-west1/backendServices/tutorial-backend-service-sp2'}   2024-02-13T00:31:45
   tutorial-service-backend-sp3     Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_3_NUMBER]/regions/us-west1/backendServices/tutorial-backend-service-sp3'}   2024-02-13T00:31:45
   tutorial-service-forwarding-rule Forwarding rule   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/us-west1/forwardingRules/l7-ilb-forwarding-rule'}         2024-02-13T00:31:45
   tutorial-service-url-map         URL map           {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/us-west1/urlMaps/tutorial-url-maps'}                      2024-02-13T00:31:45
   

   Serviços registrados, mas separados são indicados por um valor vazio no campo SERVICE_REFERENCE. Para mais informações sobre os status de registro, consulte as propriedades e os atributos do App Hub.

5. Liste todas as cargas de trabalho descobertas no projeto host do App Hub. Esse comando retorna as cargas de trabalho que estão disponíveis para registro em um aplicativo.

   gcloud apphub discovered-workloads list \
       --project=HOST_PROJECT_ID \
       --location=global
   

   Você verá uma saída semelhante a esta:

   ID                            WORKLOAD_REFERENCE                                                                                                          WORKLOAD_PROPERTIES
   INSTANCE_GROUP_SP3_A_ID    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_3_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp3-mig-a'}  {'gcpProject': 'projects/SERVICE_PROJECT_3_ID', 'location': 'us-west1'}
   INSTANCE_GROUP_SP3_B_ID    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_3_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp3-mig-b'}  {'gcpProject': 'projects/SERVICE_PROJECT_3_ID', 'location': 'us-west1'}
   INSTANCE_GROUP_SP2_A_ID    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp2-mig-a'}  {'gcpProject': 'projects/SERVICE_PROJECT_2_ID', 'location': 'us-west1'}
   INSTANCE_GROUP_SP2_B_ID    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp2-mig-b'}  {'gcpProject': 'projects/SERVICE_PROJECT_2_ID', 'location': 'us-west1'}
   

   Copie o ID da carga de trabalho da saída para usar na próxima etapa.

6. Registre as cargas de trabalho da etapa anterior no seu aplicativo. Copie o ID da carga de trabalho do campo de saída na etapa anterior.

   gcloud apphub applications workloads create tutorial-workload-sp3-mig-a \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/INSTANCE_GROUP_SP3_A_ID' \
       --display-name='Workload instance group (SP3-A)' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   gcloud apphub applications workloads create tutorial-workload-sp3-mig-b \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/INSTANCE_GROUP_SP3_B_ID' \
       --display-name='Workload instance group (SP3-B)' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   gcloud apphub applications workloads create tutorial-workload-sp2-mig-a \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/INSTANCE_GROUP_SP2_A_ID' \
       --display-name='Workload instance group (SP2-A)' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   gcloud apphub applications workloads create tutorial-workload-sp2-mig-b \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/INSTANCE_GROUP_SP2_B_ID' \
       --display-name='Workload instance group (SP2-B)' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   Substitua:

   • INSTANCE_GROUP_SP3_A_ID, INSTANCE_GROUP_SP3_B_ID: os IDs de carga de trabalho dos grupos de instâncias gerenciadas do projeto de serviço 3 que você quer registrar.
   • INSTANCE_GROUP_SP2_A_ID, INSTANCE_GROUP_SP2_B_ID: os IDs de carga de trabalho dos grupos de instâncias gerenciadas do projeto de serviço 2 que você quer registrar.

7. Liste todas as cargas de trabalho registradas no aplicativo:

   gcloud apphub applications workloads list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=global
   

   Você verá uma saída semelhante a esta:

   ID                              DISPLAY_NAME                      SERVICE_REFERENCE                                                                                                            CREATE_TIME
   tutorial-workload-sp3-mig-a     Workload instance group (SP3-A)   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_3_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp3-mig-a'}   2024-02-13T00:31:45
   tutorial-workload-sp3-mig-b     Workload instance group (SP3-B)   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_3_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp3-mig-b'}   2024-02-13T00:31:45
   tutorial-workload-sp2-mig-a     Workload instance group (SP2-A)   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp2-mig-a'}   2024-02-13T00:31:45
   tutorial-workload-sp2-mig-b     Workload instance group (SP2-B)   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/zones/us-west1-a/instanceGroups/tutorial-sp2-mig-b'}   2024-02-13T00:31:45
   

   As cargas de trabalho registradas, mas separadas, são indicadas por um valor vazio no campo WORKLOAD_REFERENCE. Para mais informações sobre os status de registro, consulte as propriedades e os atributos do App Hub.

Conferir todos os serviços e cargas de trabalho

É possível conferir detalhes dos serviços e dos workloads nos projetos de serviço anexados ao projeto host do App Hub.

1. No console Google Cloud , acesse a página do App Hub Serviços e cargas de trabalho.

   Acesse "Serviços e cargas de trabalho"

   Todos os serviços e workloads dos projetos de serviço do App Hub anexados são mostrados.

2. Na lista Região, selecione global. A carga de trabalho do grupo de instâncias de carga de trabalho é mostrada com detalhes como Tipo de hub de apps, Crítica e Registrado em.

3. Para filtrar os serviços ou cargas de trabalho com base no estado deles:

   1. No campo Filtro, selecione opções como Status do registro.
   2. Clique em Registrado. Uma lista de serviços e cargas de trabalho registrados no aplicativo vai aparecer.

Ver métricas do aplicativo

Visualização — App Hub global applications

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

É possível conferir as métricas do sistema dos aplicativos criados no projeto de host do App Hub. Essas métricas correspondem aos indicadores de ouro: tráfego, erros, latência e saturação que ajudam a monitorar o desempenho e a integridade do aplicativo.

1. No console do Google Cloud , acesse a página Aplicativos do App Hub.

   Acesse Aplicativos

2. Clique no nome do aplicativo, Tutorial.

   A guia Serviços e cargas de trabalho é mostrada com os metadados dos serviços e das cargas de trabalho registrados no aplicativo.

3. Para conferir as métricas do sistema de serviços e cargas de trabalho registrados, clique em Métricas.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados no tutorial, exclua o projeto que os contém ou mantenha o projeto e exclua os recursos individuais.

Excluir os recursos do App Hub

Console

1. No console do Google Cloud , acesse a página Aplicativos do App Hub.

   Acesse Aplicativos

2. Clique no nome de um aplicativo, Tutorial.

3. Na guia Serviços e cargas de trabalho, na seção Serviços e cargas de trabalho registrados, clique no nome de um serviço.

4. Na página Serviços e cargas de trabalho, clique em Cancelar registro.

   Um alerta notifica que o serviço não está registrado.

5. Na guia Serviços e cargas de trabalho, na seção Serviços e cargas de trabalho registrados, clique no nome de uma carga de trabalho.

6. Na guia Detalhes, clique em Cancelar registro.

   Um alerta notifica que a carga de trabalho não está registrada.

7. Acesse a página Aplicativos do hub.

   Acesse Aplicativos

8. Clique no nome de um aplicativo.

9. Na página tutorial-application, clique em Delete.

10. No console do Google Cloud , acesse a página Configurações do App Hub.

    Acesse configurações

11. Na página Settings, marque a caixa de seleção do projeto de serviço que você quer remover do projeto de host do App Hub.

12. Clique em Desanexar projetos.

gcloud

1. Liste os serviços registrados no aplicativo:

   gcloud apphub applications services list \
     --application=tutorial-application --project=HOST_PROJECT_ID \
     --location=global
   

2. Cancele o registro dos serviços do aplicativo:

   gcloud apphub applications services delete SERVICE_NAME \
     --application=tutorial-application --project=HOST_PROJECT_ID \
     --location=global
   

   SERVICE_NAME pelo nome do serviço; Os serviços agora são serviços descobertos que podem ser registrados no aplicativo.

3. Liste as cargas de trabalho registradas no aplicativo:

   gcloud apphub applications workloads list \
     --application=tutorial-application --project=HOST_PROJECT_ID \
     --location=global
   

4. Cancele o registro da carga de trabalho no aplicativo:

   gcloud apphub applications workloads delete WORKLOAD_NAME \
     --application=tutorial-application --project=HOST_PROJECT_ID \
     --location=global
   

   Substitua WORKLOAD_NAME pelo nome da sua carga de trabalho. A carga de trabalho agora é uma carga de trabalho descoberta que pode ser registrada no aplicativo.

5. Exclua o aplicativo:

   gcloud apphub applications delete tutorial-application \
     --project=HOST_PROJECT_ID \
     --location=global
   

6. Remova os projetos de serviço do projeto host do App Hub:

   gcloud apphub service-projects remove SERVICE_PROJECT_ID \
     --project=HOST_PROJECT_ID
   

   Substitua SERVICE_PROJECT_ID pelos IDs dos projetos de serviço 1, 2 e 3.

Excluir a implantação

Quando você não precisar mais da solução, exclua todos os recursos para evitar o faturamento contínuo dos recursos criados nesta solução.

Para mais informações, consulte Limpar a configuração do balanceador de carga.

Exclua o projeto

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto atual para as tarefas neste documento, a exclusão dele vai 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 ID 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 explorar 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.

Console

1. No console do Google Cloud , acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir.
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluir o projeto.

gcloud

Exclua um projeto do Google Cloud :

gcloud projects delete PROJECT_ID

Substitua PROJECT_ID pelos IDs do projeto host ou de serviço.

A seguir

• Visão geral do App Hub
• Criar um aplicativo do App Hub usando um único projeto