Esta página foi traduzida pela API Cloud Translation.

Escolher o modelo de configuração do App Hub

Para organizar de forma eficaz os recursos de infraestrutura em aplicativos do App Hub, escolha um modelo de configuração para o gerenciamento de aplicativos. O App Hub oferece os seguintes modelos:

Pasta ativada para apps (pré-lançamento): o modelo recomendado para novas implementações de agrupamento de aplicativos. Ele configura uma pasta Google Cloud padrão para gerenciamento de aplicativos, desbloqueando todos os recursos disponíveis do Google Cloud focado em aplicativos.
Projeto host: o modelo compatível para usuários atuais do App Hub, que configura um projeto Google Cloud padrão para agrupar recursos.

A tabela a seguir compara os modelos de configuração de gerenciamento de aplicativos disponíveis para dar uma visão resumida das principais diferenças e ajudar você a escolher a opção mais adequada às suas necessidades:

Recurso	Pasta habilitada para apps	Projeto host
Recomendação	Recomendado para novos usuários	Modelo compatível para usuários atuais
Limite principal	A pasta habilitada para apps com todos os descendentes	O projeto host e todos os projetos de serviço anexados manualmente
Descoberta de recursos	Automático na pasta e nos descendentes	É necessário anexar manualmente os projetos de serviço
Projeto de gerenciamento	Criado automaticamente pelo Google	Não relevante
Principais recursos	Acesso total aos recursos do Google Cloud focados em aplicativos, incluindo monitoramento aprimorado no Cloud Hub e nos produtos do Google Cloud Observability, design e implantação de aplicativos no Application Design Center e otimização de aplicativos usando o Gemini Cloud Assist	Agrupamento básico de aplicativos, com suporte limitado para visualização de dados de observabilidade no App Hub ou no Cloud Logging, Cloud Monitoring e Cloud Trace
Estratégia do IAM	Controle granular de permissões no nível da pasta, do projeto de gerenciamento ou do aplicativo individual	Controle de permissões no nível do projeto
Ativação da API	Automático no projeto de gerenciamento	Manual sobre o projeto host
Escalonabilidade	Projetado para escala organizacional	Limitada pelo recurso do projeto
Complexidade da configuração	Planejamento inicial da estrutura de pastas	Configuração inicial direta com vinculação manual
Instruções de configuração	Configurar o App Hub com pastas habilitadas para gerenciar apps	Configurar o App Hub com um projeto host

Nesta página, você vai aprender a selecionar o melhor modelo para suas necessidades de gerenciamento de aplicativos, detalhando os benefícios, as considerações e as diferenças de recursos entre eles.

Pasta ativada para apps

Recomendado

Uma pasta habilitada para apps é uma pasta Google Cloud padrão que você configura para gerenciamento de aplicativos. Esse modelo funciona como um limite administrativo para seus aplicativos e é a base da experiência de gerenciamento de aplicativos no Google Cloud focado em aplicativos.

Quando você ativa uma pasta para gerenciamento de aplicativos, Google Cloud cria automaticamente um projeto de gerenciamento nela. Esse projeto armazena todos os modelos, metadados e configurações de aplicativos para serviços como o App Hub e o Application Design Center. Ele também lida com a ativação automática das APIs necessárias.

Benefícios:

Descoberta hierárquica de recursos: agrupe todos os serviços e cargas de trabalho compatíveis em todos os projetos ou pastas aninhadas na pasta habilitada para apps como aplicativos únicos.
Acesso total aos recursos: desbloqueie toda a gama de recursos de gerenciamento de aplicativos, incluindo o Application Design Center para criar e implantar aplicativos, além da assistência com tecnologia de IA do Gemini Cloud Assist.
Metadados centralizados: o projeto de gerenciamento criado na pasta habilitada para apps fornece uma única fonte de verdade para definições e atributos de aplicativos.
Governança escalonável: alinhe o gerenciamento de aplicativos à estrutura organizacional usando pastas.

Considerações:

Estrutura de pastas: planeje com cuidado a hierarquia de recursos do Google Cloud . Os aplicativos em uma pasta habilitada para apps podem incluir recursos de qualquer projeto dentro dessa pasta ou dos descendentes dela. Organize as pastas por unidade de negócios, ambiente ou equipe de acordo com suas necessidades.
Estratégia do IAM: normalmente, é possível conceder permissões na pasta ativada para apps ou no projeto de gerenciamento, seguindo as regras de herança do IAM padrão. Essa prática permite um controle de acesso refinado.
Faturamento: recomendamos que você entenda como o faturamento é associado, principalmente para APIs e serviços que são ativados ou usados automaticamente em aplicativos.
Ativação de API: as principais APIs do Google Cloud centradas em aplicativos são ativadas automaticamente no projeto de gerenciamento.

Para instruções de configuração, consulte Configurar o App Hub com pastas habilitadas para apps.

Projeto host

Um projeto host é um projeto padrão do Google Cloud que pode ser usado para agrupar serviços e cargas de trabalho em aplicativos do App Hub. Os projetos host são um modelo de configuração compatível para usuários atuais do App Hub. No entanto, eles não oferecem suporte a toda a gama de recursos de gerenciamento de aplicativos do Google Cloud centrado em aplicativos e exigem configuração manual para inclusão de recursos.

Limitações:

