Configurar o App Design Center

Este documento orienta os administradores na configuração inicial do App Design Center, que ajuda a 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 ajuda a 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 bucket do Cloud Storage para armazenamento do Terraform. Se preferir, use seu próprio bucket.

Antes de começar

Escolher seu modelo de configuração

Antes de configurar o App Design Center, escolha um limite de gerenciamento de 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, resolver problemas, otimizar custos e gerenciar seus recursos do Google Cloud no contexto do aplicativo.

Escolha um dos seguintes modelos de limite:

Limite de projeto único (prévia) Limite no nível da pasta
Ajustar Ideal para novos usuários ou pequenas organizações em que todos os recursos estão em um projeto. Ideal 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 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 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. Configurar 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 automática, que cria seu espaço.

Papéis necessários do IAM

As seguintes funções são necessárias para realizar a configuração automatizada a seguir, 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 obrigatórios.
  • Se você não tiver o papel de proprietário do projeto (roles/owner), precisará 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 ative as seguintes APIs obrigatórias:

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

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

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

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

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 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 o App Design Center, 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 o App Design Center, crie projetos padrão na 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, use seu próprio bucket para armazenar informações do aplicativo. Por exemplo, use um bucket existente se as políticas da organização impedirem a criação de novos buckets de armazenamento.

Para configurar a Central de design de apps 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 seu 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 o Cloud Storage.

  4. Identifique o nome do bucket.

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

    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.

    Seu espaço é criado, seu 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