Locatários e projetos de locatário

Este guia oferece uma visão geral dos locatários do App Lifecycle Manager e de como usá-los para organizar sua oferta de apps.

Locatários e projetos de locatários

Um recurso de locatário do App Lifecycle Manager representa um cliente lógico ou locatário da sua oferta de apps. Ele funciona principalmente como uma ferramenta organizacional que ajuda a agrupar as unidades pertencentes a um locatário específico.

Se a oferta de apps tiver vários locatários, recomendamos provisionar os recursos de cada um deles em um projeto separado Google Cloud Para separar os recursos do locatário em projetos dedicados Google Cloud , você precisa criar pelo menos dois projetos:

  • Projeto do produtor:o projeto em que sua oferta de apps está configurada. Você só precisa de um projeto do produtor para seu aplicativo SaaS.
  • Projetos de locatários: os projetos com recursos do App Lifecycle Manager para um locatário específico. Recomendamos que você crie um projeto para cada locatário.

O uso de projetos separados para cada locatário permite definir configurações (políticas do IAM ou peering de rede, por exemplo) em projetos de locatários e ajuda a acompanhar os custos e gerenciar recursos para cada locatário.

Contas de serviço de atuação em um projeto de locatário

A conta de serviço de atuação precisa de permissões no projeto do locatário para criar e gerenciar os recursos definidos na configuração do Terraform. Recomendamos configurar uma conta de atuação separada para cada locatário.

Para mais informações sobre contas de serviço de atuação e as permissões potencialmente necessárias, consulte Conta de serviço de atuação.

APIs em um projeto de locatário

Quando o App Lifecycle Manager usa o Infrastructure Manager e a conta de serviço de atuação para criar recursos (uma VM, por exemplo) em um projeto de locatário, as APIs necessárias precisam ser ativadas nesse projeto. Caso contrário, o provisionamento falhará.

É necessário ativar as APIs para todos os tipos de recursos que a configuração do Terraform usa em um projeto de locatário.

Usar um tipo de unidade provisório para automatizar a configuração do locatário

Quando você cria projetos manualmente, ativa APIs e configura o IAM para cada novo locatário, o processo é demorado e propenso a erros. É possível automatizar o processo de configuração do locatário usando o App Lifecycle Manager. Para isso, crie um tipo de unidade provisório que contenha uma configuração do Terraform que:

  • Cria um novo Google Cloud projeto para o locatário.
  • Ativa as APIs necessárias nesse novo projeto.
  • Cria uma conta de serviço de atuação dedicada para o locatário provisionado (no projeto do produtor ou no projeto do locatário).
  • Concede as permissões necessárias do IAM às contas de serviço no projeto do locatário.
  • Configura a rede, o registro em log ou outra infraestrutura de linha de base.

O tipo de unidade provisório precisa:

  • Definir variáveis output do Terraform para o tenant_project_id, tenant_project_number e o e-mail actuation_sa que ele cria.
  • Receber tenant_project_id e tenant_project_number como variáveis input.

Configure o tipo de unidade do aplicativo para depender do tipo de unidade provisório e mapeie as variáveis de saída para as variáveis de entrada correspondentes da unidade do aplicativo.

Depois de configurar as dependências do tipo de unidade, o App Lifecycle Manager verifica se a unidade de infraestrutura do locatário subjacente está provisionada (criando um projeto de locatário e configurando as permissões) antes que a unidade que contém o aplicativo seja provisionada.

Consulte Gerenciar dependências entre unidades e usar variáveis para mais detalhes sobre a implementação desse padrão.

A seguir