Configure o App Hub para pastas com apps

Pré-visualização — App-enabled folders and Management projects

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Este documento fornece instruções para configurar o App Hub através de uma pasta com apps ativadas para criar, operar e gerir aplicações do App Hub no Google Cloud. Destina-se a pessoas que configuram e administram o App Hub.

Também pode configurar o App Hub num projeto anfitrião. No entanto, recomendamos que use pastas ativadas para apps em vez de projetos anfitriões para gerir as suas aplicações, uma vez que as pastas ativadas para apps têm acesso a funcionalidades como o Application Design Center e o Gemini Cloud Assist. Para mais informações sobre como configurar o App Hub num projeto anfitrião, consulte o artigo Configure o App Hub em projetos anfitriões.

Depois de configurar uma aplicação do App Hub numa pasta com apps ativadas, pode usar a assistência de linguagem natural para obter informações sobre a sua aplicação. Para mais informações, consulte o artigo Use o Gemini Cloud Assist na Google Cloud consola.

Serviços e cargas de trabalho

Através do App Hub, os recursos dos Google Cloud projetos que são descendentes da pasta ativada para apps estão disponíveis para si como serviços e cargas de trabalho. O registo dos seus serviços e cargas de trabalho numa aplicação permite-lhe observar e monitorizar os recursos. O App Hub suporta recursos globais e regionais. Para mais informações sobre os recursos que pode adicionar às aplicações, consulte o artigo Recursos suportados do App Hub.

Processo de configuração geral

A lista seguinte resume os passos para configurar o App Hub:

1. Determine que recursos existentes incluir na sua aplicação e a que projetos pertencem. Para mais informações sobre como gerir a sua aplicação, consulte o artigo Gestão de aplicações.
2. Ative a gestão de aplicações numa pasta. Agora, pode gerir recursos de todos os projetos descendentes da pasta com a app ativada. Se forem adicionados novos projetos com recursos subjacentes de que as suas aplicações precisam à pasta, esses projetos são ativados automaticamente para a gestão de aplicações.
   Tenha em atenção o seguinte:
   1. Os projetos têm de estar na mesma organização que a pasta com apps ativadas. Depois de anexar um projeto a uma pasta com apps ativadas, se quiser mover o projeto para uma organização diferente, tem de migrar o projeto. Para mais informações, consulte o artigo Migrar projetos entre recursos da organização.
   2. Depois de anexar projetos a uma pasta compatível com apps, a consulta da pasta compatível com apps para serviços ou cargas de trabalho devolve automaticamente todos os serviços e cargas de trabalho em todos os projetos anexados à pasta compatível com apps.
   3. Se uma pasta com apps ativadas for movida para uma organização diferente, todos os serviços e cargas de trabalho registados são separados.
3. Designar utilizadores do App Hub como administradores, editores ou visitantes do App Hub.
4. Crie uma aplicação para organizar várias cargas de trabalho e serviços.
   Tenha em atenção o seguinte:
   1. Certifique-se de que a aplicação tem um nome único na pasta e na localização ativadas para apps.
   2. Um projeto pode ser anexado a uma pasta com várias aplicações, mas os respetivos recursos individuais só podem ser registados numa aplicação.
   3. Se um projeto for movido para uma pasta ou uma organização diferente, a aplicação continua a existir na pasta ativada para apps com os respetivos serviços e cargas de trabalho num estado desassociado.
5. Consultar serviços e cargas de trabalho e registá-los na sua aplicação. Depois de criar uma aplicação, pode consultar a pasta ativada para apps para ver os serviços e as cargas de trabalho disponíveis. As consultas são executadas na pasta com a app ativada e em todos os projetos anexados à pasta com a app ativada. A consulta também devolve todos os serviços e cargas de trabalho nesses projetos. Tenha em atenção o seguinte:
   1. Só pode registar um serviço ou uma carga de trabalho numa única aplicação.
   2. Tem de registar serviços e cargas de trabalho de uma região específica numa aplicação regional na mesma região ou numa aplicação global. As instruções e os comandos que se seguem pressupõem que todos os recursos estão na mesma região. Para obter informações sobre as regiões que pode designar, consulte Localizações.
   3. Os serviços e as cargas de trabalho registados não são afetados pelas atualizações ao recurso de infraestrutura subjacente. Por outras palavras, se eliminar os recursos subjacentes que atuam como serviços e cargas de trabalho, o App Hub não elimina as cargas de trabalho e os serviços associados da sua aplicação. Tem de anular separadamente o registo da carga de trabalho ou do serviço.

Pré-requisitos

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

