Configurar o App Hub

Neste documento, mostramos como configurar o App Hub para criar, operar e gerenciar aplicativos no Google Cloud. Está destinada a pessoas que configuram e administram o App Hub.

Ao configurar o App Hub, as principais tarefas são: da seguinte forma:

  1. Decidir se você quer criar um novo projeto host do App Hub ou usar um projeto atual como projeto host.
    • Se você planeja ter mais de um projeto host, recomendamos que você os crie na mesma pasta.
    • Os projetos host no App Hub não são iguais Projetos host de VPC compartilhada que não têm os mesmos requisitos. Por exemplo, você não precisa uma rede VPC compartilhada para usar o App Hub. Neste documento, todas as referências a projetos host são ao App Hub projetos host.
    • Um projeto host não pode ser um projeto de serviço que não seja para si mesmo.
  2. Ative a API App Hub no projeto host.
  3. Adicione um ou mais projetos de serviço do App Hub ao projeto host.
    • Os projetos de serviço no App Hub não são iguais Projetos de serviço de VPC compartilhada que não têm os mesmos requisitos. Neste documento, todas as referências a projetos de serviço são projetos de serviço do App Hub.
  4. Designar usuários do App Hub como App Hub Administradores, editores do App Hub ou App Hub Leitores.
  5. Criar aplicativos.
  6. Registre serviços e cargas de trabalho no aplicativo.

Serviços e cargas de trabalho

Usando o App Hub, os recursos de projetos de serviço anexados projeto host estão disponíveis para você como serviços e cargas de trabalho. Registrando os serviços e as cargas de trabalho a um aplicativo permitem observar e monitorar os recursos. É possível designar os seguintes recursos como Os serviços do App Hub e registrá-los no Aplicativos do App Hub:

  • Regras de encaminhamento
  • Mapas de URL
  • Serviços de back-end

É possível designar grupos gerenciados de instâncias (MIGs), mas não VMs individuais. cargas de trabalho e registrá-las em aplicativos do App Hub.

O App Hub oferece suporte aos sistemas regionais L7 externos e internos Balanceadores de carga de aplicativo com tráfego HTTP ou HTTPS

As cargas de trabalho e os serviços registrados precisam estar na mesma região que a aplicativo Por isso, as instruções e os comandos a seguir pressupõem que todos da rede estejam na mesma região. Para informações sobre quais regiões você pode designar, consulte Locais.

Processo geral de configuração

A lista a seguir resume as etapas para configurar o App Hub:

  1. Determine quais recursos incluir no seu aplicativo e a quais projetos pertencem.
  2. Crie um projeto host do App Hub e ative a API App Hub no projeto. Opcionalmente, com base nas suas estrutura organizacional de uma empresa, criar mais de um projeto host. Se você criar vários projetos, recomendamos que eles sejam criados em uma nova pasta.
  3. Anexe projetos de serviço. Depois de configurar um projeto host, anexe projetos de serviço com recursos que seus aplicativos precisam, para o projeto host. Observe o seguinte:
    1. Os projetos de serviço precisam estar na mesma organização como o projeto host. Depois de anexar um projeto de serviço a um host projeto, não é possível movê-lo para outra organização. Para mover o projeto de serviço para uma organização diferente, é preciso seguir o instruções neste documento para remover ou remover o anexo do projeto de serviço ao projeto host. Em seguida, você pode anexar o projeto de serviço para uma organização diferente.
    2. Um projeto de serviço não pode ser anexado a mais de um projeto host.
    3. Um projeto host pode ser o próprio projeto de serviço, mas não pode ser um projeto de serviço para qualquer outro projeto host.
    4. Depois de anexar projetos de serviço a um projeto host, consultar o host projeto para serviços ou cargas de trabalho retorna automaticamente todos os serviços e cargas de trabalho em todos os projetos de serviço.
  4. Criar um aplicativo para organizar várias cargas de trabalho e serviços. Observe que:
    1. Verifique se o nome do aplicativo é exclusivo no projeto host e localização.
    2. Um projeto de serviço pode ser anexado a um projeto host com vários aplicativos, mas seu recursos individuais podem ser registrados somente para um aplicativo.
  5. Consulte serviços e cargas de trabalho e registre-os no aplicativo. Depois de criar um aplicativo, consulte o projeto host para verificar serviços e cargas de trabalho. As consultas são executadas no projeto host e projetos de serviço anexados ao projeto host. Eles também retornam todos e cargas de trabalho nesses projetos. Observe o seguinte:
    1. Só é possível registrar um serviço ou carga de trabalho em um único aplicativo.
    2. Todas as cargas de trabalho e serviços registrados precisam estar na mesma região como o aplicativo.
    3. Os serviços e as cargas de trabalho registrados não são afetados pelas atualizações da recurso de infraestrutura. Em outras palavras, se você excluir o recursos que atuam como serviços e cargas de trabalho, O App Hub não exclui as cargas de trabalho associadas e serviços do seu aplicativo. É necessário cancelar o registro separadamente carga de trabalho ou serviço.

