Configure um único projeto

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA 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 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, o que os torna 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:

Consola

1. Na Google Cloud consola, use o seletor de projetos para selecionar o seu projeto.

2. Navegue para a página Vista geral a partir do App Hub:

   Aceda à Vista geral

3. Clique em Configurar o centro de apps.

   Se o seu projeto já estiver numa pasta com apps ativadas, a página não apresenta a opção Configurar App Hub. Em alternativa, é-lhe pedido que selecione a pasta com a app ou que use o projeto atual a partir de um menu. Selecione o projeto atual para continuar com a configuração de projeto único. Para saber mais sobre as considerações relativas à hierarquia de recursos para a gestão de aplicações, consulte o artigo Planeie a hierarquia de recursos para a gestão de aplicações.

4. Na página Ativar App Hub, escolha uma das seguintes opções:

   • Configuração rápida: faça a gestão de uma configuração predefinida para recursos neste projeto e defina a sua primeira aplicação para adoção inicial.
   • Configuração completa: faça a gestão das configurações personalizadas para as suas aplicações, incluindo a configuração de controlos de acesso antecipados e, opcionalmente, a adição de mais projetos para limites de vários projetos.

5. Tome nota do nome e do ID do projeto. Estas informações identificam o projeto de gestão e vai usar estes valores para conceder acesso.

6. Reveja a lista de APIs que estão a ser ativadas. Algumas APIs têm custos associados. Saiba mais acerca dos custos das APIs ou clique em cada API para ver os custos associados.

7. Clique em Continuar.

8. Conclua a configuração com base na sua seleção:

   • Se selecionou Configuração rápida, o separador Definir aplicação permite-lhe definir opcionalmente uma aplicação agora ou concluir a configuração sem criar uma. Agora, já pode criar aplicações e registar recursos nas mesmas. Também pode começar com um guia de início rápido para aplicações.

   • Se selecionou Configuração completa, conceda acesso personalizado centrado na aplicação aos seus administradores:

     1. No separador Definir limite, valide as informações do projeto. A tabela Projetos no seu limite mostra apenas o projeto que define o limite de projeto único. Para a configuração do limite de projeto único, não adicione projetos adicionais.

     2. Clique em Continuar.

     3. No separador Conceder acesso, escolha as funções e autorizações de IAM adequadas para os administradores no projeto. Para ver uma lista de funções recomendadas centradas na aplicação em todos os Google Cloud produtos, consulte Conceda funções centradas na aplicação aos seus utilizadores.

     4. Na caixa Novos membros, introduza os utilizadores, os grupos ou as contas de serviço que devem ter acesso de administrador a tarefas centradas na aplicação no projeto.

     5. Clique em Conceder funções e, de seguida, em Concluir.

     Agora, pode registar recursos existentes numa aplicação ou criar um modelo de aplicação com o Centro de Design de Aplicações.

Posteriormente, pode conceder funções de IAM adicionais aos seus diretores na página IAM. Para mais informações, consulte o artigo Conceda uma função do IAM através da Google Cloud consola.

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 CLI Google Cloud:

   gcloud components update
   

3. Encontre o ID do projeto.

4. Definir o projeto como o projeto predefinido para comandos:

   gcloud config set project PROJECT_ID
   

   Substitua PROJECT_ID pelo ID do projeto.

5. Ative a API App Hub:

   gcloud services enable apphub.googleapis.com \
       --project PROJECT_ID
   

6. Anexe o projeto a si próprio para criar um limite de gestão de aplicações:

   gcloud apphub boundary update \
       --crm-node=projects/PROJECT_ID \
       --project=PROJECT_ID \
       --location=global
   

   Este 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.

7. Confirme o estado do anexo:

   gcloud apphub boundary describe \
       --project=PROJECT_ID \
       --location=global
   

   Obtém um resultado semelhante ao seguinte exemplo:

   name: projects/PROJECT_ID/locations/LOCATION/boundary
   crmNode: projects/PROJECT_ID
   createTime: 2025-08-28T19:04:47Z
   updateTime: 2025-08-28T19:04:47Z
   type: AUTOMATIC
   

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

1. Na Google Cloud consola, use o seletor de projetos para selecionar o projeto de gestão.

2. Navegue para a página IAM:

   Aceder ao IAM

3. Clique em Conceder acesso. O painel Conceder acesso é aberto.

4. No campo Novos membros, introduza o endereço de email do membro ao qual quer conceder acesso ao App Hub.

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

6. Selecione a função de IAM do App Hub que quer atribuir ao principal e clique em Guardar.

gcloud

1. 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 formato username@yourdomain, por exemplo, [e-mail].
   • ROLE_NAME: o papel de IAM do App Hub que quer atribuir ao principal, por exemplo, roles/apphub.admin.

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:

Consola

1. Na Google Cloud consola, use o seletor de projetos para selecionar o projeto de gestão.

   Aceder a Boas-vindas

2. Navegue para a página Definições de limites a partir do App Hub:

   Aceda às definições de limites

3. Selecione a caixa de verificação do projeto para o desassociar do limite e desativar a gestão de aplicações.

4. Clique em Desassociar projetos.

   A tabela Projetos no seu limite é atualizada e deixa de apresentar as informações do seu projeto.

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 CLI Google Cloud:

   gcloud components update
   

3. Encontre o ID do projeto.

4. Defina o projeto como o projeto predefinido para comandos:

   gcloud config set project PROJECT_ID
   

   Substitua PROJECT_ID pelo ID do projeto.

5. Desassocie o projeto do respetivo limite para desativar a gestão de aplicações:

   gcloud apphub boundary update \
       --project=PROJECT_ID \
       --location=global \
       --crm-node=""
   

   Este comando atualiza o recurso de limite e remove o anexo, desativando a gestão de aplicações para o projeto.

6. Confirme a separação descrevendo o limite:

   gcloud apphub boundary describe \
       --project=PROJECT_ID \
       --location=global
   

   O resultado não contém um campo crmNode, o que confirma que a gestão de aplicações está desativada no projeto.

7. Opcionalmente, elimine todas as aplicações no projeto e, em seguida, desative a API App Hub se não for usar mais funcionalidades de aplicações neste projeto:

   gcloud services disable apphub.googleapis.com \
       --project=PROJECT_ID
   

O que se segue?

• 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 da IAM do App Hub
• Vista geral do App Hub