Quando você cria modelos de aplicativos e importa modelos de componentes em um espaço, outros membros do espaço podem acessar seus modelos. Este documento ajuda você a compartilhar modelos fora do seu espaço publicando-os em um catálogo e compartilhando esse catálogo com os espaços apropriados.
Cada espaço contém um único catálogo em que é possível adicionar modelos e controlar o compartilhamento. Você pode compartilhar um catálogo do espaço que criou no limite inicial de gerenciamento de aplicativos com espaços em outros limites de gerenciamento de aplicativos.
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 ativada para apps ou no projeto de gerenciamento, conforme listado na tabela a seguir:
| Tarefa | Funções exigidas |
|---|---|
| Publicar modelos de aplicativos em um catálogo de espaço | Administrador do App Design Center (roles/designcenter.admin) |
| Compartilhar um catálogo com espaços de destino | Administrador do App Design Center (roles/designcenter.admin) |
Para mais informações sobre papéis, consulte Controle de acesso com o IAM.
Faça o seguinte antes de gerenciar catálogos:
- Conclua a configuração inicial do App Design Center.
- Para criar espaços além do espaço inicial, consulte Gerenciar espaços.
Publicar um modelo de aplicativo em um catálogo
Antes de compartilhar um modelo com outros espaços, publique-o no catálogo.
Tela de design
No menu de navegação, clique em Catálogos.
Clique em Adicionar modelos.
Na área Adicionar modelos ao catálogo padrão, faça o seguinte:
- Para encontrar um modelo específico, digite o nome dele no campo Filtrar.
- Para adicionar um modelo a esse catálogo, na coluna Ações, clique em Adicionar ao catálogo.
Clique em Concluído. Os espaços que têm acesso ao catálogo também têm acesso aos modelos selecionados.
Para compartilhar o catálogo, consulte Compartilhar um catálogo com um espaço.
CLI gcloud
Identifique o ID do catálogo em que você quer adicionar o modelo.
gcloud design-center spaces catalogs list \ --project=PROJECT \ --location=LOCATION \ --space=SPACESubstitua:
PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.
Para mais informações, consulte gcloud design-center spaces catalogs list.
Identifique o ID do modelo que você quer adicionar ao catálogo. Por exemplo, o comando a seguir lista modelos de aplicativos.
gcloud design-center spaces application-templates list \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --filter=FILTERSubstitua:
PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.FILTER: um filtro para ajudar a restringir os resultados da pesquisa. Por exemplo,"displayName:my-app-template*"
Para mais informações, consulte gcloud design-center spaces application-templates list.
Confirme o modelo de aplicativo.
gcloud design-center spaces application-templates commit TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACESubstitua:
TEMPLATE: o ID do modelo a ser confirmado.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 commit.
Copie a saída
namedo comando de confirmação. Você vai especificar esse nome como o valorapplication-template-revision-sourceao criar a revisão do modelo de catálogo.Verifique se o modelo de aplicativo ainda não está no catálogo.
gcloud design-center spaces catalogs templates list \ --catalog=CATALOG \ --project=PROJECT \ --location=LOCATION \ --space=SPACESubstitua:
CATALOG: o ID do catálogo. Por exemplo,default-catalog.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.
Para mais informações, consulte gcloud design-center spaces catalogs templates list.
Se o modelo de aplicativo não estiver no catálogo, crie o modelo de catálogo.
gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --catalog=CATALOG \ --template-category=TEMPLATE_CATEGORYSubstitua:
CATALOG_TEMPLATE: o ID do modelo de catálogo que você quer criar.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.CATALOG: o ID do catálogo.TEMPLATE_CATEGORY: a categoria do modelo. Por exemplo,application-template.
Para mais informações, consulte gcloud design-center spaces catalogs templates create.
Crie uma revisão do modelo de catálogo. Isso cria a primeira revisão, que os desenvolvedores usam como origem de um aplicativo.
gcloud design-center spaces catalogs templates revisions create REVISION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --catalog=CATALOG \ --template=CATALOG_TEMPLATE \ --application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCESubstitua:
REVISION: o ID da revisão que você quer criar. Por exemplo,r1.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.CATALOG: o ID do catálogo.CATALOG_TEMPLATE: o ID do modelo.APPLICATION_TEMPLATE_REVISION_SOURCE: a origem da revisão do modelo de aplicativo. Você copiou esse valor ao confirmar o modelo de aplicativo. Por exemplo,projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.
Para mais informações, consulte gcloud design-center spaces catalogs templates revisions create.
Compartilhar modelos revisados
Se você fizer mudanças em um modelo, elas não serão publicadas automaticamente no catálogo. Para compartilhar a revisão mais recente, publique o modelo no catálogo novamente.
Remover modelos de um catálogo
Se você não quiser mais compartilhar um modelo específico com um espaço, remova-o do catálogo.
Tela de design
No menu de navegação, clique em Catálogos.
Para gerenciar os modelos nesse catálogo, clique em Modelos no catálogo.
Para remover um modelo, clique em Ações e selecione Remover do catálogo.
- No campo, insira o nome do modelo.
- Clique em Remover.
CLI gcloud
Remova um modelo do catálogo.
gcloud design-center spaces catalogs templates delete CATALOG_TEMPLATE \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
Substitua:
CATALOG_TEMPLATE: o ID do modelo de catálogo que você quer remover do catálogo.CATALOG: o ID do catálogo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.
Para mais informações, consulte gcloud design-center spaces catalogs templates delete.
Compartilhar um catálogo com um espaço
Só é possível compartilhar um catálogo com um espaço de destino que esteja na mesma região do espaço de origem, mas localizado em um limite de gerenciamento de aplicativos diferente.
Para compartilhar o catálogo com um espaço, faça o seguinte:
Tela de design
No menu de navegação, clique em Catálogos.
Clique em Compartilhar catálogo.
No campo Compartilhar com, selecione se o espaço de destino está em um dos seguintes:
- Pasta: um limite de gerenciamento de aplicativos no nível da pasta.
- Projeto: um limite de gerenciamento de aplicativos para envolvidos no projeto.
No campo ID do projeto/pasta, insira o ID do projeto ou da pasta do limite de gerenciamento de aplicativos em que o espaço de destino reside.
O espaço na mesma região do espaço de origem é preenchido automaticamente no campo Nome do espaço.
Clique em Compartilhar.
Os desenvolvedores podem conferir os modelos de um catálogo compartilhado abrindo o espaço no App Design Center e clicando em Modelos compartilhados no menu de navegação.
CLI gcloud
Compartilhe um catálogo com um espaço.
gcloud design-center spaces catalogs shares create SHARE \
--project=PROJECT \
--space=SPACE \
--location=LOCATION \
--catalog=CATALOG \
--destination-space=DESTINATION_SPACE
Substitua:
SHARE: o ID do compartilhamento que você quer excluir.PROJECT: o ID do projeto de gerenciamento.SPACE: o ID do espaço.LOCATION: a região do catálogo.CATALOG: o ID do catálogo que você está compartilhando.DESTINATION_SPACE: o nome totalmente qualificado do espaço com que você está compartilhando. Por exemplo,projects/my-project/locations/us-central1/spaces/my-space.
Para mais informações, consulte gcloud design-center spaces catalogs shares create.
Parar de compartilhar um catálogo com um espaço
Se você não quiser mais compartilhar um catálogo com um espaço, pare de compartilhar o catálogo fazendo o seguinte:
Tela de design
No menu de navegação, clique em Catálogos.
Clique em Espaços compartilhados com.
Para parar de compartilhar esse catálogo com um espaço, clique em
Ações e selecione Parar de compartilhar.
- No campo, insira o nome do espaço.
- Clique em Parar de compartilhar.
CLI gcloud
Parar de compartilhar um catálogo com um espaço.
gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG
Substitua:
SHARE: o ID do compartilhamento que você quer excluir.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.CATALOG: o ID do catálogo que você está compartilhando.
Para mais informações, consulte gcloud design-center spaces catalogs shares delete.
Editar metadados do catálogo
Para gerenciar o catálogo, você pode dar a ele um nome e uma descrição descritivos fazendo o seguinte:
Tela de design
No menu de navegação, clique em Catálogos.
Analise os detalhes do catálogo.
Para modificar o Nome de exibição, faça o seguinte:
- Clique em Editar nome de exibição.
- No campo Nome de exibição, insira o novo nome.
- Clique em Salvar.
Para modificar a Descrição, faça o seguinte:
- Clique em Editar descrição.
- No campo Descrição, insira a nova descrição.
- Clique em Salvar.
CLI gcloud
gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME
Substitua:
CATALOG: o ID do catálogo.PROJECT: o ID do projeto de gerenciamento.LOCATION: a região do catálogo.SPACE: o ID do espaço.DESCRIPTION: a descrição do catálogo.DISPLAY_NAME: o nome de exibição do catálogo.
Para mais informações, consulte gcloud design-center spaces catalogs update.
A seguir
- Defina suas próprias configurações criando modelos de aplicativos.
- Aprenda a atualizar, escalonar e excluir seus recursos gerenciando aplicativos.
- Use seus próprios módulos do Terraform nos designs de modelos importando componentes.