Gestionar catálogos

Cuando creas plantillas de aplicaciones e importas plantillas de componentes en un espacio, otros miembros del espacio pueden acceder a tus plantillas. En este documento se explica cómo compartir plantillas fuera de tu espacio publicándolas en un catálogo y compartiendo ese catálogo con los espacios correspondientes.

Cada espacio contiene un solo catálogo en el que puedes añadir plantillas y controlar el uso compartido. Puedes compartir un catálogo desde el espacio que has creado en la carpeta habilitada para aplicaciones inicial con los espacios de las carpetas habilitadas para aplicaciones descendientes.

Para saber cómo crear espacios derivados, consulta el artículo Crear espacios.

Antes de empezar

Debes tener el rol de administrador de Application Design Center (roles/designcenter.admin) en la carpeta habilitada para la aplicación o en el proyecto de gestión.

Publicar una plantilla de aplicación en un catálogo

Para poder compartir una plantilla con otros espacios, primero debes publicarla en tu catálogo.

Lienzo de diseño

  1. En el menú de navegación, haga clic en Catálogos.

    Ir a Catálogos

  2. Haga clic en Añadir plantillas.

  3. En el área Añadir plantillas al catálogo predeterminado, haga lo siguiente:

    1. Para encontrar una plantilla específica, escriba su nombre en el campo Filtrar.
    2. Para añadir una plantilla a este catálogo, en la columna Acciones, haga clic en Añadir al catálogo.

  4. Haz clic en Listo. Los espacios que tienen acceso al catálogo también tienen acceso a las plantillas seleccionadas.

  5. Para compartir el catálogo, consulta Compartir un catálogo con un espacio.

CLI de gcloud

  1. Identifica el ID del catálogo al que quieras añadir la plantilla.

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

    Haz los cambios siguientes:

    • PROJECT: tu ID de proyecto de gestión.
    • LOCATION: la región del catálogo.
    • SPACE: tu ID de espacio.

    Para obtener más información, consulta gcloud design-center spaces catalogs list.

  2. Identifica el ID de la plantilla que quieras añadir a tu catálogo. Por ejemplo, el siguiente comando muestra las plantillas de aplicaciones.

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

    Haz los cambios siguientes:

    • PROJECT: tu ID de proyecto de gestión.
    • LOCATION: la región del catálogo.
    • SPACE: tu ID de espacio.
    • FILTER: un filtro que te ayuda a acotar los resultados de búsqueda. Por ejemplo, "displayName:my-app-template*"

    Para obtener más información, consulta gcloud design-center spaces application-templates list.

  3. Confirma la plantilla de la aplicación.

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

    Haz los cambios siguientes:

    • TEMPLATE: ID de la plantilla que se va a confirmar.
    • PROJECT: tu ID de proyecto de gestión.
    • LOCATION: la región de la plantilla de la aplicación.
    • SPACE: tu ID de espacio.

    Para obtener más información, consulta gcloud design-center spaces application-templates commit.

  4. Copia el resultado name del comando de confirmación. Especificará este nombre como valor de application-template-revision-source al crear la revisión de la plantilla de catálogo.

  5. Comprueba que la plantilla de aplicación no esté ya en el catálogo.

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

    Haz los cambios siguientes:

    • CATALOG: tu ID de catálogo. Por ejemplo, default-catalog.
    • PROJECT: tu ID de proyecto de gestión.
    • LOCATION: la región del catálogo.
    • SPACE: tu ID de espacio.

    Para obtener más información, consulta la lista de plantillas de catálogos de espacios de gcloud design-center.

  6. Si la plantilla de aplicación no está en el catálogo, créala.

    gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG \
--template-category=TEMPLATE_CATEGORY

    Haz los cambios siguientes:

    • CATALOG_TEMPLATE: el ID de la plantilla de catálogo que quieres crear.
    • PROJECT: tu ID de proyecto de gestión.
    • LOCATION: la región del catálogo.
    • SPACE: tu ID de espacio.
    • CATALOG: tu ID de catálogo.
    • TEMPLATE_CATEGORY: la categoría de la plantilla. Por ejemplo, application-template.

    Para obtener más información, consulta gcloud design-center spaces catalogs templates create.

  7. Crea una revisión de la plantilla de catálogo. De esta forma, se crea la primera revisión, que los desarrolladores usan como fuente de una aplicación.

    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

    Haz los cambios siguientes:

    • REVISION: el ID de revisión de la revisión que quieras crear. Por ejemplo, r1.
    • PROJECT: tu ID de proyecto de gestión.
    • LOCATION: la región del catálogo.
    • SPACE: tu ID de espacio.
    • CATALOG: tu ID de catálogo.
    • CATALOG_TEMPLATE: ID de la plantilla.
    • APPLICATION_TEMPLATE_REVISION_SOURCE: la fuente de revisión de la plantilla de aplicación. Copiaste este valor cuando confirmaste la plantilla de aplicación. Por ejemplo, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

    Para obtener más información, consulta gcloud design-center spaces catalogs templates revisions create.

