Como administrador de Automation Pipelines, puede compartir canalizaciones para que los usuarios de una organización puedan ejecutarlas en cualquier otro proyecto o agregarlas como tareas anidadas dentro de una canalización en otro proyecto.

Por qué es útil una canalización compartida

Cuando se comparte una canalización, no es necesario crear la misma canalización para diferentes proyectos dentro de una organización. Además, si se actualiza una canalización compartida, todos los usuarios de la canalización tendrán la misma actualización.

También se puede utilizar una canalización compartida en Automation Service Broker. Un administrador de Automation Service Broker puede agregar la canalización compartida como un elemento del catálogo para que los usuarios la soliciten y la ejecuten en varios proyectos.

Solo los administradores de Automation Pipelines pueden compartir o dejar de compartir canalizaciones.

Cómo compartir una canalización

Para compartir una canalización, haga clic en Canalizaciones y seleccione la canalización que desea compartir.

  1. Haga clic en Acciones > Compartir en todos los proyectos
  2. Si la canalización está desactivada, haga clic en Acciones > Habilitar.
  3. (opcional) Para que la canalización compartida esté disponible en Automation Service Broker, haga clic en Acciones > Publicar.

    Después de publicar la canalización, un administrador de Automation Service Broker puede agregarla a Automation Service Broker. Consulte Agregar canalizaciones al catálogo de Automation Service Broker.

Cómo ejecutar una canalización compartida

Para ejecutar una canalización compartida, seleccione la canalización y seleccione un proyecto.

La canalización se ejecuta en el contexto del proyecto que seleccione y solo se comparte el modelo de canalización. No se comparte ninguna infraestructura, como los endpoints o las variables que se utilizan en la canalización. Si una canalización compartida que utiliza endpoints o variables se ejecuta en un proyecto diferente, dichos endpoints y variables deben estar disponibles en ese proyecto.

Por ejemplo, supongamos que jenkinsPipeline utiliza projectA e incluye una tarea con un endpoint denominado jenkinsEndpoint.

Antes de ejecutar una canalización compartida, compruebe si la canalización incluye el contenido necesario para ejecutarla en un proyecto diferente.

Si comparte jenkinsPipeline y desea ejecutarla en el contexto de projectB, debe haber un jenkinsEndpoint en projectB. Si no existe jenkinsEndpoint, cree el endpoint en projectB antes de ejecutar la canalización compartida.

El siguiente procedimiento muestra cómo duplicar un endpoint en otro proyecto. Se siguen pasos similares para una variable.

  1. Haga clic en Endpoints. En el endpoint que desea duplicar, por ejemplo, jenkinsEndpoint, haga clic en Acciones > Exportar.
  2. Haga clic en el botón Importar y seleccione el archivo YAML para jenkinsEndpoint.
  3. Edite el archivo para cambiar el proyecto, como projectB en el siguiente código YAML de ejemplo.
    ---
project: projectB
kind: ENDPOINT
name: jenkinsEndpoint
...
  4. Haga clic en Importar.

Para ejecutar jenkinsPipeline en projectB, haga clic en Ejecutar en la tarjeta de canalización y seleccione projectB como el proyecto.

Nota: Para ejecutar la canalización compartida en projectB, debe tener la función de administrador, desarrollador o ejecutor de Automation Pipelines. Si es usuario o visor de Automation Pipelines, no puede ejecutar la canalización a menos que un administrador de Automation Pipelines lo convierta en administrador del proyecto o miembro del proyecto projectB. Para obtener más información acerca de las funciones en Automation Pipelines, consulte Cómo se administran las autorizaciones y el acceso de los usuarios en Automation Pipelines.

Cómo agregar una canalización compartida a otra canalización

El uso de canalizaciones compartidas como tareas anidadas dentro de otra canalización permite ampliar la funcionalidad de la canalización más allá de las canalizaciones que se incluyen en un proyecto. Las canalizaciones compartidas pueden estar en proyectos diferentes entre sí y de la canalización en la que se incluyen como tareas anidadas.

El siguiente ejemplo muestra una canalización denominada master-shared-pipeline-demo con dos tareas de canalización anidadas.

Al crear una canalización con canalizaciones compartidas anidadas, seleccione la canalización compartida y, si hay dos canalizaciones con el mismo nombre, utilice el nombre del proyecto para seleccionar la que desee.

Para especificar la canalización de Task0, selecciónela de una lista de canalizaciones compartidas. Cada nombre de canalización incluye el nombre del proyecto. Si varias canalizaciones compartidas tienen el mismo nombre, puede utilizar el nombre del proyecto para seleccionar la que desee.