1. Certifique-se de que tem a função do IAM necessária para ativar ou criar uma conta de faturação para o seu projeto de gestão.
2. Decida usar uma pasta existente ou criar uma nova na qual possa ativar a gestão de aplicações. Para mais informações sobre como criar uma pasta, consulte o artigo Criar pastas.
3. Certifique-se de que decidiu que indivíduos detêm as funções de gestão de identidade e de acesso (IAM) para o App Hub: administrador do App Hub, editor do App Hub e leitor do App Hub. Para mais informações sobre as funções e as autorizações, consulte o artigo Funções e autorizações do App Hub.

Funções necessárias

Para receber as autorizações de que precisa para modificar os recursos do App Hub, peça ao seu administrador que lhe conceda as seguintes funções de IAM na pasta com apps ativadas:

• Para criar e atualizar aplicações, bem como registar e anular o registo de serviços e cargas de trabalho:
  • Administrador do App Hub (roles/apphub.admin)
  • Editor do App Hub (roles/apphub.editor)
• Para ativar a gestão de aplicações numa pasta: Administrador da pasta (resourcemanager.folderAdmin)
• Para ver aplicações, serviços e cargas de trabalho, bem como os respetivos atributos, em Google Cloud serviços que suportam a gestão de aplicações: Visualizador de gestão do App Hub (roles/apphub.appManagementViewer)
  Para mais informações sobre como ver os dados da sua aplicação num único local, consulte a vista geral do Cloud Hub.

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Ative a gestão de aplicações

Nesta secção, seleciona uma pasta e ativa a gestão de aplicações na pasta. Quando configura a gestão de aplicações para uma pasta, o processo de ativação inclui as seguintes ações:

• Criação de um novo projeto de gestão na pasta. O projeto de gestão é um projeto criado pela Google que não pode mover nem eliminar. Apenas um projeto de gestão está associado a uma pasta com apps ativadas. O projeto de gestão é usado para gerir a quota e a faturação de todos os projetos descendentes associados à pasta com a app ativada.
• Ativar APIs para serviços como o App Hub e o Gemini Cloud Assist que suportam a gestão de aplicações.

1. Na Google Cloud consola, aceda à página App Hub.

   Aceda ao App Hub

2. Com base nos seguintes cenários, siga estes passos:

   • Se estiver num Google Cloud projeto ou numa Google Cloud pasta que não tenha apps ativadas:
     1. Clique em Selecionar uma pasta.
     2. Na caixa de diálogo Selecionar uma pasta, selecione uma pasta ativada para apps. Se precisar de informações sobre pastas com apps ativadas, pergunte ao seu administrador. Se selecionou uma pasta que não tem as apps ativadas e tem a função do IAM de administrador da pasta (resourcemanager.folderAdmin), ative a gestão de aplicações na pasta. Para mais informações, consulte Ativar a gestão de aplicações e as APIs numa pasta.
   • Se estiver numa Google Cloud pasta com apps ativadas, nesta página, aceda a Designar utilizadores do App Hub.

   A ativação da gestão de aplicações numa pasta cria um projeto pertencente à Google denominado projeto de gestão com o seguinte formato: FOLDER_DISPLAY_NAME-mp. O projeto de gestão aloja os projetos descendentes da pasta com apps ativadas e ajuda a gerir funcionalidades entre projetos. Agora, pode criar aplicações do App Hub para os projetos descendentes nesta pasta com apps ativadas.

3. Opcional: pode criar projetos ou movê-los de uma pasta diferente para a pasta ativada para apps. Em seguida, pode criar aplicações na pasta ativada para apps para gerir os serviços e as cargas de trabalho no projeto. Para mais informações sobre a criação de projetos, consulte o artigo Criar projetos. Para mais informações sobre como mover um projeto, consulte o artigo Mover um projeto.

Designar utilizadores do App Hub

Se for o criador do projeto, é-lhe concedida a função básica de proprietário (roles/owner). Por predefinição, esta função de IAM inclui as autorizações necessárias para acesso total à maioria dos Google Cloud recursos.

Se não for o criador do projeto, as autorizações necessárias têm de ser concedidas no projeto ao principal adequado. Por exemplo, um principal pode ser uma Conta Google (para utilizadores finais) ou uma conta de serviço (para aplicações e cargas de trabalho de computação). Para receber as autorizações necessárias para concluir este tutorial, peça ao seu administrador para lhe conceder a seguinte função de IAM no seu projeto:

Consola

1. Na Google Cloud consola, aceda à página IAM.

   Aceda ao IAM

