Configurar o App Design Center

Este documento orienta os administradores na configuração inicial do App Design Center, que permite projetar, compartilhar e gerenciar a infraestrutura em nuvem usando um modelo centrado em aplicativos. O processo de configuração define o seguinte:

  • Gerenciamento de aplicativos, que permite definir o limite do seu aplicativo e gerenciar o ciclo de vida dele.
  • Um espaço inicial para sua equipe colaborar.
  • Um catálogo padrão para armazenar modelos.
  • Um catálogo gerenciado pelo Google com modelos baseados em práticas recomendadas.
  • Um dos seguintes buckets do Cloud Storage para armazenamento do Terraform:

Antes de começar

Escolher uma opção de bucket de armazenamento

Quando você cria modelos e aplicativos, o App Design Center armazena o código do Terraform em um bucket do Cloud Storage. Escolha uma das seguintes opções de bucket de armazenamento:

  • Criar um bucket automaticamente: faça a configuração no console.
  • Usar um bucket de armazenamento atual: conclua a configuração usando a API App Design Center.

Você pode usar seu próprio bucket se tiver políticas da organização que impeçam a criação de novos buckets ou se tiver práticas comerciais estabelecidas que determinem a criação de buckets.

Verificar o acesso ao bucket de armazenamento atual

Para concluir a configuração e usar seu próprio bucket, verifique o seguinte:

  1. Você tem acesso para usar APIs. Para mais informações, consulte Configurar o acesso à API.

  2. O bucket está no mesmo projeto de gerenciamento em que você quer configurar o App Design Center.

  3. Você tem as seguintes permissões no bucket:

    • storage.buckets.get
    • storage.objects.create

Escolher o limite de gerenciamento de aplicativos

Um limite de gerenciamento de aplicativos é um local centralizado para tarefas de gerenciamento de aplicativos, incluindo ativação de API, controle de acesso, faturamento e cotas. Dentro do limite, é possível monitorar, resolver problemas, otimizar custos e gerenciar seus recursos do Google Cloud no contexto do aplicativo.

Escolha o modelo de limite adequado para sua organização:

  • Limite de projeto único (Prévia): ideal para novos usuários ou pequenas organizações em que todos os recursos residem em um projeto.
  • Limite no nível da pasta: ideal para grandes organizações que gerenciam recursos em vários projetos e subpastas.

A tabela a seguir compara os recursos de cada modelo de limite:

Recurso Limite de projeto único (prévia) Limite no nível da pasta
Flexibilidade Conclua a configuração usando as configurações padrão.
  • Especifique um nome para o espaço.
  • Selecione se você quer desativar os modelos fornecidos pelo Google.
  • Após a configuração, crie outros espaços em projetos descendentes.
Produtos integrados

Ativar o gerenciamento de aplicativos

Quando você ativa o gerenciamento de aplicativos, o sistema faz uma das seguintes ações para ajudar a gerenciar cotas e faturamento do aplicativo:

  • Projeto único (Prévia): o sistema configura seu projeto como um projeto de gerenciamento.
  • No nível da pasta: o sistema cria um novo projeto de gerenciamento na pasta.

Para ativar o gerenciamento de aplicativos, faça o seguinte:

Projeto único (pré-lançamento)

  1. Verifique se o projeto tem uma conta de faturamento vinculada.

  2. Verifique se você tem os papéis necessários para ativar o gerenciamento de aplicativos e concluir a configuração, que cria seu espaço.

  3. O gerenciamento de aplicativos é ativado automaticamente no seu projeto quando você conclui a configuração usando o console. Como alternativa, para fazer a configuração usando a API App Design Center, ative o gerenciamento de aplicativos no seu projeto.

Nível da pasta

  1. Verifique se você tem um recurso da organização.

  2. Verifique se você tem os papéis necessários para ativar o gerenciamento de aplicativos.

  3. Configure uma pasta para gerenciamento de aplicativos.

  4. Vincule uma conta de faturamento ao projeto de gerenciamento.

  5. Configure o escopo de observabilidade para o projeto de gerenciamento.

  6. Verifique se você tem os papéis necessários para concluir a configuração e criar seu espaço.