Nota: Para ejecutar una canalización que incluya canalizaciones anidadas, la canalización debe poder acceder a cualquier endpoint o variable que se utilice en las canalizaciones anidadas. Si no puede, debe crear el contenido en el proyecto para la canalización.

Cómo utilizar una canalización compartida para la reversión

Si desea utilizar una canalización compartida para la reversión, selecciónela en una lista de canalizaciones cuando configure la reversión para la tarea. Automation Pipelines filtra la lista y muestra solo las canalizaciones en el mismo proyecto o las canalizaciones compartidas en diferentes proyectos.

Al agregar una canalización compartida para la reversión, seleccione la canalización compartida y, si hay dos canalizaciones con el mismo nombre, utilice el nombre del proyecto para seleccionar la opción que desee.

Cómo utilizar una plantilla compartida en una canalización

Puede utilizar una plantilla compartida en Automation Assembler como origen de plantilla para una tarea en una canalización. El uso de plantillas compartidas proporciona acceso a más plantillas que las que se incluyen en un proyecto.

Antes de definir la tarea en Automation Pipelines, compruebe que la plantilla se comparte en Automation Assembler y que conoce el nombre y la versión. Cuando se comparte una plantilla, se muestra un icono junto al nombre del proyecto en la lista de plantillas de nube.

Para agregar una plantilla compartida como origen en la canalización, primero compruebe que la plantilla se comparte en Automation Assembler.

Para utilizar una plantilla de Automation Assembler en la canalización compartida:
  • En Tipo de tarea, seleccione Plantilla de Automation.
  • En Acción, seleccione Crear implementación o Actualizar implementación.
  • Si va a actualizar una implementación, seleccione el nombre de la implementación.
  • En Origen de plantilla de nube, seleccione Plantilla de Automation.
  • En Nombre de plantilla de nube, seleccione una opción de la lista de plantillas o escriba un nombre. Si no ve la plantilla en la lista, esto se debe a que la plantilla se encuentra en un proyecto diferente de la canalización, y Automation Pipelines solo muestra las plantillas que se encuentran en el mismo proyecto.
  • En Versión de plantilla de nube, escriba la versión de la plantilla.

En el siguiente ejemplo, shared-bp es la plantilla compartida que comprobó en Automation Assembler y que desea utilizar, pero no aparece como una selección, por lo que debe escribir el nombre.

Cuando defina una tarea con una plantilla compartida, compruebe que la plantilla se comparte en Automation Assembler y, a continuación, introduzca el nombre y la versión en Automation Pipelines.
Nota: Si la plantilla que especifica no está compartida e intenta utilizarla en una canalización de un proyecto diferente, la canalización no se ejecutará y aparecerá un mensaje que indica que la plantilla seleccionada no se compartió.

Cómo eliminar o dejar de compartir una canalización

Si agrega una canalización compartida como una tarea anidada o para revertir una tarea, la canalización en la que se utiliza hace referencia a esa canalización. Si desea eliminar o dejar de compartir la canalización, debe eliminarla de cualquier canalización que haga referencia a ella.

Por ejemplo, si master-shared-pipeline-demo incluye Shared-Pipeline como una tarea anidada, se hace referencia a Shared-Pipeline. No se puede eliminar o dejar de compartir Shared-Pipeline hasta que se quite de master-shared-pipeline-demo.

O si TestRollback utiliza Shared-Pipeline para revertir una tarea, se hace referencia a Shared-Pipeline. No puede eliminar ni dejar de compartir Shared-Pipeline hasta que lo quite de la reversión de la tarea en TestRollback.

El siguiente procedimiento muestra cómo comprobar las referencias de una canalización y eliminarla de la canalización que hace referencia a ella antes de eliminarla o dejar de compartirla.

  1. Compruebe las referencias y actualice las referencias de la canalización si las encuentra.
    1. Haga clic en Canalizaciones. En la canalización compartida que desea comprobar, haga clic en Acciones > Ver referencias.
    2. Anote los nombres de las canalizaciones de referencia.Para quitar una canalización compartida, compruebe si se utiliza como canalización anidada o para que otras canalizaciones la reviertan.
    3. Abra las canalizaciones que hacen referencia a la canalización compartida. Elimine la canalización compartida que se utiliza como tarea anidada o para revertir una tarea, y guarde la canalización.
  2. Eliminar o dejar de compartir una canalización.
    • En la canalización que desea eliminar, haga clic en Acciones > Eliminar.
    • En la canalización que desea dejar de compartir, haga clic en Acciones > Dejar de compartir.