2. Certifique-se de que o seletor de projetos na barra de navegação superior apresenta a pasta com a app ativada. O seletor do Purview indica a organização, a pasta ou o projeto em que está a trabalhar. Se não estiver na pasta com a app ativada, siga estes passos para selecionar uma pasta com a app ativada:

   1. No selecionador do Purview, clique na opção selecionada.
   2. Na caixa de diálogo Selecionar um recurso, faça uma das seguintes ações:
      • Na lista de pastas, selecione a pasta FOLDER_DISPLAY_NAME.
      • Pesquise a pasta FOLDER_DISPLAY_NAME e, de seguida, selecione-a.

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

4. No campo Novos responsáveis, introduza o endereço de email do indivíduo responsável pela administração do App Hub, a função de administrador do App Hub na pasta com apps ativadas.

5. Clique em Selecionar uma função e, no campo Filtro, introduza App Hub.

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

7. Repita os passos para conceder a função de Visualizador de gestão de apps aos indivíduos para verem os dados da aplicação e os respetivos atributos nosGoogle Cloud serviços que suportam a gestão de aplicações. Esta função é concedida ao indivíduo em todos os projetos e subpastas da pasta ativada para apps.

8. Clique em Guardar.

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. Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI. Execute o seguinte comando a partir do Cloud Shell:

   gcloud components update

3. Conceda aos indivíduos que vão administrar o App Hub a função de administrador do App Hub na pasta com apps ativadas. Repita o seguinte comando para cada administrador. Têm de ter a função de administrador do App Hub para criar aplicações.

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

   Substitua o seguinte:

   • MANAGEMENT_PROJECT_ID: o ID do projeto de gestão no formato google-mpf-FOLDER_ID. Pode encontrar o ID do projeto de gestão na página Identity and Access Management (IAM) e Admin Settings da Google Cloud consola. Se não conseguir encontrar o ID do projeto de gestão, pode não estar numa pasta com apps ativadas. No seletor de projetos, selecione a pasta com apps ativadas.
   • MANAGEMENT_PROJECT_ADMIN: o utilizador que tem a função de administrador do App Hub no projeto. Este valor tem o formato username@yourdomain, por exemplo, [e-mail].

4. Conceda a função de visualizador de gestão de apps na pasta com apps ativadas aos indivíduos para verem os dados da aplicação e os respetivos atributos nos Google Cloud serviços que suportam a gestão de aplicações. Esta função é concedida 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. Pode encontrar o ID da pasta com apps ativadas na página IAM e administração Definições da consola Google Cloud . Para garantir que a pasta tem a app ativada, a página Definições deve apresentar o ID do projeto de gestão. Se não conseguir encontrar o ID do projeto de gestão, pode não estar numa pasta com apps ativadas. No seletor de projetos, selecione a pasta com apps.

Nota: para desativar a gestão de aplicações numa pasta, tem de enviar um pedido de apoio técnico.

Adicione ou remova projetos

Pode modificar os anexos de projetos para disponibilizar diferentes recursos de infraestrutura para agrupar numa aplicação.

Consola

Adicione um projeto a uma pasta com apps ativadas

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.

Remova um projeto de uma pasta com apps ativadas

Atenção: a eliminação de um projeto tem os seguintes efeitos:

• Tudo no projeto é eliminado. Se usou um projeto existente para as tarefas neste documento, quando o elimina, também elimina qualquer outro trabalho que tenha feito no projeto.
• Os IDs dos projetos personalizados são perdidos. Quando criou este projeto, pode ter criado um ID do projeto personalizado que quer usar no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, elimine os recursos selecionados no projeto em vez de eliminar o projeto inteiro.

Se planeia explorar várias arquiteturas, tutoriais ou inícios rápidos, a reutilização de projetos pode ajudar a evitar exceder os limites de quota de projetos.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

gcloud

Adicione um projeto a uma pasta com apps ativadas

gcloud projects create PROJECT_ID \
    --folder FOLDER_ID

Remova um projeto de uma pasta com apps ativadas

Atenção: a eliminação de um projeto tem os seguintes efeitos:

• Tudo no projeto é eliminado. Se usou um projeto existente para as tarefas neste documento, quando o elimina, também elimina qualquer outro trabalho que tenha feito no projeto.
• Os IDs dos projetos personalizados são perdidos. Quando criou este projeto, pode ter criado um ID do projeto personalizado que quer usar no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, elimine os recursos selecionados no projeto em vez de eliminar o projeto inteiro.

Se planeia explorar várias arquiteturas, tutoriais ou inícios rápidos, a reutilização de projetos pode ajudar a evitar exceder os limites de quota de projetos.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

O que se segue?

• Configure a monitorização de aplicações
• Modifique recursos do App Hub
• Funções e autorizações do IAM do App Hub
• Vista geral do App Hub