Gerenciar catálogos

Quando você cria modelos de aplicativos e importa modelos de componentes em um espaço, outros membros 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 adequados.

Cada espaço tem um único catálogo em que é possível adicionar modelos e controlar o compartilhamento. É possível compartilhar um catálogo do espaço criado na pasta inicial ativada para apps com os espaços nas pastas descendentes ativadas para apps.

Para saber como criar espaços descendentes, consulte Criar espaços.

Antes de começar

É necessário ter a função de administrador da central de design de aplicativos (roles/designcenter.admin) na pasta ativada para apps ou no projeto de gerenciamento.

Publicar um modelo de aplicativo em um catálogo

Antes de compartilhar um modelo com outros espaços, publique-o no seu catálogo.

Tela de design

  1. No menu de navegação, clique em Catálogos.

    Acessar "Catálogos"

  2. Clique em Adicionar modelos.

  3. Na área Adicionar modelos ao catálogo padrão, faça o seguinte:

    1. Para encontrar um modelo específico, digite o nome dele no campo Filtro.
    2. Para adicionar um modelo a esse catálogo, na coluna Ações, clique em Adicionar ao catálogo.

  4. Clique em Concluído. Os espaços que têm acesso ao catálogo também têm acesso aos modelos selecionados.

  5. Para compartilhar o catálogo, consulte Compartilhar um catálogo com um espaço.

CLI da gcloud

  1. Identifique o ID do catálogo em que você quer adicionar o modelo.

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

    Substitua:

    • PROJECT: o ID do projeto de gerenciamento.
    • LOCATION: a região do catálogo.
    • SPACE: o ID do seu espaço.

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

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

    Substitua:

    • PROJECT: o ID do projeto de gerenciamento.
    • LOCATION: a região do catálogo.
    • SPACE: o ID do seu 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.

  3. Confirme o modelo de aplicativo.

     gcloud design-center spaces application-templates commit TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE

    Substitua:

    • 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 seu espaço.

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

  4. Copie a saída name do comando de commit. Você vai especificar esse nome como o valor application-template-revision-source ao criar a revisão do modelo de catálogo.

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

    Substitua:

    • 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 seu espaço.

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

  6. 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_CATEGORY

    Substitua:

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

  7. Crie uma revisão do modelo de catálogo. Isso cria a primeira revisão, que os desenvolvedores usam como fonte para 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_SOURCE

    Substitua:

    • 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 seu 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 não quiser mais compartilhar um modelo específico com um espaço, remova-o do catálogo.

Tela de design

  1. No menu de navegação, clique em Catálogos.

    Acessar "Catálogos"

  2. Para gerenciar os modelos nesse catálogo, clique em Modelos no catálogo.

  3. Para remover um modelo, clique em Ações e selecione Remover do catálogo.

    1. No campo, insira o nome do modelo.
    2. Clique em Remover.

CLI da gcloud

Remova um modelo do seu 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 seu espaço.

Para mais informações, consulte gcloud design-center spaces catalogs templates delete.

Compartilhar um catálogo com um espaço

É possível compartilhar um catálogo do seu espaço inicial com espaços descendentes. Por exemplo, você pode criar um catálogo de modelos de aplicativos relevantes para toda a organização e compartilhar com todos os espaços.

Para saber como criar espaços descendentes, consulte Criar espaços.

Para compartilhar seu catálogo com um espaço, faça o seguinte:

Tela de design

  1. No menu de navegação, clique em Catálogos.

    Acessar "Catálogos"

  2. Clique em Compartilhar catálogo.

  3. No campo Filtro, insira o nome do espaço em que você quer compartilhar o catálogo.

  4. Na tabela Espaços, na coluna Ações, clique em Compartilhar catálogo.

    Os usuários podem abrir o espaço no App Design Center e clicar em Modelos compartilhados no menu de navegação para ver os modelos de um catálogo compartilhado.

CLI da 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 seu 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

  1. No menu de navegação, clique em Catálogos.

    Acessar "Catálogos"

  2. Clique em Espaços compartilhados com.

  3. Para parar de compartilhar este catálogo com um espaço, clique em

    Ações e selecione Parar de compartilhar.

    1. No campo, digite o nome do espaço.
    2. Clique em Parar de compartilhar.

CLI da 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 seu 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 seu catálogo, dê a ele um nome e uma descrição descritivos fazendo o seguinte:

Tela de design

  1. No menu de navegação, clique em Catálogos.

    Acessar "Catálogos"

  2. Analise os detalhes do catálogo.

  3. Para modificar o Nome de exibição, faça o seguinte:

    1. Clique em Editar nome de exibição.
    2. No campo Nome de exibição, insira o novo nome.
    3. Clique em Salvar.

  4. Para modificar a Descrição, faça o seguinte:

    1. Clique em Editar descrição.
    2. No campo Descrição, insira a nova descrição.
    3. Clique em Salvar.

CLI da 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 seu 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