Criar modelos compostos

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Os modelos compostos no Application Design Center permitem criar aplicativos complexos conectando modelos de aplicativos padrão reutilizáveis e componentes individuais. Um design modular permite que as equipes desenvolvam componentes em paralelo e atualizem componentes individuais sem reimplantar todo o aplicativo. Também é possível atribuir contas de serviço distintas para restringir as permissões de implantação de cada componente. Além disso, os modelos compostos permitem modelar e empacotar unidades de implantação para uma oferta de SaaS no App Lifecycle Manager.

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 compostos	Administrador do Application Design Center (roles/designcenter.admin) ou Usuário do Application Design Center (roles/designcenter.user)
Publicar ou compartilhar modelos compostos 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.

Para usar seus próprios modelos de aplicativo padrão como elementos básicos, defina variáveis de entrada e saída para estabelecer variáveis configuráveis e crie conexões entre os modelos de aplicativo. Se quiser saber mais, consulte estas referências:

• Modelos de design de aplicativos padrão
• Compartilhar um modelo em um catálogo

Criar um modelo de aplicativo composto

Crie modelos compostos quando quiser projetar e compartilhar aplicativos complexos. É possível adicionar e conectar o seguinte ao design do modelo:

• Modelos de aplicativo padrão: selecione uma das seguintes opções:

  • Modelos criados pelo Google, incorporando Google Cloud práticas recomendadas e configurações de segurança padrão.
  • Modelos que você criou e adicionou ao catálogo do seu espaço.

• Componentes: selecione entre os seguintes recursos do Google Cloud :

  • 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.

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

1. No menu de navegação, clique em Modelos.

   Acessar "Modelos"

2. Na lista Região, selecione o local do modelo. Se você planeja criar uma implantação escalonada no App Lifecycle Manager, selecione global.

3. Na lista Criar modelo, selecione Modelo composto.

4. O campo ID do modelo é preenchido automaticamente. Como alternativa, insira um identificador exclusivo para o modelo. Este campo é obrigatório.

5. 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.

6. No campo Descrição, insira uma breve explicação da finalidade do aplicativo.

7. Clique em Criar modelo. A tela de design é exibida.

CLI da gcloud

Criar um modelo de aplicativo composto.

gcloud design-center spaces application-templates create APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--display-name=DISPLAY_NAME \
--description=DESCRIPTION \
--composition-type=COMPOSITE

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. Se você planeja criar uma implantação escalonada no App Lifecycle Manager, use global.
• 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 composto adicionando e conectando modelos e componentes de aplicativos padrão aos seguintes pontos de partida:

• Uma tela em branco.
• Um modelo fornecido pelo Google.
• Um modelo gerado com a assistência do Gemini.

Enquanto você cria o modelo, o App Design Center gera um código do Terraform para refletir os detalhes de design e configuração.

Para criar seu modelo, faça o seguinte:

Tela de design

1. Na tela de design, selecione Design para ver a tela.

2. Para começar, siga uma destas etapas:

   • Para começar com um modelo fornecido pelo Google, na área Primeiros passos na tela, clique no nome do modelo.

   • Para começar do zero, siga para a próxima etapa.

3. Para adicionar um modelo de aplicativo padrão à tela, faça o seguinte:

   1. Na área Componentes, clique em Modelos de incorporação.

   2. Para adicionar um modelo, clique em um deles em uma das seguintes listas:

      • Modelos: modelos de aplicativos padrão que estão no catálogo do seu espaço ou que foram compartilhados com ele.
      • Modelos do Google: modelos de aplicativos padrão criados pelo Google e adicionados ao catálogo do Google.

   3. Para adicionar o modelo selecionado à tela, clique em Selecionar.

4. Para criar um novo modelo de aplicativo padrão, clique em Criar um novo modelo. A página Criar novo modelo é aberta.

   Para mais informações, consulte Projetar modelos de aplicativos padrão.

5. Para adicionar um componente à tela, clique em um componente na área Componentes.

6. Para criar um canal de comunicação entre modelos e componentes, siga um destes procedimentos:

   • Arraste de um ponto azul em um elemento para um ponto azul em outro.

   • Para adicionar um componente conectado a um componente atual, clique em Adicionar e selecione o componente que você quer adicionar.

   Para detalhes sobre a conexão, consulte a documentação de configuração de cada recurso compatível.

7. Para remover um elemento básico ou uma conexão, faça o seguinte:

   1. Na tela, clique no elemento básico ou na conexão.

   2. Na área Configuração, clique em Excluir.

   3. No campo, digite delete.

   4. Clique em Excluir.

CLI da gcloud

1. Identifique os URIs de revisão de modelo para os elementos básicos no catálogo do seu espaço.

   gcloud design-center spaces shared-templates list \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Substitua:

   • 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 shared-templates list.

2. Identifique os URIs de revisão de modelo para os elementos básicos do catálogo do Google que você quer adicionar ao modelo.

   gcloud design-center spaces shared-templates list \
   --google-catalog \
   --location=us-central1
   

   Para mais informações, consulte gcloud design-center spaces shared-templates list.

