Configurar o App Hub para pastas com app ativado

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

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

   Acessar IAM

2. Verifique se o seletor de projetos na barra de navegação superior mostra a pasta com o app ativado. O seletor de Purview informa em qual organização, pasta ou projeto você está trabalhando. Se você não estiver na pasta com o app ativado, siga estas etapas para selecionar uma pasta com o app ativado:

   1. No seletor Purview, clique na opção selecionada.
   2. Na caixa de diálogo Selecionar um recurso, faça o seguinte:
      • Na lista de pastas, selecione a FOLDER_DISPLAY_NAME.
      • Pesquise a pasta FOLDER_DISPLAY_NAME e selecione-a.

3. Na página do IAM, clique em person_addConceder acesso. O painel Conceder acesso é aberto.

4. No campo Novos participantes, insira o endereço de e-mail da pessoa responsável por administrar o App Hub, a função de administrador do App Hub na pasta ativada pelo app.

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

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

7. Repita as etapas para conceder o papel de Leitor de gerenciamento de apps às pessoas para que elas possam acessar os dados do aplicativo e os atributos em todos os serviçosGoogle Cloud que oferecem suporte ao gerenciamento de apps. Esse papel é concedido ao indivíduo em todos os projetos e subpastas da pasta ativada pelo app.

8. Clique em Salvar.

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 CLI do Google Cloud está instalada. Execute o comando a seguir no Cloud Shell:

   gcloud components update

3. Conceda a função de administrador do App Hub às pessoas que vão administrar o App Hub na pasta com o app ativado. Repita o comando a seguir para cada administrador. Eles precisam ter a função de administrador do App Hub para criar aplicativos.

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

   Substitua:

   • MANAGEMENT_PROJECT_ID: o ID do projeto de gerenciamento no formato google-mpf-FOLDER_ID. Encontre o ID do projeto de gerenciamento na página Configurações do IAM e do administrador do console do Google Cloud. Se você não encontrar o ID do projeto de gerenciamento, talvez não esteja em uma pasta ativada pelo app. No seletor de projeto, selecione a pasta com o app ativado.
   • MANAGEMENT_PROJECT_ADMIN: o usuário que tem a função de administrador do App Hub no projeto. Esse valor tem o formato username@yourdomain, por exemplo, robert.smith@example.com.

4. Conceda o papel de leitor de gerenciamento de apps na pasta ativada para que as pessoas possam acessar os dados do aplicativo e os atributos em Google Cloud serviços que oferecem suporte ao gerenciamento de apps. Esse papel é concedido ao indivíduo em todos os projetos e subpastas da pasta ativada pelo app.

   gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
       --member='user:MANAGEMENT_PROJECT_ADMIN' \
       --role='roles/apphub.appManagementViewer'
   

   Substitua FOLDER_ID pelo código do projeto. Encontre o ID da pasta ativada pelo app na página Configurações do IAM e administrador no console do Google Cloud. Para garantir que a pasta esteja ativada pelo app, a página Configurações precisa mostrar o ID do projeto de gerenciamento. Se você não encontrar o ID do projeto de gerenciamento, talvez não esteja em uma pasta ativada pelo app. No seletor de projeto, selecione a pasta com o app ativado.

Console

1. Verifique se você está em uma pasta ativada para apps.

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 região e nome do aplicativo, com base no escopo de serviços e workloads que você quer registrar no aplicativo, faça uma das seguintes ações:

   • Para criar um aplicativo que permita registrar serviços e cargas de trabalho em um local global, selecione Global.

   • Para criar um aplicativo que permita registrar serviços e cargas de trabalho em um único local:

     1. Selecione Regional.
     2. Selecione uma Região.

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

6. Opcional: na seção Adicionar atributos, insira o Nome de exibição.

7. Opcional: na lista Criticalidade, para indicar a importância do app, selecione uma das seguintes opções:

   • Serviços críticos
   • Alta
   • Meio
   • Baixa

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

   • Production
   • Preparação
   • Development
   • Testar

9. Opcional: adicione os seguintes detalhes conforme necessário para proprietários de desenvolvedor, proprietários de operador e proprietários de 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, 222larabrown@gmail.com.

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

11. Clique em Criar.

gcloud

1. Crie um novo aplicativo chamado APPLICATION_NAME e atribua um nome de exibição, APPLICATION_DISPLAY_NAME.

   gcloud apphub applications create APPLICATION_NAME \
       --display-name='APPLICATION_DISPLAY_NAME' \
       --scope-type=SCOPE_TYPE \
       --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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Substitua:

   • APPLICATION_NAME: o nome do seu aplicativo. O nome precisa incluir apenas caracteres alfanuméricos minúsculos sem espaços.
   • APPLICATION_DISPLAY_NAME: o nome de exibição do aplicativo.
   • SCOPE_TYPE: o escopo do aplicativo que define quais serviços e cargas de trabalho estão disponíveis para você registrar no aplicativo. Use um dos seguintes valores:
     • REGIONAL
     • GLOBAL
   • CRITICALITY_LEVEL: (opcional) indica a importância de um aplicativo, serviço ou carga de trabalho para as operações de negócios. Forneça um dos seguintes valores:
     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW
   • ENVIRONMENT: (opcional) indica os estágios do ciclo de vida do software. Forneça um dos seguintes valores:
     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST
   • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: (opcional) nomes de exibição do desenvolvedor, operador e proprietários da empresa, respectivamente.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: (opcional) endereços de e-mail do desenvolvedor, operador e proprietários da empresa, respectivamente. Esses valores precisam ter o formato username@yourdomain, por exemplo, 222larabrown@gmail.com.
   • MANAGEMENT_PROJECT_ID: o ID do projeto de gerenciamento no formato google-mpf-FOLDER_ID.
   • REGION: a região do aplicativo. Dependendo do --scope-type, atribua o valor us-east1 ou global.

   Exemplo:

   gcloud apphub applications create my-application \
       --display-name='application-display-name' \
       --scope-type=REGIONAL \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --project=host-project \
       --location=us-east1
   