Verificar os papéis necessários do IAM

Para fazer a configuração, peça ao administrador para conceder a você os papéis necessários no projeto ou na pasta de limite, conforme listado na tabela a seguir:

Tarefa Funções exigidas
Fazer a configuração inicial de um único projeto Proprietário do projeto (roles/owner) ou ambos os seguintes:
Administrador do App Design Center (roles/designcenter.admin) e
Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin)
Fazer a configuração inicial no nível da pasta Ambos os papéis:
Administrador do App Design Center (roles/designcenter.admin) e
Administrador de aplicativos (roles/designcenter.applicationAdmin)

Para mais informações sobre papéis, consulte Controle de acesso com o IAM.

Configurar o App Design Center e criar um bucket de armazenamento

O processo de configuração no console cria um novo bucket do Cloud Storage para armazenar informações do aplicativo. Para usar um bucket existente, consulte Configurar a Central de design de apps e usar seu próprio bucket de armazenamento.

Projeto único (pré-lançamento)

Para ativar o gerenciamento de aplicativos em um único projeto e configurar a Central de design de apps, faça o seguinte:

  1. Acesse a página Visão geral do App Design Center.

    Ir para Visão geral

  2. No seletor de projetos, selecione o projeto em que você quer configurar o gerenciamento de aplicativos.

  3. Clique em Acessar a configuração.

  4. No painel Configurar seu projeto para gerenciamento de aplicativos, revise a lista de APIs que serão ativadas.

  5. Clique em Ativar. O sistema ativa as APIs e cria o bucket de armazenamento e o espaço default-space.

  6. Para armazenar os recursos do Google Cloud que você implanta com a Central de design de apps, crie projetos padrão na sua organização.

Nível da pasta

Para configurar o App Design Center na sua pasta habilitada para apps, faça o seguinte:

  1. Acesse a página Visão geral do App Design Center.

    Ir para Visão geral

  2. Clique em Selecionar pasta e escolha a pasta ativada para apps.

  3. Clique em Configurar ADC.

  4. No campo Nome do meu espaço, insira um nome para o espaço. Não será possível mudar esse nome depois.

  5. Por padrão, o espaço contém componentes e modelos de aplicativos criados pelo Google. Para remover os componentes e modelos de aplicativos do Google do espaço, desmarque a caixa de seleção Ativar modelos opinativos do Google.

    Se você remover os modelos opinativos do Google, os usuários do espaço só poderão usar os componentes que você importar e os modelos de aplicativos que você criar.

  6. Clique em Concluir configuração. O sistema ativa as APIs e cria o bucket e o espaço de armazenamento.

  7. Para armazenar os recursos Google Cloud que você implanta com a Central de design de aplicativos, crie projetos padrão na pasta ativada para apps.

Configurar a Central de design de aplicativos e usar seu próprio bucket de armazenamento

Ao configurar a Central de design de apps, você pode usar seu próprio bucket do Cloud Storage para armazenar o código do Terraform. Por exemplo, use um bucket existente se as políticas da organização impedirem a criação de novos buckets.

Para configurar o Application Design Center e usar seu próprio bucket do Cloud Storage, use a API App Design Center. Faça o seguinte:

  1. Identifique o nome do bucket.

  2. Crie sua chamada de API usando o recurso projects.locations.spaces. O caminho da solicitação da API tem o formato projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>, em que <var>PROJECT_ID</var> é um dos seguintes:

    • Para um limite de projeto único, use o ID do projeto.
    • Para um limite no nível da pasta, use o ID do projeto de gerenciamento criado durante a configuração do gerenciamento de aplicativos.

    Faça a seguinte configuração na chamada de API:

    1. Especifique o nome do bucket no campo gcs_bucket. Por exemplo, se o URI do bucket for gs://my-bucket, o nome do bucket será my-bucket.

    2. Use o método projects.locations.spaces.create para criar o espaço.

    Executar esse método cria seu espaço, define seu bucket como o local de armazenamento das informações do aplicativo, ativa as APIs necessárias e conclui o processo de configuração.

A seguir