Pré-requisitos

Antes de configurar o App Hub, conclua as tarefas a seguir.

  1. Decida qual projeto atual é o host ou crie um novo para será o projeto host. Recomendamos que você crie um novo projeto.
  2. Verifique se você decidiu quais indivíduos têm o Identity and Access Management (IAM) do App Hub: administrador do App Hub, Editor e Leitor do App Hub.

Observe o seguinte:

  • Os projetos host podem ter um ou mais projetos de serviço anexados.
  • Um projeto de serviço não pode ser anexado a mais de um projeto host.
  • A pessoa que anexa um projeto de serviço a um projeto host precisa ter a O papel de IAM de Administrador do App Hub no serviço e um projeto host. Para mais informações, consulte Papéis e permissões do App Hub.

Configurar o App Hub

Nesta seção, você vai criar um exemplo de arquitetura do App Hub.

No exemplo, uma organização tem três projetos de serviço, de infraestrutura implantados nos projetos da seguinte forma:

  • O projeto de serviço 1 tem dois recursos de infraestrutura: Serviço 1 e Serviço 2.
  • O projeto de serviço 2 tem três recursos de infraestrutura: Serviço 3, Carga de trabalho 1, e carga de trabalho 2.
  • O projeto de serviço 3 tem três recursos de infraestrutura: Serviço 4, Carga de trabalho 3, e carga de trabalho 4.

Certifique-se de que os projetos escolhidos para criar o exemplo contenham o os recursos descritos nesta seção ou esteja preparado para ajustar o exemplo conforme siga as instruções.

As seções a seguir contêm as instruções para criar um Exemplo do App Hub. Você cria um projeto host e adiciona projetos ao projeto host, criar um aplicativo e anexar serviços e de carga para o aplicativo. O exemplo tem três projetos de serviço, mas você é possível adicionar menos ou mais.

O exemplo pressupõe que todos os projetos de serviço adicionados já existem e que vão conter os serviços e as cargas de trabalho que você vai adicionar ao aplicativo. Antes de você criar o exemplo, determinar quais projetos de serviço contêm os serviços e das cargas de trabalho que você quer incluir no aplicativo.

Ativar o App Hub

Nesta seção, você seleciona ou cria um novo projeto host, ativa o a API App Hub e conceder papéis e permissões a pessoas de sua organização. Você também anexa projetos de serviço ao host projeto.

Console

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

    Acessar o seletor de projetos

  2. Selecionar ou criar um projeto do Google Cloud como o projeto host do App Hub.

  3. Ative a API necessária.

    Ative a API

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

    Se você não for o criador do projeto, será necessário conceder as permissões necessárias no projeto para o principal apropriado. Por exemplo, principal pode ser uma Conta do Google (para usuários finais) ou uma conta de serviço (para aplicativos e cargas de trabalho de computação). Para receber as permissões necessárias para concluir este tutorial, peça ao seu administrador para conceder a você os seguintes papéis do IAM no projeto:

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

      Acessar IAM

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

    3. No campo Novos principais, insira o endereço de e-mail do pessoa física que vai administrar o App Hub, o papel Administrador do App Hub no projeto host.

    4. Clique em Selecionar papel e, no campo Filtro, digite App Hub.

    5. Selecione o papel Administrador do App Hub e clique em Salvar.

    6. Em cada um dos projetos de serviço do App Hub, conceda Administrador do App Hub ao mesmo usuário.

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

    Acesse configurações

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

  7. Siga uma das seguintes ações:

    • Na lista de projetos, marque as caixas de seleção dos projetos que você adicionar como projetos de serviço.
    • Pesquise projetos e selecione aqueles para adicionar como serviço projetos.

  8. Clique em Selecionar. A tabela Projetos de serviço anexados mostram o serviço selecionado. projetos.

  9. Clique em Fechar.

