Configurar o App Hub para pastas com app ativado

Este documento fornece instruções para configurar o App Hub usando uma pasta habilitada para apps e criar, operar e gerenciar aplicativos do App Hub no Google Cloud. Ele é destinado a pessoas que configuram e administram o Hub de apps.

Também é possível configurar o App Hub em um projeto host. No entanto, recomendamos usar pastas com apps ativados em vez de projetos host para gerenciar seus aplicativos, já que elas têm acesso a recursos como o Application Design Center e o Gemini Cloud Assist. Para mais informações sobre como configurar o App Hub em um projeto host, consulte Configurar o App Hub em projetos host.

Depois de configurar um aplicativo do App Hub em uma pasta habilitada para apps, você pode usar a assistência de linguagem natural para recuperar informações sobre seu aplicativo. Para mais informações, consulte Usar o Gemini Cloud Assist no console do Google Cloud .

Serviços e cargas de trabalho

Com o App Hub, os recursos dos projetos Google Cloud que são descendentes da pasta habilitada para apps ficam disponíveis como serviços e cargas de trabalho. Ao registrar seus serviços e cargas de trabalho em um aplicativo, você pode observar e monitorar os recursos. O App Hub é compatível com recursos globais e regionais. Para mais informações sobre os recursos que podem ser adicionados aos aplicativos, consulte Recursos compatíveis com o App Hub.

Processo geral de configuração

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

  1. Determine quais recursos atuais incluir no seu aplicativo e a quais projetos eles pertencem. Para mais informações sobre como gerenciar seu aplicativo, consulte Gerenciamento de aplicativos.
  2. Ative o gerenciamento de aplicativos em uma pasta. Agora é possível gerenciar recursos de todos os projetos descendentes da pasta habilitada para apps. Se novos projetos com recursos subjacentes necessários para seus aplicativos forem adicionados à pasta, eles serão ativados automaticamente para o gerenciamento de aplicativos.
    Observações:
    1. Os projetos precisam estar na mesma organização da pasta ativada para apps. Depois de anexar um projeto a uma pasta compatível com apps, se você quiser mover o projeto para outra organização, será necessário migrá-lo. Para mais informações, consulte Migrar projetos entre recursos da organização.
    2. Depois de anexar projetos a uma pasta habilitada para apps, a consulta da pasta para serviços ou cargas de trabalho retorna automaticamente todos os serviços e cargas de trabalho em todos os projetos anexados a ela.
    3. Se uma pasta habilitada para apps for movida para outra organização, todos os serviços e cargas de trabalho registrados serão removidos.
  3. Designar usuários do App Hub como administradores, editores ou leitores do App Hub.
  4. Crie um aplicativo para organizar várias cargas de trabalho e serviços.
    Observações:
    1. Verifique se o aplicativo tem um nome exclusivo na pasta e no local ativados para apps.
    2. Um projeto pode ser anexado a uma pasta habilitada para apps com vários aplicativos, mas os recursos individuais só podem ser registrados em um aplicativo.
    3. Se um projeto for movido para outra pasta ou organização, o aplicativo vai continuar existindo na pasta ativada para apps com os serviços e as cargas de trabalho em um estado separado.
  5. Consulte serviços e cargas de trabalho e registre-os no seu aplicativo. Depois de criar um aplicativo, é possível consultar a pasta habilitada para apps para ver os serviços e cargas de trabalho disponíveis. As consultas são executadas na pasta ativada para apps e em todos os projetos anexados a ela. A consulta também retorna todos os serviços e cargas de trabalho nesses projetos. Observações:
    1. Só é possível registrar um serviço ou uma carga de trabalho em um único aplicativo.
    2. É necessário registrar serviços e cargas de trabalho de uma região específica em um aplicativo regional na mesma região ou em um aplicativo global. As instruções e os comandos a seguir pressupõem que todos os recursos estão na mesma região. Para informações sobre quais regiões podem ser designadas, consulte Locais.
    3. Os serviços e cargas de trabalho registrados não são afetados por atualizações no recurso de infraestrutura subjacente. Em outras palavras, se você excluir os recursos subjacentes que atuam como serviços e cargas de trabalho, o App Hub não vai excluir as cargas de trabalho e os serviços associados do seu aplicativo. É necessário cancelar o registro da carga de trabalho ou do serviço separadamente.

Pré-requisitos

Antes de configurar o Hub de apps, conclua as seguintes tarefas.

  1. Verifique se você tem a função do IAM necessária para ativar ou criar uma conta de faturamento para seu projeto de gerenciamento.
  2. Decida usar uma pasta existente ou criar uma nova para ativar o gerenciamento de aplicativos. Para mais informações sobre como criar uma pasta, consulte Criar pastas.
  3. Decida quem vai ter os papéis do Identity and Access Management (IAM) para o App Hub: administrador, editor e leitor. Para mais informações sobre os papéis e as permissões, consulte Papéis e permissões do App Hub.

Funções exigidas

