Faça a gestão de catálogos

Quando cria modelos de aplicações e importa modelos de componentes num espaço, os seus modelos podem ser acedidos por outros membros do espaço. Este documento ajuda a partilhar modelos fora do seu espaço publicando-os num catálogo e partilhando esse catálogo com os espaços adequados.

Cada espaço contém um único catálogo onde pode adicionar modelos e controlar a partilha. Pode partilhar um catálogo do espaço que criou na pasta inicial com capacidade para apps para os espaços nas pastas descendentes com capacidade para apps.

Para ver os passos para criar espaços descendentes, consulte o artigo Crie espaços.

Antes de começar

Tem de ter a função de administrador do Application Design Center (roles/designcenter.admin) na pasta com apps ativadas ou no projeto de gestão.

Publique um modelo de aplicação num catálogo

Antes de poder partilhar 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.

    Aceda a Catálogos

  2. Clique em Adicionar modelos.

  3. Na área Adicione modelos ao catálogo predefinido, faça o seguinte:

    1. Para encontrar um modelo específico, escreva o nome do modelo no campo Filtro.
    2. Para adicionar um modelo a este 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 têm acesso aos modelos selecionados.

  5. Para partilhar o catálogo, consulte o artigo Partilhe um catálogo com um espaço.

CLI gcloud

  1. Identifique o ID do catálogo ao qual quer adicionar o modelo.

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

    Substitua o seguinte:

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

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

  2. Identifique o ID do modelo que quer adicionar ao catálogo. Por exemplo, o seguinte comando apresenta uma lista de modelos de aplicações.

    gcloud design-center spaces application-templates list \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--filter=FILTER

    Substitua o seguinte:

    • PROJECT: o ID do seu projeto de gestão.
    • 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 candidatura.

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

    Substitua o seguinte:

    • TEMPLATE: o ID do modelo a confirmar.
    • PROJECT: o ID do seu projeto de gestão.
    • LOCATION: a região do modelo de aplicação.
    • SPACE: o ID do seu espaço.

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

  4. Copie a saída name do comando commit. Especifica este nome como o valor application-template-revision-source quando cria a revisão do modelo do catálogo.

  5. Certifique-se de que o modelo de aplicação ainda não está no catálogo.

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

    Substitua o seguinte:

    • CATALOG: o ID do catálogo. Por exemplo, default-catalog.
    • PROJECT: o ID do seu projeto de gestão.
    • 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 aplicação 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 o seguinte:

    • CATALOG_TEMPLATE: o ID do modelo de catálogo para o modelo de catálogo que quer criar.
    • PROJECT: o ID do seu projeto de gestão.
    • 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 o artigo gcloud design-center spaces catalogs templates create.

  7. Crie uma revisão do modelo de catálogo. Isto cria a primeira revisão, que os programadores usam como origem para uma aplicação.

    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 o seguinte:

    • REVISION: o ID de revisão da revisão que quer criar. Por exemplo, r1.
    • PROJECT: o ID do seu projeto de gestão.
    • 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 candidatura. Copiar este valor quando confirmou o modelo de aplicação. Por exemplo, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

    Para mais informações, consulte o artigo gcloud design-center spaces catalogs templates revisions create.

Partilhe modelos revistos

Se fizer alterações a um modelo, estas não são publicadas automaticamente no catálogo. Para partilhar a revisão mais recente, publique novamente o modelo no catálogo.

Remova modelos de um catálogo

Se já não quiser partilhar 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.

    Aceder a Catálogos

  2. Para gerir os modelos neste 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, introduza o nome do modelo.
    2. Clique em Remover.

CLI 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 o seguinte:

  • CATALOG_TEMPLATE: o ID do modelo de catálogo do modelo que quer remover do catálogo.
  • CATALOG: o ID do catálogo.
  • PROJECT: o ID do seu projeto de gestão.
  • LOCATION: a região do catálogo.
  • SPACE: o ID do seu espaço.

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

Partilhe um catálogo com um espaço

Pode partilhar um catálogo do seu espaço inicial com espaços descendentes. Por exemplo, pode criar um catálogo de modelos de aplicações relevantes para toda a sua organização e partilhá-lo com todos os espaços.

Para ver os passos para criar espaços descendentes, consulte o artigo Crie espaços.

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

Tela de design

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

    Aceda a Catálogos

  2. Clique em Partilhar catálogo.

  3. No campo Filtro, introduza o nome do espaço onde quer partilhar o catálogo.

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

    Os utilizadores podem ver os modelos de um catálogo partilhado abrindo o respetivo espaço no App Design Center e clicando em Modelos partilhados no menu de navegação.

CLI gcloud

Partilhe 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 o seguinte:

  • SHARE: o ID da partilha que quer eliminar.
  • PROJECT: o ID do seu projeto de gestão.
  • SPACE: o ID do seu espaço.
  • LOCATION: a região do catálogo.
  • CATALOG: o ID do catálogo que está a partilhar.
  • DESTINATION_SPACE: o nome do espaço totalmente qualificado para o espaço com o qual está a partilhar. Por exemplo, projects/my-project/locations/us-central1/spaces/my-space.

Para mais informações, consulte o artigo gcloud design-center spaces catalogs shares create.

Pare de partilhar um catálogo com um espaço

Se já não quiser partilhar um catálogo com um espaço, pare de partilhar o catálogo fazendo o seguinte:

Tela de design

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

    Aceda a Catálogos

  2. Clique em Espaços partilhados com.

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

    Ações e selecione Parar partilha.

    1. No campo, introduza o nome do espaço.
    2. Clique em Parar partilha.

CLI gcloud

Pare de partilhar um catálogo com um espaço.

gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG

Substitua o seguinte:

  • SHARE: o ID da partilha que quer eliminar.
  • PROJECT: o ID do seu projeto de gestão.
  • LOCATION: a região do catálogo.
  • SPACE: o ID do seu espaço.
  • CATALOG: o ID do catálogo que está a partilhar.

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

Edite os metadados do catálogo

Para gerir o seu catálogo, pode atribuir-lhe um nome e uma descrição descritivos fazendo o seguinte:

Tela de design

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

    Aceda a Catálogos

  2. Examine os detalhes do catálogo.

  3. Para modificar o Nome a apresentar, faça o seguinte:

    1. Clique em Editar nome a apresentar.
    2. No campo Nome a apresentar, introduza o novo nome.
    3. Clique em Guardar.

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

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

CLI gcloud 

gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME

Substitua o seguinte:

  • CATALOG: o ID do catálogo.
  • PROJECT: o ID do seu projeto de gestão.
  • 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 a apresentar do catálogo.

Para mais informações, consulte o artigo gcloud design-center spaces catalogs update.

O que se segue?