Configurar o App Design Center

Este documento orienta os administradores na configuração inicial do App Design Center, que ajuda a criar, 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 ajuda a definir o limite do aplicativo e gerenciar o ciclo de vida dele.
  • Um espaço inicial em que sua equipe pode colaborar.
  • Um catálogo padrão para armazenar modelos.
  • Um catálogo gerenciado pelo Google com modelos baseados em práticas recomendadas.
  • Um bucket do Cloud Storage para armazenamento do Terraform. Como alternativa, você pode usar seu próprio bucket.

Antes de começar

Escolher o modelo de configuração

Antes de configurar o App Design Center, escolha um limite de gerenciamentode aplicativos. O limite é 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 um dos seguintes modelos de limite:

Limite de projeto único (pré-lançamento) Limite no nível da pasta
Ajustar Melhor para novos usuários ou pequenas organizações em que todos os recursos residem em um projeto. Melhor para grandes organizações que gerenciam recursos em vários projetos e subpastas.
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, 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é-lançamento): 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é-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 automatizada, que cria seu espaço.

  3. Ative o gerenciamento de aplicativos ao criar um espaço inicial.

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 automatizada, que cria seu espaço.

Papéis do IAM obrigatórios

Os papéis a seguir são necessários para realizar a configuração automatizada, que cria um espaço e garante que as APIs necessárias estejam ativadas.

Projeto único (pré-lançamento)

Você precisa ter um dos seguintes conjuntos de papéis no projeto:

  • Proprietário do projeto (roles/owner): o sistema atribui automaticamente outros papéis necessários.
  • Se você não tiver o papel Proprietário do projeto (roles/owner), será necessário ter o seguinte:
    • Administrador do App Design Center (roles/designcenter.admin)
    • Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin)

Nível da pasta

Você precisa ter os seguintes papéis no projeto de gerenciamento:

  • Administrador do App Design Center (roles/designcenter.admin).
  • Administrador de aplicativos (roles/designcenter.applicationAdmin).

Criar um espaço inicial

Antes de começar a usar o App Design Center, conclua uma configuração inicial automatizada para criar um espaço e um bucket de armazenamento e ativar as seguintes APIs necessárias:

  • App Hub: fornece um registro central para seus aplicativos.

  • Infrastructure Manager: implanta as configurações do Terraform geradas.

  • Cloud Storage: armazena o código e os arquivos de configuração do Terraform gerados.

  • Service Usage: gerencia interações com outros Google Cloud serviços.

Projeto único (pré-lançamento)

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 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 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 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 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 habilitada para apps.

Usar seu próprio bucket de armazenamento

O processo de configuração cria um bucket do Cloud Storage para armazenar detalhes do aplicativo e o Terraform gerado. Como alternativa, você pode usar seu próprio bucket para armazenar informações do aplicativo. Por exemplo, use um bucket atual se as políticas da organização impedirem a criação de novos buckets de armazenamento.

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

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

  2. Verifique se o bucket está no mesmo projeto de gerenciamento em que você planeja criar o espaço.

  3. Verifique se você tem as seguintes permissões no bucket:

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

    Para mais informações, consulte Permissões do IAM para Cloud Storage.

  4. Identifique o nome do bucket.

  5. Crie a chamada de API usando o projects.locations.spaces recurso:

    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.

    Seu espaço é criado, o bucket é usado como local de armazenamento para informações do aplicativo, as APIs necessárias são ativadas e o processo de configuração do App Design Center é concluído.

A seguir