Vinculação manual de recursos: você precisa anexar manualmente cada projeto de serviço que contém os recursos que você quer agrupar como aplicativos ao projeto host. Os recursos em projetos não vinculados não ficam visíveis para o App Hub.
Conjunto de recursos limitado: os projetos host não são compatíveis com recursos disponíveis em pastas habilitadas para apps, como a integração do Application Design Center e a ativação automática de APIs por um projeto de gerenciamento.
Limite de recursos do projeto: o gerenciamento de aplicativos fica restrito aos limites do projeto host e dos projetos de serviço anexados manualmente, que podem não refletir suas estruturas organizacionais.

Recomendamos que os usuários do projeto host planejem a migração. Para instruções de configuração, consulte Configurar o App Hub com um projeto host.

Planejar a estrutura da hierarquia de recursos

A base para organizar os aplicativos do App Hub é a pasta habilitada para apps ou o projeto host, dependendo do modelo de configuração escolhido. O modelo de dados do App Hub é criado com base na hierarquia de recursosGoogle Cloud padrão, mantendo as mesmas regras hierárquicas e políticas de herança.

É possível combinar os benefícios da hierarquia de recursos Google Cloud com os recursos de aplicativos do App Hub mapeando os limites esperados do aplicativo para a pasta ou projeto host fundamental ativado por app do modelo de configuração. Pense no modelo de dados do App Hub como uma sobreposição na hierarquia de recursos padrão do Google Cloud :

Pastas e projetos são limites:pastas e projetos no Resource Manager agrupam recursos para herança de políticas e organização da mesma forma que pastas ativadas para apps ou projetos host definem os limites administrativos para aplicativos.
Os papéis e as permissões são herdados:os papéis e as permissões do IAM para o App Hub são concedidos no projeto de gerenciamento, na pasta ativada para apps ou no projeto host, seguindo as regras de herança do IAM padrão.
Os metadados são centralizados:o projeto de gerenciamento ou host centraliza os metadados do aplicativo, adicionando uma camada compatível com aplicativos ao gerenciamento de recursos.

Para mais detalhes sobre a organização de recursos, consulte Conceitos de organização de recursos e Configurar uma pasta para gerenciamento de apps.

Considerações sobre a hierarquia de recursos

A escolha entre uma pasta habilitada para apps e um projeto host molda fundamentalmente a maneira como você organiza seus recursos para o App Hub. Como prática recomendada, é essencial planejar com cuidado a hierarquia de recursos do Google Cloud .

Confira abaixo as considerações recomendadas para sua hierarquia de recursos ao escolher o modelo de configuração para gerenciar aplicativos:

Pastas habilitadas para apps:
- Os serviços e as cargas de trabalho precisam estar em projetos na pasta habilitada para apps ou nos descendentes dela para serem registrados em aplicativos do App Hub dentro do limite administrativo da pasta.
- A descoberta automática de serviços e cargas de trabalho opera dentro do limite da pasta específica habilitada para apps e dos projetos descendentes dela.
- Planeje cuidadosamente a estrutura de pastas:
  - Use uma única pasta habilitada para apps para gerenciar aplicativos em vários projetos nela.
  - Crie pastas aninhadas ativadas para apps e delegue o gerenciamento de aplicativos a diferentes equipes ou unidades de negócios, oferecendo um controle mais granular sobre os aplicativos.
Projetos host:
- Todos os recursos precisam estar nos projetos de serviço que você anexa manualmente ao projeto host para que seja possível registrar os recursos nos aplicativos do App Hub.

Consulte Padrões para estruturas de recursos para abordagens organizacionais comuns.

Como ilustrado em Gerenciar aplicativos em uma pasta, ativar o gerenciamento de aplicativos em uma pasta mãe, como F1, permite que aplicativos nessa pasta incluam recursos de projetos diretamente nela, como P10 e P11, bem como de projetos em pastas aninhadas, como P20 e P21 em F2.

Um aplicativo com
projetos P10 e P20, abrangendo níveis de pasta.

Se você ativar o gerenciamento de aplicativos apenas na pasta aninhada F2, os aplicativos nessa pasta só poderão usar recursos de projetos nela, como P20 e P21. Os recursos na pasta mãe F1, como P10 e P11, não estão disponíveis para aplicativos em F2. Para incluir recursos de um projeto na pasta mãe, você precisaria mover esse projeto para F2.

Um aplicativo com
projetos P10 e P20, mas P10 foi movido para a pasta F2.

Padrões para estruturas de recursos

Confira a seguir os padrões recomendados para estruturar pastas e projetos:

Uma única pasta habilitada para apps:comece a configuração em pequenas organizações ou para adoção inicial, consolidando o gerenciamento de aplicativos em um único limite administrativo.
Uma pasta com um app ativado por ambiente:aplique um isolamento forte entre ambientes de desenvolvimento, permitindo políticas diferentes e reduzindo o risco.
Uma pasta ativada para apps por unidade de negócios ou equipe:alinha o gerenciamento à estrutura organizacional e às responsabilidades da equipe, promovendo a autonomia. É possível implementar essa prática estruturando várias pastas separadas ativadas para apps.
Uma estrutura aninhada de pastas ativadas para apps:organize com controle hierárquico em mente, por exemplo, por unidade de negócios, equipe ou ambiente. É possível criar pastas de nível superior para unidades de negócios, com pastas aninhadas para ambientes de desenvolvimento, preparo e produção em cada unidade. Esse padrão usa as estruturas de pastas habilitadas para apps descritas em Considerações sobre a hierarquia de recursos.
Um projeto host por aplicativo ou grupo de aplicativos:organize recursos atuais dos seus projetos padrão, adequados para organizações acostumadas à separação de interesses baseada em projetos ou que já têm aplicativos gerenciados dessa forma.