gcloud

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

    Ativar o Cloud Shell

    Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

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

    gcloud components update

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

    • Crie um projeto do Google Cloud: 
      gcloud projects create HOST_PROJECT_ID
    • Selecione o projeto do Google Cloud que você criou: 
      gcloud config set project HOST_PROJECT_ID

  4. Ative a API App Hub no projeto host que você acabou de criados.

    gcloud services enable apphub.googleapis.com \
    --project=HOST_PROJECT_ID

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

    Se você não for o criador do projeto, será necessário conceder as permissões necessárias no projeto para o principal apropriado. Por exemplo, principal pode ser uma Conta do Google (para usuários finais) ou uma conta de serviço (para aplicativos e cargas de trabalho de computação). Para receber as permissões necessárias para concluir este tutorial, peça ao seu administrador para conceder a você os seguintes papéis do IAM no projeto:

    1. Opcionalmente, conceda aos indivíduos que administrarão App Hub, App Hub administrador no projeto host. Repita o comando a seguir para cada administrador.

      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 o papel de administrador do App Hub no projeto host. Isso tem o formato username@yourdomain, por exemplo, robert.smith@example.com.

    2. Conceda o papel de administrador do App Hub nos projetos de serviço à para indivíduos que administram o App Hub. Eles devem ter o Papel de administrador do App Hub para adicionar projetos de serviço ao host projeto. Você precisa de pelo menos uma pessoa com esse papel em cada serviço projeto. Uma única pessoa pode ter o papel em vários projetos de serviço.

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

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

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

      Substitua:

      • SERVICE_PROJECT_1: o primeiro de três de serviço neste exemplo.
      • SERVICE_PROJECT_2: o segundo de três de serviço neste exemplo.
      • SERVICE_PROJECT_3: o terceiro de três de serviço neste exemplo.

  6. Adicione seus projetos de serviço ao projeto host do App Hub.

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

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

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

Criar um aplicativo

Se ainda não tiver um, crie um aplicativo para ser o contêiner do seu serviços e cargas de trabalho.

Console

  1. Verifique se você está no projeto host.

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

    Acesse Aplicativos

  3. Clique em Criar aplicativo. O painel Criar aplicativo está exibidos.

  4. Selecione uma Região.

  5. Digite o Nome do aplicativo e clique em Continuar.

  6. Na seção Adicionar atributos, digite o Nome de exibição.

  7. Se quiser, adicione mais detalhes do aplicativo nos campos. a seguir. Para mais informações, neste documento, consulte Atualizar um aplicativo existente do App Hub.

  8. Clique em Criar.

gcloud

  1. Crie um novo aplicativo com o nome APPLICATION_NAME e dar um nome de exibição, APPLICATION_DISPLAY_NAME. A flag --scope-type define quais serviços e cargas de trabalho possam ser registradas em um aplicativo. Há suporte apenas para REGIONAL, ou seja, apenas serviços e cargas de trabalho da mesma região aplicativo possa ser registrado.

    gcloud apphub applications create APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_NAME' \
  --scope-type=REGIONAL \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Substitua:

    • APPLICATION_NAME: o nome do seu aplicativo. O nome deve incluir apenas caracteres alfanuméricos minúsculos, sem espaços
    • APPLICATION_DISPLAY_NAME: o nome de exibição de seu aplicativo.
    • REGION: a região do aplicativo. Dê isso o valor us-east1.

  2. Liste os aplicativos no projeto host.

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

    O resultado será assim:

    ID: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

  3. Receba detalhes do aplicativo que você criou.

    gcloud apphub applications describe APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    O comando retorna informações no formato YAML, semelhante ao seguinte.

    createTime: '2023-10-31T18:33:48.199394108Z'
displayName: APPLICATION_DISPLAY_NAME
name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
scope:
  type: REGIONAL
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

Atualizar um aplicativo do App Hub

Você também pode atualizar os atributos do seu aplicativo depois que ele for criados.

