Este documento descreve como configurar um único Google Cloud projeto para gerir aplicações. Esta configuração também é conhecida como o limite de projeto único.
Nesta configuração, o Google Cloud projeto está configurado para gerir as suas próprias aplicações e componentes, atuando como um projeto de gestão autónomo. Esta abordagem é a forma mais rápida de começar a gerir aplicações se todos os componentes da sua aplicação residirem neste único projeto. O App Hub descobre automaticamente todos os recursos suportados no projeto, tornando-os prontos para serem organizados em aplicações.
Limitações
O limite de projeto único tem um suporte de funcionalidades diferente em comparação com o limite ao nível da pasta. O App Hub, o Application Design Center e a Monitorização de aplicações suportam totalmente projetos únicos, mas outros serviços Google Cloud centrados em aplicações, como o Cloud Hub e o Gemini Cloud Assist, requerem um limite ao nível da pasta.
Para uma comparação do suporte de funcionalidades entre os modelos de projeto único e ao nível da pasta, consulte o artigo Suporte de funcionalidades por tipo de limite.
Antes de começar
Escolha o Google Cloud projeto que quer usar para gerir as suas aplicações. Este projeto vai funcionar como o projeto de gestão autónomo. Pode usar um projeto existente ou criar um novo.
Funções necessárias
Para receber as autorizações de que precisa para configurar um único projeto para a gestão de aplicações, peça ao seu administrador para lhe conceder as seguintes funções da IAM no projeto que quer configurar como o projeto de gestão autónomo:
-
Faça a gestão de recursos, autorizações e faturação no projeto:
Proprietário do projeto (
roles/owner) -
Gerir todos os componentes da aplicação no projeto:
Administrador do App Hub (
roles/apphub.admin)
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 num projeto
Esta ação configura o projeto como um projeto de gestão autónomo e ativa as APIs necessárias para metadados e configurações da aplicação. O projeto é então denominado projeto com apps.
Para ativar a gestão de aplicações num único projeto, siga estes passos:
-
In the Google Cloud console, 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.
Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI:
gcloud components updateDefinir o projeto como o projeto predefinido para comandos:
gcloud config set project PROJECT_IDSubstitua
PROJECT_IDpelo ID do projeto.Ative a API App Hub:
gcloud services enable apphub.googleapis.com \ --project PROJECT_IDAnexe o projeto a si próprio para criar um limite de gestão de aplicações:
gcloud alpha apphub boundary update \ --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \ --project=PROJECT_ID \ --location=globalEste comando configura o projeto como o seu próprio projeto de gestão, o que permite ao App Hub descobrir automaticamente todos os recursos suportados no mesmo.
Confirme o estado do anexo:
gcloud alpha apphub boundary describe \ --project=PROJECT_ID \ --location=globalObtém um resultado semelhante ao seguinte exemplo:
name: projects/PROJECT_ID/locations/LOCATION/boundary crmNode: projects/PROJECT_NUMBER createTime: 2025-08-28T19:04:47Z updateTime: 2025-08-28T19:04:47Z type: AUTOMATICPROJECT_NUMBERé o número do projeto correspondente ao seu ID do projeto.Na Google Cloud consola, use o seletor de projetos para selecionar o projeto de gestão.
Navegue para a página IAM:
Clique em Conceder acesso. O painel Conceder acesso é aberto.
No campo Novos membros, introduza o endereço de email do principal ao qual quer conceder acesso ao App Hub.
Clique em Selecionar uma função e introduza App Hub no campo Filtro.
Selecione a função de IAM do App Hub que quer atribuir ao principal e clique em Guardar.
Conceda acesso a principais no projeto de gestão:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member='user:EMAIL_ADDRESS' \ --role='ROLE_NAME'Substitua o seguinte:
PROJECT_ID: o ID do projeto de gestão.EMAIL_ADDRESS: o endereço de email do diretor que tem de obter acesso ao App Hub. Este valor tem de ter o formatousername@yourdomain, por exemplo,my.user@example.com.ROLE_NAME: o papel de IAM do App Hub que quer atribuir ao principal, por exemplo,roles/apphub.admin.
-
In the Google Cloud console, 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.
Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI:
gcloud components updateDefinir o projeto como o projeto predefinido para comandos:
gcloud config set project PROJECT_IDSubstitua
PROJECT_IDpelo ID do projeto.Desassocie o projeto do respetivo limite para desativar a gestão de aplicações:
gcloud alpha apphub boundary update \ --project=PROJECT_ID \ --location=global \ --clear-crm-nodeEste comando atualiza o recurso de limite e remove o anexo, desativando a gestão de aplicações para o projeto.
Confirme a separação descrevendo o limite:
gcloud alpha apphub boundary describe \ --project=PROJECT_ID \ --location=globalO resultado não contém um campo
crmNode, o que confirma que a gestão de aplicações está desativada no projeto.Opcionalmente, elimine todas as aplicações no projeto e, em seguida, desative a API App Hub se já não usar as funcionalidades da aplicação neste projeto:
gcloud services disable apphub.googleapis.com \ --project=PROJECT_ID- Início rápido: crie uma aplicação a partir de recursos existentes
- Registe recursos numa aplicação
- Configure a monitorização de aplicações
- Funções e autorizações do IAM do App Hub
- Vista geral do App Hub
Quando terminar de configurar o projeto de gestão, as APIs necessárias para a gestão de aplicações são ativadas e pode começar a usar o App Hub para agrupar serviços e cargas de trabalho em aplicações. Opcionalmente, reveja as APIs recomendadas para aceder a funcionalidades avançadas.
Atribua funções e autorizações do App Hub
Para permitir que os utilizadores descubram, registem e geram componentes de aplicações neste projeto através do App Hub, tem de lhes conceder as funções e autorizações do App Hub adequadas.
Siga estes passos:
Consola
gcloud
Altere o limite de gestão de aplicações
Se quiser alterar o projeto que define o limite de projeto único, desative a gestão de aplicações no projeto antigo e ative-a no novo. Os dados da aplicação não são migrados e tem de recriar as suas aplicações no novo projeto.
Para passar de um limite de projeto único para um limite ao nível da pasta, configure uma pasta ativada para apps. Esta ação configura um novo projeto de gestão na pasta. Tem de recriar as aplicações neste novo projeto de gestão.
Desative a gestão de aplicações num projeto
Pode desativar a gestão de aplicações num projeto se já não quiser gerir os respetivos recursos nas aplicações do App Hub.
Quando desativa a gestão de aplicações no projeto, o projeto é separado do respetivo limite de gestão de aplicações. Os serviços e as cargas de trabalho nas suas aplicações continuam a existir, mas o respetivo estado de registo muda para desanexado. Se decidir reativar a gestão de aplicações no projeto, o App Hub pode redescobrir as suas aplicações, serviços e cargas de trabalho, e atualizar o estado de registo se os recursos subjacentes ainda existirem.
Para desativar a gestão de aplicações num único projeto, siga estes passos: