Administra catálogos

Cuando creas plantillas de aplicaciones y plantillas de componentes de importación 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 adecuados.

Cada espacio contiene un solo catálogo en el que puedes agregar plantillas y controlar el uso compartido. Puedes compartir un catálogo desde el espacio que creaste en tu carpeta inicial habilitada para apps con los espacios de las carpetas secundarias habilitadas para apps.

Para conocer los pasos para crear espacios secundarios, consulta Crea espacios.

Antes de comenzar

Debes tener el rol de administrador del Centro de diseño de aplicaciones (roles/designcenter.admin) en la carpeta habilitada para la app o en el proyecto de administración.

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

Antes de compartir una plantilla con otros espacios, publícala en tu catálogo.

Lienzo de diseño

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

    Ir a Catálogos

  2. Haz clic en Agregar plantillas.

  3. En el área Agregar plantillas al catálogo predeterminado, haz lo siguiente:

    1. Para encontrar una plantilla específica, escribe su nombre en el campo Filtro.
    2. Para agregar una plantilla a este catálogo, haz clic en Agregar al catálogo en la columna Acciones.

  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 Cómo compartir un catálogo con un espacio.

gcloud CLI

  1. Identifica el ID del catálogo en el que deseas agregar tu plantilla.

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

    Reemplaza lo siguiente:

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

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

  2. Identifica el ID de la plantilla que deseas agregar a tu catálogo. Por ejemplo, el siguiente comando enumera las plantillas de aplicaciones.

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

    Reemplaza lo siguiente:

    • PROJECT: Es el ID de tu proyecto de administración.
    • LOCATION: Es la región del catálogo.
    • SPACE: Es el ID de tu espacio.
    • FILTER: Es un filtro que te ayuda a reducir los resultados de la 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

    Reemplaza lo siguiente:

    • TEMPLATE: Es el ID de la plantilla que se confirmará.
    • PROJECT: Es el ID de tu proyecto de administración.
    • LOCATION: Es la región de la plantilla de la aplicación.
    • SPACE: Es el ID de tu espacio.

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

  4. Copia el resultado de name del comando commit. Especificarás este nombre como el valor de application-template-revision-source cuando crees la revisión de la plantilla de tu catálogo.

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

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

    Reemplaza lo siguiente:

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

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

  6. Si la plantilla de aplicación no está en el catálogo, crea la plantilla del catálogo.

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

    Reemplaza lo siguiente:

    • CATALOG_TEMPLATE: Es el ID de la plantilla de catálogo que deseas crear.
    • PROJECT: Es el ID de tu proyecto de administración.
    • LOCATION: Es la región del catálogo.
    • SPACE: Es el ID de tu espacio.
    • CATALOG: Es el ID de tu catálogo.
    • TEMPLATE_CATEGORY: Es 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 del catálogo. Esto crea la primera revisión, que los desarrolladores usan como fuente para 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

    Reemplaza lo siguiente:

    • REVISION: Es el ID de la revisión que deseas crear. Por ejemplo, r1
    • PROJECT: Es el ID de tu proyecto de administración.
    • LOCATION: Es la región del catálogo.
    • SPACE: Es el ID de tu espacio.
    • CATALOG: Es el ID de tu catálogo.
    • CATALOG_TEMPLATE: Es el ID de la plantilla.
    • APPLICATION_TEMPLATE_REVISION_SOURCE: Es la fuente de revisión de la plantilla de la aplicación. Copiaste este valor cuando confirmaste la plantilla de tu 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.

Comparte plantillas revisadas

Si realizas cambios en una plantilla, estos no se publicarán automáticamente en el catálogo. Para compartir la revisión más reciente, vuelve a publicar la plantilla en el catálogo.

Cómo 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, haz clic en Catálogos.

    Ir a Catálogos

  2. Para administrar las plantillas en este catálogo, haz clic en Plantillas en el catálogo.

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

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

gcloud CLI

Quita una plantilla de tu catálogo.

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

Reemplaza lo siguiente:

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

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

Cómo compartir un catálogo con un espacio

Puedes compartir un catálogo desde tu espacio inicial a 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 conocer los pasos para crear espacios secundarios, consulta Crea espacios.

Para compartir tu catálogo con un espacio, haz lo siguiente:

Lienzo de diseño

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

    Ir a Catálogos

  2. Haz clic en Compartir catálogo.

  3. En el campo Filtro, ingresa el nombre del espacio en el que deseas compartir el catálogo.

  4. En la tabla Espacios, en la columna Acciones, haz 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 apps y hacer clic en Plantillas compartidas en el menú de navegación.

gcloud CLI

Compartir 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

Reemplaza lo siguiente:

  • SHARE: Es el ID del uso compartido que deseas borrar.
  • PROJECT: Es el ID de tu proyecto de administración.
  • SPACE: Es el ID de tu espacio.
  • LOCATION: Es la región del catálogo.
  • CATALOG: Es el ID del catálogo que compartes.
  • DESTINATION_SPACE: Es el nombre de espacio completamente calificado del espacio al que compartes 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.

Cómo 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, haz 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, ingresa el nombre del espacio.
    2. Haz clic en Dejar de compartir.

gcloud CLI

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

Reemplaza lo siguiente:

  • SHARE: Es el ID del uso compartido que deseas borrar.
  • PROJECT: Es el ID de tu proyecto de administración.
  • LOCATION: Es la región del catálogo.
  • SPACE: Es el ID de tu espacio.
  • CATALOG: Es el ID del catálogo que compartes.

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

Edita los metadatos del catálogo

Para administrar 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, haz clic en Catálogos.

    Ir a Catálogos

  2. Examina 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, ingresa el nombre nuevo.
    3. Haz clic en Guardar.

  4. Para modificar la Descripción, haz lo siguiente:

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

gcloud CLI 

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

Reemplaza lo siguiente:

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

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

¿Qué sigue?