Console

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

    Acesse Aplicativos

  2. Na lista de aplicativos, clique em Edit para o aplicativo que deseja atualizar.

  3. Edite os campos conforme necessário e clique em Salvar.

  4. Opcional: na lista Importância, para indicar a importância do aplicativo, selecione uma das seguintes opções:

    • Essencial
    • Alta
    • Meio
    • Baixa

  5. Opcional: no campo Ambiente, para indicar o estágio ciclo de vida do software, selecione uma das seguintes opções:

    • Production
    • Preparação
    • Development
    • Testar

  6. Opcional: adicione os detalhes a seguir conforme necessário para os proprietários desenvolvedores. Proprietários operadores e Proprietários de empresas. Você deve inserir o endereço de e-mail do proprietário caso adicione um nome de exibição.

    1. Digite o nome de exibição de um proprietário.
    2. Digite o endereço de e-mail do proprietário. Esse valor deve ter no formato username@yourdomain, por exemplo, 222larabrown@gmail.com.

  7. Repita essas etapas para cada desenvolvedor, operador e proprietário da empresa.

  8. Clique em Salvar.

gcloud

  1. Atualize o aplicativo com criticality-type, environment-type. e dos tipos de proprietário:

    gcloud apphub applications update APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --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=REGION

    Substitua:

    • CRITICALITY_LEVEL: indica o nível de importância aplicativos, serviços ou cargas de trabalho é para suas operações comerciais. Informe um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica os estágios do no ciclo de vida do software. Informe um dos seguintes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: nomes de exibição do desenvolvedor, operador e proprietário da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail do desenvolvedor, operador e proprietário da empresa, respectivamente. Esses valores precisa ter o formato username@yourdomain, por exemplo, 222larabrown@gmail.com.

  2. Liste os aplicativos em que o atributo environment-type tem o o valor PRODUCTION.

    gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=HOST_PROJECT_ID \
    --location=REGION

    O resultado será assim:

    ID: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

Registrar serviços e cargas de trabalho

Quando você registra serviços de infraestrutura e cargas de trabalho em um aplicativo, e cargas de trabalho são registradas como recursos do App Hub. Se você está usando os espaços reservados para criar o aplicativo com CLI gcloud, os serviços e as cargas de trabalho nos três projetos de serviço são os seguintes:

  • O projeto de serviço 1 tem dois recursos de infraestrutura: Serviço 1 e Serviço 2.
  • O projeto de serviço 2 tem três recursos de infraestrutura: Serviço 3, Carga de trabalho 1, e carga de trabalho 2.

  • O projeto de serviço 3 tem três recursos de infraestrutura: Serviço 4, Carga de trabalho 3, e carga de trabalho 4.

Console

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

    Acesse Aplicativos

  2. Clique no nome do seu aplicativo. A guia Serviços e cargas de trabalho é mostrada com uma lista de serviços e cargas de trabalho que estão nos projetos de serviço.

  3. Para cada serviço ou carga de trabalho que você quer registrar, faça o seguinte:

    1. Na guia Serviços e cargas de trabalho, clique em Registre serviço/carga de trabalho.
    2. No painel Registrar serviço ou carga de trabalho, na seção a seção Escolha o serviço ou a carga de trabalho, selecione o serviço ou a carga de trabalho; e clique em Continuar.
    3. Na seção Adicionar atributos, digite um Nome para o serviço ou carga de trabalho do Google Cloud.
    4. Se quiser, adicione mais detalhes do serviço ou da carga de trabalho nos campos a seguir. Para mais informações, neste documento, consulte Atualizar um aplicativo existente do App Hub. Você deve fornecer um dos valores especificados para criticity e Environment, mas o valor pode ser diferentes dos valores que você definiu ao criar o aplicativo.
    5. Clique em Registrar. A guia Serviços e cargas de trabalho mostra o serviço ou carga de trabalho do Google Cloud. Para mais informações sobre os status de registro, consulte a propriedades e atributos do App Hub.

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 o Papel "Editor do App Hub" no projeto host. Esse valor tem no formato username@yourdomain, por exemplo, robert.smith@example.com.

  2. Liste as cargas de trabalho descobertas do projeto de serviço 2, que está anexado ao o projeto host. Esse comando retorna cargas de trabalho que estão disponíveis para registrados em um aplicativo.

    gcloud apphub discovered-workloads list \
  --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    A resposta será semelhante à seguinte, que inclui MIGs não registrados:

    ID: [DISCOVERED_WORKLOAD_ID_1]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