3. Adicione um modelo ou componente de aplicativo padrão ao seu modelo composto.

   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_URI
   

   Substitua:

   • COMPONENT: o ID do modelo ou componente de aplicativo padrã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 composto em que você está adicionando o modelo ou componente de aplicativo padrão.
   • SHARED_TEMPLATE_URI: o URI do modelo de aplicativo padrão ou do modelo compartilhado de 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.

4. Adicione um segundo modelo ou componente de aplicativo padrão ao seu 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_2
   

   Substitua:

   • COMPONENT_2: o ID do segundo modelo ou componente de aplicativo padrã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 composto em que você está adicionando o modelo ou componente de aplicativo padrão.
   • SHARED_TEMPLATE_URI_2: o segundo modelo de aplicativo padrão ou URI de modelo compartilhado de 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.

5. Criar uma conexão entre os modelos ou componentes de aplicativos padrão.

   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_2
   

   Substitua:

   • 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 ou do modelo de aplicativo padrão de origem.
   • COMPONENT_2: o ID do componente ou do modelo de aplicativo padrão de destino.

   Para mais informações, consulte gcloud design-center spaces application-templates components connections create.

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

1. Na tela de design, clique em um componente.

2. 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.

3. 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.

4. 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.

   1. Na tela de design, clique na conexão entre dois componentes. O painel Conexão é aberto e mostra os parâmetros de conexão.

   2. 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.

   3. 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.

5. Clique em Salvar.

CLI da gcloud

1. 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_TEMPLATE
   

   Substitua:

   • 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.

2. 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"
         }
     ]
   

3. 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_TEMPLATE
   

   Substitua:

   • 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.

4. 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=SPACE
   

   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.

   Para mais informações, consulte gcloud design-center spaces application-templates components connections describe.

5. 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.

Configurar modelos de aplicativos padrão

Quando os desenvolvedores implantam o modelo composto como um aplicativo, um aplicativo é criado para cada um dos seguintes itens:

• Cada grupo de modelos de aplicativo padrão.
• Cada grupo de componentes.

É possível fornecer valores padrão para cada grupo. Por exemplo, é possível incluir o projeto de implantação, a região e os proprietários. Quando os desenvolvedores implantam o aplicativo no App Design Center, eles podem usar os valores padrão ou especificar os próprios detalhes para cada aplicativo.

Para fornecer detalhes padrão do aplicativo para cada grupo, faça o seguinte:

Tela de design

1. Na tela de design, clique em um modelo de aplicativo padrão.

   O painel Modelo incorporado é aberto.

2. Na área Configuração, insira os detalhes do aplicativo.

   Para mais informações, consulte Criar um rascunho de aplicativo.

CLI da gcloud

Para mais informações, consulte Criar seu modelo.

Verificar o modelo

Antes de compartilhar o modelo composto com os desenvolvedores, implante e verifique o modelo no App Design Center. Essa etapa ajuda a verificar a funcionalidade antes de uma implantação escalonada em várias máquinas.

Para verificar o modelo, faça o seguinte:

1. Na tela de design, clique em Continuar e selecione Criar aplicativo para implantar.

   O painel Criar um aplicativo é aberto.

2. Na área Detalhes do aplicativo composto, insira os detalhes do aplicativo.

   Para mais informações, consulte Criar um rascunho de aplicativo.

3. Clique em Próxima.

4. Para cada componente adicionado ao modelo composto, um aplicativo será criado quando você implantar. Configure cada aplicativo e clique em Next.

   Para mais informações, consulte Criar um rascunho de aplicativo.

5. Teste o aplicativo implantado para garantir que ele atenda aos seus requisitos.

6. Para evitar custos recorrentes, exclua a implantação de teste.

Criar uma implantação escalonada

Para implantar e gerenciar várias instâncias do modelo composto, use o App Lifecycle Manager.

1. Verifique seu modelo no App Design Center.

2. Na tela de design, clique em Continuar e selecione Implantar em grande escala com o App Lifecycle Manager.

   A página Unidades do App Lifecycle Manager é aberta.

3. Para ver as etapas de implantação, consulte Implantar uma oferta de SaaS.

Compartilhar seu modelo

Para disponibilizar seu modelo para desenvolvedores, adicione-o a um catálogo e compartilhe. Quando você adiciona um modelo a um catálogo, ele fica disponível como uma fonte de aplicativo nos espaços em que o catálogo é compartilhado.

Para compartilhar o modelo, faça o seguinte:

1. Na tela de design, clique em Adicionar ao catálogo.

2. 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:

1. No menu de navegação, clique em Modelos.

   Acessar "Modelos"

2. Selecione o modelo de aplicativo que você quer revisar. A tela será aberta.

3. Modifique o modelo para atender aos novos requisitos. Por exemplo, adicione e configure um novo componente.

4. 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

1. Na tela de design, clique em Ações.
2. 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

• Implante seu modelo composto com o App Lifecycle Manager implantando uma oferta de SaaS.
• 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.