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 de nuvem usando um modelo centrado no aplicativo. 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

Ao criar 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 novo bucket automaticamente: execute 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. Seu 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, solucionar problemas, otimizar custos e gerenciar seus Google Cloud recursos no contexto do aplicativo.

Escolha o modelo de limite que se adapta à 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 seu espaço.
  • Selecione se quer desativar os modelos fornecidos pelo Google.
  • Após a configuração, é possível criar outros espaços no limite de gerenciamento de aplicativos.
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.
  • 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évia)

  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 projeto quando você conclui a configuração usando o console. Como alternativa, para realizar a configuração usando a API App Design Center, ative o gerenciamento de aplicativos no 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 do 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 realizar a configuração, peça ao administrador para conceder os papéis necessários no projeto ou na pasta de limite, conforme listado na tabela a seguir:

Tarefa Funções exigidas
Realizar a configuração inicial de projeto único Proprietário do projeto (roles/owner) ou ambos os seguintes:
Administrador do App Design Center (roles/designcenter.admin) e
Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin)
Realizar a configuração inicial no nível da pasta Ambos os seguintes:
App Design Center Admin (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 novo 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 atual, consulte Configurar o App Design Center e usar seu próprio bucket de armazenamento.

Projeto único (prévia)

Para ativar o gerenciamento de aplicativos em um único projeto e configurar o App Design Center, 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 Google Cloud recursos que você implanta com o App Design Center, crie projetos padrão na sua organização.

Nível da pasta

Para configurar o App Design Center na pasta ativada 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 selecione a sua pasta ativada para apps.

  3. Clique em Configurar o ADC.

  4. No campo Nome do meu espaço, insira um nome para o espaço. Não é possível editar esse nome mais tarde.

  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 importados e os modelos de aplicativos criados.

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

  7. Para armazenar os Google Cloud recursos que você implanta com o App Design Center, crie projetos padrão na sua pasta ativada para apps.

Configurar o App Design Center e usar seu próprio bucket de armazenamento

Ao configurar o App Design Center, você pode usar seu próprio bucket do Cloud Storage para armazenar o código do Terraform. Por exemplo, você pode usar um bucket atual 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 a chamada de API usando o projects.locations.spaces recurso. O caminho da solicitação de API usa 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 boundary, 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.

    Realize 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 projects.locations.spaces.create método para criar o espaço.

    A execução desse método cria o espaço, define o 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