Os modelos de aplicativos padrão no Application Design Center permitem definir uma arquitetura preferencial e controlar os recursos e as configurações que as equipes de desenvolvimento usam nas implantações. É possível compartilhar um modelo padrão com membros do seu espaço, publicar o modelo em um catálogo para outros espaços ou incorporá-lo a um modelo composto maior. Quando os desenvolvedores criam um aplicativo com base em um modelo padrão, eles podem configurar cada componente sem adicionar ou remover componentes. Cada modelo gera um código do Terraform que os desenvolvedores podem baixar ou implantar diretamente do App Design Center.
Antes de começar
Para realizar as tarefas neste documento, peça ao administrador para conceder a você os papéis necessários na pasta habilitada para apps ou no projeto de gerenciamento, conforme listado na tabela a seguir:
| Tarefa | Funções exigidas |
|---|---|
| Criar, projetar e editar modelos de aplicativos padrão | Administrador do Application Design Center (roles/designcenter.admin) ouUsuário do Application Design Center ( roles/designcenter.user) |
| Publicar ou compartilhar modelos padrão em um catálogo | Administrador do Application Design Center (roles/designcenter.admin) |
Para mais informações sobre papéis, consulte Controle de acesso com o IAM.
Criar um modelo de aplicativo padrão
Crie modelos de aplicativos padrão para compartilhar seu design de arquitetura com as equipes de desenvolvimento. É possível adicionar os seguintes componentes ao design do modelo:
Recursos: recursos de alto nível que ajudam a controlar outros recursos, como contas de serviço.
Serviços: interfaces de rede ou API consumidas pela rede, como o Cloud Storage e a Vertex AI.
Cargas de trabalho: implantações binárias que executam funções de negócios, como o Cloud Run e o Compute Engine.
Você pode selecionar entre os seguintes componentes:
- Componentes projetados pelo Google, incorporando as práticas recomendadas do Google Cloud e as configurações de segurança padrão.
- Seus próprios componentes que você importa, com base nos seus próprios módulos do Terraform.
Conforme você projeta o modelo, o App Design Center gera o código do Terraform para refletir os detalhes de design e configuração.
Especificar detalhes do modelo
Os detalhes do modelo ajudam a categorizá-lo e ajudam os desenvolvedores a decidir se devem usá-lo.
Para inserir detalhes do modelo, faça o seguinte:
Tela de design
No menu de navegação, clique em Modelos.
Clique em Criar modelo.
O campo ID do modelo é preenchido automaticamente. Como alternativa, insira um identificador exclusivo para o modelo. Este campo é obrigatório.
No campo Nome do modelo, insira um identificador legível por humanos para exibir no console do Google Cloud .
Se você não fornecer um nome, o ID do modelo será copiado para esse campo.
No campo Descrição, insira uma breve explicação da finalidade do aplicativo.
Clique em Criar modelo. A tela de design é exibida.
CLI da gcloud
Criar um novo modelo de aplicativo.
gcloud design-center spaces application-templates create APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--display-name=DISPLAY_NAME \
--description=DESCRIPTION
Substitua:
APPLICATION_TEMPLATE: o ID do modelo de aplicativo que você quer criar.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.DISPLAY_NAME: um nome para exibição no console do Google Cloud .DESCRIPTION: uma breve descrição.
Para mais informações, consulte gcloud design-center spaces application-templates create.
Criar o modelo
Crie seu modelo adicionando e conectando componentes. O exemplo a seguir inclui três componentes conectados na tela de design.
Para criar seu modelo, adicione componentes aos seguintes pontos de partida:
- Uma tela em branco.
- Um modelo fornecido pelo Google.
- Um modelo gerado com a assistência do Gemini.
Para ajudar os desenvolvedores a configurar um aplicativo com base no seu modelo, designe variáveis de entrada e saída específicas. As variáveis ajudam a definir o seguinte:
Entradas específicas que os desenvolvedores precisam fornecer ao criar um aplicativo com base no seu modelo. Por exemplo, é possível fornecer valores de variáveis distintos para cada ambiente ao implantar um aplicativo em ambientes de desenvolvimento, produção e teste. Essas variáveis são expostas automaticamente nos arquivos
variables.tfeoutputs.tfdo Terraform gerados.Conexões entre dois modelos de aplicativo padrão incorporados a um modelo composto. Por exemplo, para criar uma conexão em um modelo composto, um modelo de banco de dados pode gerar uma variável de nome de banco de dados que é usada como entrada para um modelo de lógica de aplicativo.
Para criar seu modelo, faça o seguinte:
Tela de design
Na tela de design, selecione Design para ver a tela.
Para começar, siga uma destas etapas:
Para começar do zero, na área Componentes, clique em um componente para adicioná-lo à área de tela.
Para começar com um modelo fornecido pelo Google, na área Primeiros passos na tela, clique no nome do modelo.
Para usar o chat em linguagem natural para gerar um modelo, clique em Aplicativo personalizado com o Gemini.
Para criar um canal de comunicação entre componentes, siga um destes procedimentos:
Para conectar dois componentes na tela, arraste de um ponto azul em um componente para um ponto azul em outro componente.
Para adicionar a um componente, clique em Adicionar e selecione o componente.
Para detalhes sobre a conexão, consulte a documentação de configuração de cada recurso compatível.
Para remover um componente ou uma conexão, faça o seguinte:
Na tela, clique no componente ou na conexão.
Na área Configuração, clique em Excluir.
No campo, digite delete.
Clique em Excluir.
Para especificar variáveis de entrada e saída para o modelo, faça o seguinte:
Clique em Detalhes do modelo.
No painel Detalhes do modelo, clique na guia Variáveis.
Na área Editar variável, faça o seguinte.
Na lista Componente, selecione o componente que é a base da sua variável.
Na lista Tipo de variável, selecione uma das seguintes opções:
Saída: o componente gera um valor que pode ser necessário para uma conexão. Por exemplo, um serviço do Cloud Run pode gerar um endereço IP.
Entrada: o componente requer entrada do desenvolvedor ou de outro modelo de aplicativo padrão. Por exemplo, um modelo de tratamento de dados pode exigir um nome de banco de dados de um modelo de repositório de dados.
Para criar outra variável, clique em Adicionar variável e repita as etapas.
CLI da gcloud
Identifique os URIs de revisão de modelo para os componentes do catálogo do Google que você quer adicionar ao modelo.
gcloud design-center spaces shared-templates list \ --google-catalog \ --location=us-central1Para mais informações, consulte gcloud design-center spaces shared-templates list.
Adicione um componente ao modelo de aplicativo.
gcloud design-center spaces application-templates components create COMPONENT \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --application-template=APPLICATION_TEMPLATE \ --shared-template-revision-uri=SHARED_TEMPLATE_URISubstitua:
COMPONENT: o ID do componente que você quer adicionar ao modelo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.APPLICATION_TEMPLATE: o ID do modelo de aplicativo em que você está adicionando o componente.SHARED_TEMPLATE_URI: o URI do modelo compartilhado do componente. Por exemplo,projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1.
Para mais informações, consulte gcloud design-center spaces application-templates components create.
Adicione um segundo componente ao modelo.
gcloud design-center spaces application-templates components create COMPONENT_2 \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --application-template=APPLICATION_TEMPLATE \ --shared-template-revision-uri=SHARED_TEMPLATE_URI_2Substitua:
COMPONENT_2: o ID do segundo componente que você quer adicionar ao modelo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.APPLICATION_TEMPLATE: o ID do modelo de aplicativo em que você está adicionando o componente.SHARED_TEMPLATE_URI_2: o URI do modelo compartilhado do segundo componente. Por exemplo,projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1.
Para mais informações, consulte gcloud design-center spaces application-templates components create.
Crie uma conexão entre os dois componentes.
gcloud design-center spaces application-templates components connections create CONNECTION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --application-template=APPLICATION_TEMPLATE \ --component=COMPONENT \ --destination-component-uri=COMPONENT_2Substitua:
CONNECTION: o ID da conexão que você quer adicionar ao modelo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.APPLICATION_TEMPLATE: o ID do modelo de aplicativo em que você está adicionando a conexão.COMPONENT: o ID do componente de origem.COMPONENT_2: o ID do componente de destino.
Para mais informações, consulte gcloud design-center spaces application-templates components connections create.
Adicione variáveis de entrada e saída para exigir a entrada do desenvolvedor ou para se conectar a outros componentes em modelos compostos.
gcloud design-center spaces application-templates update APPLICATION_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --add-root-input-variables=componentUri=COMPONENT_URI,variable=VARIABLE \ --add-root-output-variables=componentUri=COMPONENT_URI,variable=VARIABLESubstitua:
APPLICATION_TEMPLATE: o ID do modelo de aplicativo em que você está adicionando variáveis.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.COMPONENT_URI: o URI do componente que é a base da variável.VARIABLE: a variável de componente que você quer inserir ou gerar. Por exemplo, um componente de banco de dados pode ter uma variáveldatabase_nameque você quer que seja gerada ou que exija entrada dos desenvolvedores.
Para mais informações, consulte gcloud design-center spaces application-templates update.
Configurar valores padrão para componentes
Para cada componente adicionado a um modelo, é possível especificar detalhes de configuração padrão, como o projeto do recurso e o local de implantação. O Application Design Center aplica esses padrões quando um aplicativo é criado com base nesse modelo.
Os desenvolvedores de aplicativos também podem modificar os detalhes da conexão se a configuração padrão não atender aos requisitos. Por exemplo, é possível modificar nomes de chaves variável de ambiente, alterar portas de conexão ou adicionar outros papéis a contas de serviço ao criar um aplicativo.
Antes de implantar um aplicativo, os desenvolvedores podem visualizar e modificar os valores padrão que você configurou no modelo. Os desenvolvedores precisam configurar os detalhes necessários para cada recurso compatível.
Para configurar componentes e conexões, faça o seguinte:
Tela de design
Na tela de design, clique em um componente.
Na área Configuração, na lista ID do projeto, selecione o projeto em que você quer implantar o recurso. Selecione um projeto com as seguintes qualificações:
O projeto precisa estar dentro da pasta habilitada para apps selecionada.
O projeto não pode ser um projeto de gerenciamento.
Defina outras configurações para o recurso. Por exemplo, para o Cloud SQL, é possível configurar o seguinte:
- Região
- Configuração de backup
- Flags de banco de dados
- Configuração de IP
Para links para a documentação de configuração de cada componente, consulte Recursos compatíveis.
Quando você conecta componentes na tela de design, os valores de configuração padrão são usados para criar a conexão. Para adicionar ou modificar detalhes da conexão, faça o seguinte.
Na tela de design, clique na conexão entre dois componentes. O painel Conexão é aberto e mostra os parâmetros de conexão.
Escolha uma destas opções:
Para modificar um parâmetro de conexão, clique em Editar.
Para adicionar um novo parâmetro de conexão, clique em Adicionar parâmetro.
Atualize os campos Chave e Valor. Por exemplo, talvez você queira modificar os seguintes detalhes:
- Os nomes das chaves variável de ambiente para se alinhar aos requisitos do aplicativo.
- O valor da porta de conexão.
- Os papéis adicionados a uma conta de serviço.
Clique em Salvar.
CLI da gcloud
Descreva cada componente no modelo de aplicativo para ver os parâmetros do componente.
gcloud design-center spaces application-templates components describe COMPONENT \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --application-template=APPLICATION_TEMPLATESubstitua:
COMPONENT: o ID do componente que você quer descrever.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.APPLICATION_TEMPLATE: o ID do modelo de aplicativo.
Para mais informações, consulte gcloud design-center spaces application-templates components describe.
Para cada componente que você quer modificar, crie um arquivo JSON no diretório inicial que contenha os valores de parâmetro.
Por exemplo, é possível criar o seguinte arquivo para um componente do Cloud Run:
[ { "key": "service_name", "value": "frontend-service" }, { "key": "project_id", "value": "DEPLOYMENT_PROJECT" } ]Atualize cada componente no modelo de aplicativo para configurar os parâmetros necessários.
gcloud design-center spaces application-templates components update COMPONENT \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --parameters=PARAMETERS_FILE_PATH \ --application-template=APPLICATION_TEMPLATESubstitua:
COMPONENT: o ID do componente que você quer atualizar.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.PARAMETERS_FILE_PATH: um arquivo JSON que inclui parâmetros de componente.APPLICATION_TEMPLATE: o ID do modelo de aplicativo.
Para mais informações, consulte gcloud design-center spaces application-templates components update.
Descreva as conexões dos componentes.
gcloud design-center spaces application-templates components connections describe CONNECTION \ --component=COMPONENT \ --application-template=APPLICATION_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACESubstitua:
CONNECTION: o ID da conexão.COMPONENT: o ID do componente.APPLICATION_TEMPLATE: o ID do modelo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.
Para mais informações, consulte gcloud design-center spaces application-templates components connections describe.
Editar os parâmetros de conexão do componente.
gcloud design-center spaces application-templates components connections update CONNECTION \ --component=COMPONENT \ --application-template=APPLICATION_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --source-component-parameters='[{"key": "SOURCE_KEY", "value": "SOURCE_VALUE"}]'Substitua:
CONNECTION: o ID da conexão.COMPONENT: o ID do componente.APPLICATION_TEMPLATE: o ID do modelo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.SOURCE_KEY: a nova chave de parâmetro.SOURCE_VALUE: o novo valor de parâmetro.
Para mais informações, consulte gcloud design-center spaces application-templates components connections update.
Verificar a conformidade com frameworks de segurança
É possível aplicar um conjunto consistente de políticas a qualquer aplicativo implantado com base em um modelo para aplicar requisitos de segurança específicos da sua organização antes da implantação. A execução de avaliações na fase de design do modelo é opcional, mas é altamente recomendável resolver as configurações incorretas com antecedência, porque as avaliações são aplicadas durante a fase de pré-implantação do aplicativo.
Se você tiver o nível Standard do Security Command Center, seus modelos serão validados de acordo com o framework Google Cloud Security Essentials. Se você tiver o nível Premium ou Enterprise, poderá criar outros frameworks e anexá-los diretamente ao modelo de aplicativo em um limite de nível de pasta ou de projeto único.
Para mais informações sobre como anexar frameworks de segurança ao modelo, consulte Aplicar políticas de segurança.
Editar código do Terraform
Conforme você projeta o modelo do aplicativo, o App Design Center gera um código do Terraform para refletir os detalhes de design e configuração. É possível editar o Terraform para especificar detalhes de configuração do componente.
O sistema gera os seguintes arquivos do Terraform:
main.tf: código de infraestrutura que inclui um módulo para cada componente no modelo.outputs.tf: expõe informações sobre os componentes de infraestrutura implantados.variables.tf: declara o nome, o tipo e a descrição das variáveis usadas no arquivomain.tf.input.tfvars: define valores para variáveis usadas no arquivomain.tf.providers.tf: define rótulos que ajudam o Terraform a interagir com APIs e recursos do Google Cloud .
Para mais informações, consulte Visão geral do Terraform no Google Cloud.
Para editar o código do Terraform, faça o seguinte:
Na tela de design, clique em Código. O sistema exibe os arquivos do Terraform gerados.
Clique em main.tf. O sistema exibe o módulo do Terraform para cada componente.
Editar detalhes da configuração. Para mais informações, consulte a documentação de configuração de cada recurso compatível.
O sistema valida automaticamente as edições e exibe erros se elas forem inválidas.
Para destacar e comparar suas edições, faça o seguinte:
Clique em Ver diferença.
Para reverter uma mudança, clique em Clique para reverter a mudança na margem.
Clique em Ver diferenças para fechar a visualização de comparação.
Para salvar as mudanças, clique em Salvar mudanças no código.
Para verificar as mudanças, faça o seguinte.
- Clique em Design.
- Clique em um componente e revise os detalhes de configuração.
Verificar o modelo
Antes de compartilhar o modelo com os desenvolvedores, verifique se ele funciona como pretendido. Para verificar o modelo, faça o seguinte:
- Crie um aplicativo com
as seguintes configurações:
- Na lista Ambiente, selecione TESTE.
- Na lista Gravidade, selecione BAIXA.
- Implante o aplicativo.
- Teste sua infraestrutura para garantir que ela atenda aos seus requisitos.
- Para evitar custos recorrentes, exclua a implantação de teste.
Compartilhar um modelo em um catálogo
Depois de verificar o modelo, você pode publicá-lo em um catálogo. O modelo pode ser usado por desenvolvedores de aplicativos que têm acesso a um espaço em que o catálogo é compartilhado.
- Na tela de design, clique em Adicionar ao catálogo.
- Para gerenciar os espaços em que o catálogo é compartilhado, consulte Gerenciar catálogos.
Revisar e compartilhar novamente o modelo
À medida que você ganha experiência com o aplicativo e as necessidades da sua empresa evoluem, talvez seja necessário atualizar o modelo. Por exemplo, é possível melhorar o desempenho de um serviço de back-end adicionando um serviço do Memorystore para armazenamento em cache.
Ao modificar um modelo, você cria uma revisão dele. Para aplicar as mudanças aos aplicativos, os desenvolvedores precisam implantar os aplicativos usando a revisão.
O App Design Center não publica automaticamente revisões de modelos em catálogos. Para compartilhar a revisão mais recente, publique o modelo no catálogo novamente.
Para criar uma nova revisão, faça o seguinte:
No menu de navegação, clique em Modelos.
Selecione o modelo de aplicativo que você quer revisar. A tela será aberta.
Modifique o modelo para atender aos novos requisitos. Por exemplo, adicione e configure um novo componente.
Para compartilhar a revisão mais recente com outros espaços, adicione o modelo ao seu catálogo novamente.
Excluir um modelo
Se você não precisar mais de um modelo, poderá excluí-lo.
Tela de design
- Na tela de design, clique em Ações.
- Clique em Excluir.
CLI da gcloud
Excluir um modelo de aplicativo.
```sh
gcloud design-center spaces application-templates delete APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
```
Substitua:
APPLICATION_TEMPLATE: o ID do modelo de aplicativo que você quer excluir.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do modelo de aplicativo.SPACE: o ID do espaço.
Para mais informações, consulte gcloud design-center spaces application-templates delete.
A seguir
- Compartilhe seus modelos com outros espaços gerenciando catálogos de modelos.
- Use seus próprios módulos do Terraform nos designs de modelo importando componentes.
- Saiba como atualizar, escalonar e excluir seus recursos gerenciando aplicativos.