Compartir plantillas revisadas

Si modificas una plantilla, los cambios no se publicarán automáticamente en el catálogo. Para compartir la última revisión, vuelve a publicar la plantilla en el catálogo.

Quitar plantillas de un catálogo

Si ya no quieres compartir una plantilla específica con un espacio, quítala del catálogo.

Lienzo de diseño

  1. En el menú de navegación, haga clic en Catálogos.

    Ir a Catálogos

  2. Para gestionar las plantillas de este catálogo, haga clic en Plantillas del catálogo.

  3. Para quitar una plantilla, haga clic en Acciones y seleccione Quitar del catálogo.

    1. En el campo, introduce el nombre de la plantilla.
    2. Haz clic en Quitar.

CLI de gcloud

Quita una plantilla de tu catálogo.

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

Haz los cambios siguientes:

  • CATALOG_TEMPLATE: el ID de la plantilla de catálogo que quiere quitar del catálogo.
  • CATALOG: tu ID de catálogo.
  • PROJECT: tu ID de proyecto de gestión.
  • LOCATION: la región del catálogo.
  • SPACE: tu ID de espacio.

Para obtener más información, consulta gcloud design-center spaces catalogs templates delete.

Compartir un catálogo con un espacio

Puedes compartir un catálogo desde tu espacio inicial con los espacios descendientes. Por ejemplo, puedes crear un catálogo de plantillas de aplicaciones que sean relevantes para toda tu organización y compartirlo con todos los espacios.

Para saber cómo crear espacios derivados, consulta el artículo Crear espacios.

Para compartir tu catálogo con un espacio, sigue estos pasos:

Lienzo de diseño

  1. En el menú de navegación, haga clic en Catálogos.

    Ir a Catálogos

  2. Haz clic en Compartir catálogo.

  3. En el campo Filtrar, introduce el nombre del espacio en el que quieras compartir el catálogo.

  4. En la tabla Espacios, en la columna Acciones, haga clic en Compartir catálogo.

    Para ver las plantillas de un catálogo compartido, los usuarios deben abrir su espacio en el Centro de diseño de aplicaciones y hacer clic en Plantillas compartidas en el menú de navegación.

CLI de gcloud

Comparte un catálogo con un espacio.

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

Haz los cambios siguientes:

  • SHARE: el ID del recurso compartido que quieres eliminar.
  • PROJECT: tu ID de proyecto de gestión.
  • SPACE: tu ID de espacio.
  • LOCATION: la región del catálogo.
  • CATALOG: el ID del catálogo que quieres compartir.
  • DESTINATION_SPACE: El nombre completo del espacio con el que vas a compartir el contenido. Por ejemplo, projects/my-project/locations/us-central1/spaces/my-space.

Para obtener más información, consulta gcloud design-center spaces catalogs shares create.

Dejar de compartir un catálogo con un espacio

Si ya no quieres compartir un catálogo con un espacio, deja de compartirlo siguiendo estos pasos:

Lienzo de diseño

  1. En el menú de navegación, haga clic en Catálogos.

    Ir a Catálogos

  2. Haz clic en Espacios compartidos con.

  3. Para dejar de compartir este catálogo con un espacio, haz clic en .

    Acciones y selecciona Dejar de compartir.

    1. En el campo, escribe el nombre del espacio.
    2. Haz clic en Dejar de compartir.

CLI de gcloud

Dejar de compartir un catálogo con un espacio.

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

Haz los cambios siguientes:

  • SHARE: el ID del recurso compartido que quieres eliminar.
  • PROJECT: tu ID de proyecto de gestión.
  • LOCATION: la región del catálogo.
  • SPACE: tu ID de espacio.
  • CATALOG: el ID del catálogo que quieres compartir.

Para obtener más información, consulta gcloud design-center spaces catalogs shares delete.

Editar metadatos de catálogos

Para gestionar tu catálogo, puedes asignarle un nombre y una descripción descriptivos siguiendo estos pasos:

Lienzo de diseño

  1. En el menú de navegación, haga clic en Catálogos.

    Ir a Catálogos

  2. Consulta los detalles del catálogo.

  3. Para modificar el Nombre visible, haz lo siguiente:

    1. Haz clic en Editar nombre visible.
    2. En el campo Nombre visible, introduce el nuevo nombre.
    3. Haz clic en Guardar.

  4. Para modificar la Descripción, siga estos pasos:

    1. Haz clic en Editar descripción.
    2. En el campo Descripción, introduce la nueva descripción.
    3. Haz clic en Guardar.

CLI de gcloud 

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

Haz los cambios siguientes:

  • CATALOG: tu ID de catálogo.
  • PROJECT: tu ID de proyecto de gestión.
  • LOCATION: la región del catálogo.
  • SPACE: tu ID de espacio.
  • DESCRIPTION: la descripción del catálogo.
  • DISPLAY_NAME: el nombre visible del catálogo.

Para obtener más información, consulta gcloud design-center spaces catalogs update.

Siguientes pasos