ID: [DISCOVERED_WORKLOAD_ID_2]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

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

  3. Registre uma carga de trabalho da etapa anterior no seu aplicativo.

    gcloud apphub applications workloads create WORKLOAD_NAME \
  --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
  --display-name='mywebserver-deployment1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Substitua:

    • WORKLOAD_NAME: um nome para registrar o carga de trabalho.
    • DISCOVERED_WORKLOAD_ID_2: o ID da carga de trabalho de a saída da etapa anterior.

  4. Repita as duas etapas anteriores para filtrar e registrar as cargas de trabalho que você quer do projeto de serviço 3.

  5. Opcional: é possível atualizar as cargas de trabalho com criticality-type. environment-type e atributos de proprietário.

    gcloud apphub applications workloads update WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --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=REGION

    Você deve fornecer um dos valores especificados para criticality-type e environment-type, mas o valor pode ser diferentes dos valores que você definiu ao criar o aplicativo.

  6. Liste as cargas de trabalho registradas no aplicativo.

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    O resultado será assim:

    ID: WORKLOAD_NAME
DISPLAY_NAME: mywebserver-deployment1
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
CREATE_TIME: 2023-10-31T18:34:23

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

  7. Liste os serviços descobertos com regras de encaminhamento no projeto de serviço 1 anexado ao projeto host. Esse comando retorna serviços disponíveis para registro em um aplicativo.

    gcloud apphub discovered-services list \
  --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    O resultado será assim:

    ID: [DISCOVERED_SERVICE_ID_1]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

ID: [DISCOVERED_SERVICE_ID_2]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

    Copie o ID de serviço, DISCOVERED_SERVICE_ID_2 da saída para usar em para a próxima etapa.

  8. Registre a regra de encaminhamento, testing-forwarding-rule-2 em serviço Projeto 1 como serviço.

    gcloud apphub applications services create SERVICE_NAME \
  --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
  --display-name='mywebserver-service1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Substitua:

    • SERVICE_NAME: um nome para registrar o o serviço.
    • DISCOVERED_SERVICE_ID_2: o ID do serviço de a saída da etapa anterior.

  9. Repita as etapas anteriores para listar e filtrar os serviços. registre os serviços nos projetos de serviço 1, 2 e 3.

  10. Atualize um serviço com o atributo criticality-type e o environment-type.

    gcloud apphub applications services update SERVICE_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID  \
  --location=REGION

  11. Listar serviços registrados no APPLICATION_NAME do aplicativo e HOST_PROJECT_ID projeto host.

    gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    A saída será semelhante à seguinte para cada serviço:

    ID: SERVICE_NAME
DISPLAY_NAME: mywebserver-service1
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
CREATE_TIME: 2023-11-01T21:38:08

    Os serviços registrados, mas desconectados, são indicados por um valor vazio na SERVICE_REFERENCE.

  12. Filtre os serviços na APPLICATION_NAME aplicativo e HOST_PROJECT_ID projeto host àqueles em que o atributo environment-type está definido como PRODUCTION.

    gcloud apphub applications services list \
  --filter='attributes.environment.type=PRODUCTION' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

O processo de configuração do App Hub foi concluído.

Adicionar ou remover projetos de serviço

É possível modificar anexos de projetos de serviço para criar disponíveis para agrupar em um aplicativo.

Console

Para adicionar um projeto de serviço a um projeto host:

  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 aparecer, pesquise projetos na lista exibida e marque as caixas de seleção dos projetos que você quer adicionar como serviço. projetos.

  4. Clique em Selecionar. A tabela Projetos de serviço anexados mostram os projetos selecionados. como os projetos de serviço do projeto host.

  5. Clique em Fechar.

Para remover um projeto de serviço de um projeto host:

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

    Acesse configurações

  2. Na página Configurações, marque as caixas de seleção dos projetos que quiser. para remover como projetos de serviço.

  3. Clique em Desanexar projetos. A tabela Projetos de serviço anexados é atualizada para mostrar apenas o projetos que permanecem anexados ao projeto host.

