Esta página foi traduzida pela API Cloud Translation.

Configurar um único projeto

Neste documento, descrevemos como configurar um único projeto do Google Cloud para gerenciar aplicativos. Essa configuração também é conhecida como o limite de projeto único.

Nessa configuração, o projeto Google Cloud é configurado para gerenciar os próprios aplicativos e componentes, atuando como um projeto de gerenciamento independente. Essa abordagem é a maneira mais rápida de começar a gerenciar aplicativos se todos os componentes deles estiverem neste único projeto. O App Hub descobre automaticamente todos os recursos compatíveis no projeto, deixando-os prontos para serem organizados em aplicativos.

Limitações

O limite de projeto único tem suporte a recursos diferente do limite no nível da pasta. O App Hub, o Application Design Center e o Application Monitoring oferecem suporte total a projetos únicos, mas outros serviços do Google Cloud focados em aplicativos, como o Cloud Hub e o Gemini Cloud Assist, exigem um limite no nível da pasta.

Para uma comparação do suporte a recursos entre os modelos de projeto único e de pasta, consulte Suporte a recursos por tipo de limite.

Antes de começar

Escolha o projeto do Google Cloud que você quer usar para gerenciar seus aplicativos. Esse projeto vai funcionar como o projeto de gerenciamento independente. É possível usar um projeto atual ou criar um novo.

Funções exigidas

Para ter as permissões necessárias para configurar um único projeto para gerenciamento de aplicativos, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto que você quer configurar como o projeto de gerenciamento independente:

Gerenciar recursos, permissões e faturamento no projeto: Proprietário do projeto (roles/owner)
Gerenciar todos os componentes do aplicativo no projeto: Administrador do App Hub (roles/apphub.admin)

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 em um projeto

Essa ação configura o projeto como um projeto de gerenciamento independente e ativa as APIs necessárias para metadados e configurações de aplicativos. O projeto é chamado de projeto com app ativado.

Para ativar o gerenciamento de aplicativos em um único projeto, siga estas etapas:

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.
Verifique se a versão mais recente da Google Cloud CLI está instalada:
```
gcloud components update
```
Encontre o ID do projeto.
Defina o projeto como o padrão para comandos:
```
gcloud config set project PROJECT_ID
```
Substitua PROJECT_ID pelo ID do projeto.

Ative a API App Hub:

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

Anexe o projeto a ele mesmo para criar um limite de gerenciamento de aplicativos:
```
gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --project=PROJECT_ID \
    --location=global
```
Esse comando configura o projeto como um projeto de gerenciamento próprio, permitindo que o App Hub descubra automaticamente todos os recursos compatíveis nele.

Confirme o status do anexo:

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

Você vai receber uma saída semelhante a este 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: AUTOMATIC

PROJECT_NUMBER é o número do projeto correspondente ao ID do projeto.

Quando você terminar de configurar o projeto de gerenciamento, as APIs necessárias para o gerenciamento de aplicativos serão ativadas, e você poderá começar a usar o App Hub para agrupar serviços e cargas de trabalho em aplicativos. Se quiser, revise as APIs recomendadas para ter acesso a recursos avançados.

Atribuir permissões e papéis do App Hub

Para permitir que os usuários descubram, registrem e gerenciem componentes de aplicativos nesse projeto usando o App Hub, conceda a eles os papéis e permissões do App Hub adequados.

Siga estas etapas:

Console

No console Google Cloud , use o seletor de projetos para escolher o projeto de gerenciamento.
Acesse a página IAM:

Acessar IAM
Clique em Conceder acesso. O painel Conceder acesso será aberto.
No campo Novos principais, insira o endereço de e-mail do principal a quem você quer conceder acesso ao App Hub.
Clique em Selecionar um papel e digite App Hub no campo Filtro.
Selecione a função do IAM do Hub de apps que você quer atribuir ao principal e clique em Salvar.

gcloud

Conceda acesso aos principais no projeto de gerenciamento:
```
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'
```
Substitua:
- PROJECT_ID: o ID do projeto de gerenciamento.
- EMAIL_ADDRESS: o endereço de e-mail do principal que precisa ter acesso ao App Hub. Esse valor precisa ter o formato username@yourdomain, por exemplo, my.user@example.com.
- ROLE_NAME: o papel do IAM do App Hub que você quer atribuir ao principal, por exemplo, roles/apphub.admin.

Mudar o limite do gerenciamento de aplicativos

Se você quiser mudar o projeto que define o limite de projeto único, desative o gerenciamento de aplicativos no projeto antigo e ative no novo. Os dados do aplicativo não são migrados, e você precisa recriar os aplicativos no novo projeto.

Para migrar de um limite de projeto único para um limite no nível da pasta, configure uma pasta ativada para apps. Essa ação configura um novo projeto de gerenciamento na pasta. Será necessário recriar aplicativos nesse novo projeto de gerenciamento.

Desativar o gerenciamento de aplicativos em um projeto

É possível desativar o gerenciamento de aplicativos em um projeto se você não quiser mais gerenciar os recursos dele nos aplicativos do App Hub.

Quando você desativa o gerenciamento de aplicativos no projeto, ele é separado do limite de gerenciamento de aplicativos. Os serviços e as cargas de trabalho nos seus aplicativos continuam existindo, mas o status de registro muda para desvinculado. Se você decidir reativar o gerenciamento de aplicativos no projeto, o App Hub poderá redescobrir seus aplicativos, serviços e cargas de trabalho e atualizar o status de registro se os recursos subjacentes ainda existirem.

Para desativar o gerenciamento de aplicativos em um único projeto, siga estas etapas:

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.
Verifique se a versão mais recente da Google Cloud CLI está instalada:
```
gcloud components update
```
Encontre o ID do projeto.
Defina o projeto como o padrão para comandos:
```
gcloud config set project PROJECT_ID
```
Substitua PROJECT_ID pelo ID do projeto.
Desvincule o projeto do limite para desativar o gerenciamento de aplicativos:
```
gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-crm-node
```
Esse comando atualiza o recurso de limite e remove o anexo, desativando o gerenciamento de aplicativos para o projeto.
Confirme o desvinculamento descrevendo o limite:
```
gcloud alpha apphub boundary describe \
    --project=PROJECT_ID \
    --location=global
```
A saída não contém um campo crmNode, confirmando que o gerenciamento de aplicativos está desativado no projeto.
Se quiser, exclua todos os aplicativos do projeto e desative a API App Hub se não for mais usar os recursos de aplicativos neste projeto:
```
gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID
```

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