Administra, publica y comparte catálogos

Los catálogos de Application Design Center te permiten publicar y compartir plantillas de aplicaciones y plantillas de componentes importados en todos los espacios para estandarizar las arquitecturas y evitar duplicar el esfuerzo entre los equipos. Cuando creas o importas plantillas en un espacio, estas solo están disponibles para los miembros de ese espacio de forma predeterminada. Puedes compartir un catálogo entre espacios cuando un equipo de plataforma central mantiene plantillas aprobadas que cumplen con las políticas y que los equipos de desarrollo de otras carpetas o proyectos necesitan implementar. Cada espacio incluye un solo catálogo en el que puedes publicar plantillas, editar metadatos del catálogo y compartirlo con espacios en otros límites de administración de aplicaciones.

Antes de comenzar

Para realizar las tareas de este documento, pídele a tu administrador que te otorgue los roles necesarios en la carpeta habilitada para apps o el proyecto de administración, como se indica en la siguiente tabla:

Tarea Roles obligatorios
Publica plantillas de aplicaciones en un catálogo de espacio Administrador de Application Design Center (roles/designcenter.admin)
Comparte un catálogo con espacios de destino Administrador de Application Design Center (roles/designcenter.admin)

Para obtener más información sobre los roles, consulta Control de acceso con IAM.

Antes de administrar catálogos, haz lo siguiente:

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 el nombre de la plantilla en el campo Filtro.
    2. Para agregar una plantilla a este catálogo, en la columna Acciones, haz clic en Agregar al catálogo.

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

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

gcloud CLI

  1. Identifica el ID del catálogo al que quieres agregar tu plantilla.

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

    Reemplaza lo siguiente:

    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 aplicación.

    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 restringir 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 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 name del comando de confirmación. Especificarás este nombre como el valor de application-template-revision-source cuando crees la revisión de la plantilla de catálogo.

  5. Asegúrate de 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

    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 de 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 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 las plantillas revisadas

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

Quita 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 de 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 \
--force

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

Solo puedes compartir un catálogo con un espacio de destino que esté en la misma región que el espacio de origen, pero ubicado en un límite de administración de aplicaciones diferente.

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 Compartir con, selecciona si el espacio de destino se encuentra en una de las siguientes opciones:

    • Carpeta: Es un límite de administración de aplicaciones a nivel de carpeta.
    • Proyecto: Es un límite de administración de aplicaciones a nivel de proyecto.

  4. En el campo ID del proyecto o de la carpeta, ingresa el ID del proyecto o de la carpeta para el límite de administración de aplicaciones en el que reside el espacio de destino.

    El espacio en la misma región que tu espacio de origen se propaga automáticamente en el campo Nombre del espacio.

  5. Haz clic en Compartir

    Para ver las plantillas de un catálogo compartido, los desarrolladores pueden abrir su espacio en App Design Center 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 recurso compartido que deseas crear.
  • 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 completamente calificado del espacio de destino, como projects/my-dest-project/locations/us-central1/spaces/my-dest-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 con los siguientes 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 recurso 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.

Editar los metadatos del catálogo

Para administrar tu catálogo, puedes asignarle un nombre y una descripción descriptivos. Para ello, sigue 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 descripción nueva.
    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?