gcloud

Para adicionar um projeto de serviço a um projeto host:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID
Substitua SERVICE_PROJECT_ID pelo nome do projeto de serviço que você quer adicionar ao projeto host. Para remover um projeto de serviço do projeto host: 
gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Ver aplicativos, serviços e cargas de trabalho atuais

É possível visualizar aplicativos em um projeto e listar serviços e cargas de trabalho em um para o aplicativo.

Console

  • Para conferir os aplicativos em um projeto, acesse o console do Google Cloud Página Aplicativos do App Hub.

    Acesse Aplicativos

  • Para listar serviços e cargas de trabalho:

    Aplicativos

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

      Acesse Aplicativos

    2. Clique no nome de um aplicativo. Uma página com uma lista de serviços e cargas de trabalho registrados no é exibido.

    3. Opcional: para filtrar os serviços ou as cargas de trabalho, faça o seguinte:

      1. No campo Filtro, selecione uma opção, como Importância.
      2. Selecione Alto como o valor.
        Uma lista de serviços e cargas de trabalho de alta criticidade que estão registrados no aplicativo, será exibido.

    Serviços e cargas de trabalho

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

      Acessar "Serviços e cargas de trabalho"

    2. Na lista Região, selecione as regiões de onde você quer para conferir os serviços e as cargas de trabalho. Por exemplo, selecione us-east1.
      A página Serviços e cargas de trabalho exibe todos os serviços e cargas de trabalho dos projetos de serviço anexados às us-east1

    3. Opcional: para filtrar os serviços ou as cargas de trabalho, faça o seguinte:

      1. No campo Filtro, selecione uma opção, como Ambiente.
      2. Selecione Produção como o valor.
        Uma lista de serviços e cargas de trabalho no ambiente de produção que estiver registrado em um aplicativo, será exibido.

gcloud

Para ver aplicativos em um projeto:

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

Para listar serviços registrados em um aplicativo:

gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

Para listar cargas de trabalho registradas em um aplicativo:

gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

Limpar

Limpe um aplicativo atual e remova um anexo de projeto de serviço do projeto host para remover recursos associados a ele. Com isso, descoberta automática de recursos no projeto de serviço.

Para isso, primeiro é preciso excluir cargas de trabalho e serviços registrados no para o aplicativo.

Console

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

    Acesse Aplicativos

  2. Clique no nome de um aplicativo. Será exibida uma lista de serviços e cargas de trabalho registrados no aplicativo.

  3. Cancelar o registro de um serviço ou carga de trabalho.

    1. Na guia Serviços e cargas de trabalho, no na seção Serviços e cargas de trabalho registrados, clique no nome ou carga de trabalho que você quer cancelar.
    2. Na guia Detalhes, clique em Cancelar registro para atualizar o serviço ou carga de trabalho como um recurso Descoberta.
      Na guia Serviços e cargas de trabalho, um alerta notifica que o carga de trabalho não está registrada.
    3. Repita essas instruções para cada serviço e carga de trabalho.

  4. Acesse a página Aplicativos do App Hub.

    Acesse Aplicativos

  5. Clique no nome de um aplicativo.

  6. Na página com os detalhes do aplicativo, clique em Excluir.

  7. Neste documento, use as instruções Adicione ou remova projetos de serviço para remover. os projetos de serviço do seu projeto host.

gcloud

  1. Liste as cargas de trabalho registradas no aplicativo:

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
  --location=REGION

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

    gcloud apphub applications workloads delete WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    A carga de trabalho agora é uma carga de trabalho descoberta que pode ser registrada no para o aplicativo.

  3. Repita o comando anterior para excluir as cargas de trabalho registradas restantes do aplicativo.

  4. Liste os serviços registrados no aplicativo:

    gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  5. Cancele o registro do serviço no aplicativo:

    gcloud apphub applications services delete SERVICE_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    O serviço agora é um serviço descoberto que pode ser registrado no para o aplicativo.

  6. Repita o comando anterior para cancelar o registro dos outros serviços de registro os serviços do aplicativo.

  7. Exclua o aplicativo:

    gcloud apphub applications delete APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  8. Remova um projeto de serviço do projeto host:

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

  9. Repita o comando anterior para remover todos os projetos de serviço do host projeto.

A seguir