Para receber as permissões necessárias para modificar recursos do App Hub, peça ao administrador para conceder a você os seguintes papéis do IAM na pasta ativada para apps:

  • Para criar e atualizar aplicativos e registrar e cancelar o registro de serviços e cargas de trabalho:
  • Para ativar o gerenciamento de aplicativos em uma pasta: Administrador de pastas (resourcemanager.folderAdmin)
  • Para conferir aplicativos, serviços e cargas de trabalho, além dos atributos deles em Google Cloud serviços que oferecem suporte ao gerenciamento de aplicativos: Visualizador de gerenciamento do App Hub (roles/apphub.appManagementViewer)
    . Para mais informações sobre como conferir os dados do aplicativo em um só lugar, consulte Visão geral do Cloud Hub.

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 usando papéis personalizados ou outros papéis predefinidos.

Ativar o gerenciamento de aplicativos

Nesta seção, você seleciona uma pasta e ativa o gerenciamento de aplicativos nela. Ao configurar o gerenciamento de aplicativos para uma pasta, o processo de ativação inclui as seguintes ações:

  • Criação de um novo projeto de gerenciamento na pasta. O projeto de gerenciamento é um projeto criado pelo Google que não pode ser movido ou excluído. Apenas um projeto de gerenciamento está associado a uma pasta habilitada para apps. O projeto de gerenciamento é usado para gerenciar a cota e o faturamento de todos os projetos descendentes associados à pasta ativada para apps.
  • Ativar APIs para serviços como o App Hub e o Gemini Cloud Assist, que oferecem suporte ao gerenciamento de aplicativos.

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

    Acessar o App Hub

  2. Com base nos cenários a seguir, siga estas etapas:

    • Se você estiver em um projeto Google Cloud ou uma pasta Google Cloud que não esteja ativada para apps:
      1. Clique em Selecionar uma pasta.
      2. Na caixa de diálogo Selecionar uma pasta, escolha uma pasta habilitada para apps. Se você precisar de informações sobre pastas ativadas para apps, fale com seu administrador. Se você selecionou uma pasta que não está ativada para apps e tem a função de administrador de pastas (resourcemanager.folderAdmin) do IAM, ative o gerenciamento de aplicativos na pasta. Para mais informações, consulte Como ativar o gerenciamento de aplicativos e APIs em uma pasta.
    • Se você estiver em uma pasta Google Cloud com apps ativados, acesse Designar usuários do App Hub nesta página.

    Ao ativar o gerenciamento de aplicativos em uma pasta, um projeto de gerenciamento de propriedade do Google é criado com o seguinte formato: FOLDER_DISPLAY_NAME-mp. O projeto de gerenciamento hospeda os projetos descendentes da pasta ativada para apps e ajuda a gerenciar funcionalidades entre projetos. Agora você pode criar aplicativos do App Hub para os projetos descendentes nessa pasta habilitada para apps.

  3. Opcional: é possível criar projetos ou movê-los de uma pasta diferente para a pasta habilitada para apps. Em seguida, crie aplicativos na pasta habilitada para apps para gerenciar os serviços e as cargas de trabalho no projeto. Para mais informações sobre como criar projetos, consulte Como criar projetos. Para mais informações sobre como mover um projeto, consulte Como mover um projeto.

Designar usuários do App Hub

Se você for o criador do projeto, vai receber o papel básico de proprietário (roles/owner). Por padrão, esse papel do 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 de computação). Para conseguir as permissões necessárias para concluir este tutorial, peça ao administrador para conceder a você o seguinte papel do IAM no seu projeto:

Console

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

    Acessar IAM

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

    1. No seletor do 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 pasta FOLDER_DISPLAY_NAME.
      • Pesquise e selecione a pasta FOLDER_DISPLAY_NAME.

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

  4. No campo Novos participantes, digite 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 para apps.

  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 que vão visualizar os dados do aplicativo e os atributos dele emGoogle Cloud serviços que oferecem suporte ao gerenciamento de aplicativos. Esse papel é concedido ao indivíduo em todos os projetos e subpastas da pasta ativada para apps.

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

    gcloud components update

  3. Conceda às pessoas que vão administrar o App Hub a função de administrador do App Hub na pasta ativada para apps. 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 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 para apps. No seletor de projetos, selecione a pasta habilitada para apps.
    • 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 apps aos indivíduos para que eles possam ver os dados do aplicativo e os atributos dele em serviços compatíveis com o gerenciamento de aplicativos. Google Cloud Esse papel é concedido ao indivíduo em todos os projetos e subpastas da pasta ativada para apps.

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

    Substitua FOLDER_ID pelo ID do projeto. Encontre o ID da pasta ativada para apps na página IAM e administrador Configurações do console Google Cloud . Para garantir que a pasta esteja ativada para apps, 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 para apps. No seletor de projetos, selecione sua pasta habilitada para apps.

Adicionar ou remover projetos

É possível modificar os anexos do projeto para disponibilizar diferentes recursos de infraestrutura e agrupá-los em um aplicativo.

Console

Adicionar um projeto a uma pasta habilitada para apps

    Create a Google Cloud project.

    gcloud projects create PROJECT_ID

    Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    Roles required to create a project

    To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Remover um projeto de uma pasta com app ativado

    Delete a Google Cloud project:

    gcloud projects delete PROJECT_ID

gcloud

Adicionar um projeto a uma pasta habilitada para apps

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

A seguir