2. Liste os aplicativos na pasta com o app ativado.

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

   O resultado será assim:

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

Console

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

   Acesse Aplicativos

2. Clique no nome do seu app. A guia Serviços e cargas de trabalho é exibida com uma lista de serviços e cargas de trabalho registrados na pasta ativada pelo app.

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 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 um serviço ou uma carga de trabalho e clique em Selecionar.
   4. No painel Selecionar recurso, insira um Nome para o serviço ou a carga de trabalho e clique em Continuar.
   5. Opcionalmente, no painel Adicionar atributos, adicione mais detalhes do serviço ou da carga de trabalho nos campos a seguir. Para mais informações, neste documento, consulte Criar um aplicativo. É possível selecionar valores para os campos Criticalidade e Ambiente que sejam diferentes dos valores definidos ao criar o aplicativo.
   6. Clique em Continuar.
   7. Opcionalmente, na seção Adicionar proprietários, adicione mais detalhes sobre os proprietários do serviço ou da carga de trabalho nos campos a seguir. Para mais informações, neste documento, consulte Criar um aplicativo.
   8. Clique em Registrar.

A guia Serviços e cargas de trabalho mostra o serviço ou a carga de trabalho registrados. Para mais informações sobre os status de registro, consulte as propriedades e os atributos do App Hub.

gcloud

1. Listar os serviços descobertos em uma pasta ativada pelo app. No comando abaixo, você pode especificar a flag filter para retornar os serviços do projeto especificado que estão disponíveis para registro em um aplicativo.

   gcloud apphub discovered-services list \
       --filter='FILTER_RESOURCES' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Substitua FILTER_RESOURCES por filtros como:

   • service_properties.gcp_project=projects/PROJECT_ID
   • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules" O resultado será semelhante a este:

   ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
   [DISCOVERED_SERVICE_ID]    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/forwarding-rule'}     {'gcpProject': 'projects/PROJECT_1', 'location': 'REGION'}
   

   Copie o ID do serviço, DISCOVERED_SERVICE_ID, da saída para usar na próxima etapa.

2. Registre a regra de encaminhamento forwarding-rule-name em um projeto como um serviço para seu aplicativo.

   gcloud apphub applications services create SERVICE_NAME \
       --discovered-service='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE' \
       --display-name='SERVICE_DISPLAY_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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Substitua:

   • SERVICE_NAME: um nome para registrar o serviço.
   • DISCOVERED_SERVICE_ID: o ID do serviço da saída da etapa anterior.
   • SERVICE_DISPLAY_NAME: o nome de exibição do aplicativo.

   Observações:

   • criticality-type e environment-type: (opcional) é necessário fornecer um dos valores especificados, mas eles podem ser diferentes dos valores definidos ao criar o aplicativo. Para mais informações, consulte Criar um aplicativo neste documento.
   • developer-owners, operator-owners e business-owners: (opcionais). Para mais informações, consulte este documento: Criar um aplicativo.

   Exemplo:

   gcloud apphub applications services create my-service \
       --display-name='mywebserver-service' \
       --application=my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --folder=folder-ID \
       --location=us-east1
   

3. Listar as cargas de trabalho descobertas em uma pasta ativada pelo app. No comando a seguir, você pode especificar a flag filter para retornar cargas de trabalho do projeto especificado que estão disponíveis para registro em um aplicativo.

   gcloud apphub discovered-workloads list \
       --filter='FILTER_RESOURCES' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Substitua FILTER_RESOURCES por um filtro, como workload_properties.gcp_project=projects/PROJECT_ID.

   Você vai ver uma saída semelhante a esta, que inclui um MIG não registrado:

   ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
   [DISCOVERED_WORKLOAD]   {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/mig-name'}     {'gcpProject': 'projects/PROJECT', 'location': 'REGION'}
   

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

4. Registre o MIG, mig-name do projeto como uma carga de trabalho no aplicativo.

   gcloud apphub applications workloads create WORKLOAD_NAME \
       --discovered-workload='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID' \
       --display-name=WORKLOAD_DISPLAY_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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Substitua:

   • WORKLOAD_NAME: um nome para registrar a carga de trabalho.
   • DISCOVERED_WORKLOAD_ID: o ID da carga de trabalho da saída da etapa anterior.
   • WORKLOAD_DISPLAY_NAME: o nome de exibição do aplicativo.

   Observações:

   • criticality-type e environment-type: (opcional) é necessário fornecer um dos valores especificados, mas eles podem ser diferentes dos valores definidos ao criar o aplicativo. Para mais informações, consulte Criar um aplicativo neste documento.
   • developer-owners, operator-owners e business-owners: (opcionais). Para mais informações, consulte este documento: Criar um aplicativo.

   Exemplo:

   gcloud apphub applications workloads create my-workload \
       --display-name='mywebserver-deployment1' \
       --application=my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --folder=folder-ID \
       --location=us-east1
   

Console

Adicionar um projeto a uma pasta com app ativado

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

   Go to project selector

2. Click Create project.

3. Name your project. Make a note of your generated project ID.

4. Edit the other fields as needed.

5. Click Create.

Remover um projeto de uma pasta com app ativado

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

gcloud

Adicionar um projeto a uma pasta com app ativado

gcloud projects create PROJECT_ID \
    --folder FOLDER_ID

Remover um projeto de uma pasta com app ativado

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID