Locatários e projetos de locatário

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

Locatários e projetos de locatário

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

Se a oferta de SaaS tiver vários locatários, recomendamos que você provisione cada um dos recursos do locatário em um projeto do Google Cloud separado. Para separar os recursos do locatário em projetos dedicados do Google Cloud , é necessário criar pelo menos dois projetos:

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

O uso de projetos separados para cada locatário permite definir configurações (políticas do IAM ou peering de rede, por exemplo) nos projetos de locatário e ajuda a acompanhar os custos e gerenciar os recursos de 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 de locatário para criar e gerenciar os recursos definidos na configuração do Terraform. Recomendamos que você configure uma conta de atuação separada para cada um dos seus locatários.

Para mais informações sobre as 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 estar ativadas nesse projeto de locatário. Caso contrário, o provisionamento vai apresentar falha.

É 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

Criar projetos manualmente, ativar APIs e configurar o IAM para cada novo locatário é demorado e sujeito a erros. É possível automatizar o processo de configuração do locatário usando o App Lifecycle Manager criando um tipo de unidade provisória que contém uma configuração do Terraform que:

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

O tipo de unidade provisória precisa:

  • Defina as variáveis do Terraform output para o tenant_project_id, tenant_project_number e o e-mail actuation_sa que ele cria.
  • Receba 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ória 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 de tipo de unidade, o App Lifecycle Manager verifica se a unidade de infraestrutura de locatário subjacente está provisionada (criando um projeto de locatário e configurando as permissões dele) antes que a unidade que contém seu aplicativo seja provisionada.

Consulte Gerenciar dependências entre unidades e usar variáveis para mais detalhes sobre como implementar esse padrão.

A seguir