Puede ejecutar una canalización desde la tarjeta de canalización, en el modo de edición de canalización, y desde la ejecución de la canalización. También puede utilizar los activadores disponibles para que Code Stream ejecute una canalización cuando se produzcan determinados eventos.

Cuando todas las etapas y las tareas de la canalización son válidas, la canalización está lista para publicarse, ejecutarse o activarse.

Para ejecutar o activar la canalización con Code Stream, puede habilitarla y ejecutarla desde la tarjeta de canalización o mientras se encuentra en la canalización. A continuación, puede ver la ejecución de la canalización para confirmar que la canalización haya compilado, probado e implementado el código.

Cuando la ejecución de una canalización está en curso, puede eliminarla si es un administrador o un usuario que no es administrador.

  • Administrador: para eliminar la ejecución de una canalización cuando se está ejecutando, haga clic en Ejecuciones. En la ejecución que desea eliminar, haga clic en Acciones > Eliminar.
  • Usuario no administrador: para eliminar la ejecución de una canalización en ejecución, haga clic en Ejecuciones y, a continuación, en Alt Shift d.

Cuando la ejecución de una canalización está en curso y parece estar bloqueada, un administrador puede actualizarla desde la página Ejecuciones o la página de detalles de la ejecución.

  • Página Ejecuciones: haga clic en Ejecuciones. En la ejecución que desea actualizar, haga clic en Acciones > Sincronizar.
  • Página de detalles de la ejecución: haga clic en Ejecuciones, haga clic en el vínculo a los detalles de la ejecución y, a continuación, en Acciones > Sincronizar.

Para ejecutar una canalización cuando se produzcan eventos específicos, utilice los activadores.

  • El activador de Git puede ejecutar una canalización cuando los desarrolladores actualicen el código.
  • El activador de Gerrit puede ejecutar una canalización cuando se produzcan las revisiones de código.
  • El activador de Docker puede ejecutar una canalización cuando se crea un artefacto en un registro de Docker.
  • Los comandos curl o wget pueden hacer que Jenkins ejecute una canalización después de que finalice una compilación de Jenkins.

Para obtener más información sobre cómo usar activadores, consulte Activar canalizaciones en Code Stream.

El siguiente procedimiento muestra cómo ejecutar una canalización desde la tarjeta de canalización, ver las ejecuciones, consultar los detalles de la ejecución y usar las acciones. También muestra cómo publicar una canalización para poder agregarla a vRealize Automation Service Broker.

Requisitos previos

Procedimiento

  1. Habilite su canalización.
    Para ejecutar o publicar una canalización, primero debe habilitarla.
    1. Haga clic en Canalizaciones.
    2. En la tarjeta de canalización, haga clic en Acciones > Habilitar.
      En el menú Acciones de la tarjeta de canalización, debe habilitar la canalización antes de poder ejecutarla.

      También puede habilitar la canalización mientras se encuentra en la canalización. Si ya se habilitó la canalización, la opción Ejecutar se muestra activa y el menú Acciones indica Deshabilitar.

  2. (opcional) Publique la canalización.
    Si desea que la canalización esté disponible como un elemento del catálogo en vRealize Automation Service Broker, debe publicarla en Code Stream.
    1. Haga clic en Canalizaciones.
    2. En la tarjeta de canalización, haga clic en Acciones > Publicar.
      También puede publicar la canalización mientras se encuentra en ella.
      En el menú Acciones de la configuración del modelo de canalización, puede liberar la canalización.

      Después de publicar la canalización, abra Service Broker para agregarla como un elemento del catálogo y ejecutarla. Consulte Cómo agregar canalizaciones de Code Stream al catálogo de Service Broker en Usar y administrar Service Broker.

      Nota: Si la canalización requiere más de 120 minutos para ejecutarla, proporcione una hora de ejecución aproximada como un valor de tiempo de espera de solicitud. Para establecer o revisar el tiempo de espera de solicitud de un proyecto, abra Service Broker como administrador y seleccione Infraestructura > Proyectos. Haga clic en el nombre del proyecto y, a continuación, en Aprovisionar.

      Si no se establece el valor de tiempo de espera de la solicitud, una ejecución que requiera más de 120 minutos para ejecutarse mostrará errores del tipo de solicitud de tiempo de espera para la devolución de llamada. Sin embargo, esto no afectará a la ejecución de la canalización.

  3. En la tarjeta de canalización, haga clic en Ejecutar.
  4. Para ver la canalización mientras se ejecuta, haga clic en Ejecuciones.
    La canalización ejecuta cada etapa en secuencia y la ejecución de la canalización muestra un icono de estado para cada etapa. Si la canalización incluye una tarea de operación de usuario, el usuario debe aprobar la tarea para que la canalización continúe ejecutándose. Cuando se utiliza una tarea de operación de usuario, la canalización deja de ejecutarse y espera a que el usuario requerido apruebe la tarea.
    Por ejemplo, puede utilizar la tarea operación de usuario para aprobar la implementación de código en un entorno de producción.
    Si la tarea de operación de usuario tiene un tiempo de espera de caducidad establecido en días, horas o minutos, el usuario requerido debe aprobar la canalización antes de que caduque la tarea. De lo contrario, se produce un error en la canalización según lo esperado.
    Una canalización que se ejecutó y está a la espera de aprobación muestra el estado de espera junto a Etapas.
  5. Para ver la etapa de la canalización a la espera de la aprobación del usuario, haga clic en el icono de estado de la etapa.
    La etapa de canalización que está a la espera de aprobación muestra las tareas en la etapa.
  6. Para ver los detalles de la tarea, haga clic en la tarea.
    Una vez que el usuario requerido apruebe la tarea, un usuario que tenga la función adecuada debe reanudar la canalización. Para conocer las funciones requeridas, consulte Cómo se administran las autorizaciones y el acceso de los usuarios en Code Stream.
    Si se produce un error en la ejecución, debe clasificar y solucionar la causa del error. A continuación, vaya a la ejecución y haga clic en Acciones > Volver a ejecutar.
    Puede reanudar las ejecuciones de la canalización principal y las ejecuciones anidadas.
    Una tarea de canalización que está a la espera de aprobación muestra un vínculo que abre la tarea.
  7. Desde la ejecución de la canalización, puede hacer clic en Acciones para ver la canalización y seleccionar una acción, como Pausar o Cancelar, entre otras. Cuando la ejecución de una canalización está en curso, si es un administrador, puede eliminar o sincronizar esta ejecución. Si es un usuario no administrador, puede eliminar una canalización que está en ejecución.
  8. Para desplazarse fácilmente entre ejecuciones y ver los detalles de una tarea, haga clic en Ejecuciones y, a continuación, en una ejecución de canalización. Luego, haga clic en la pestaña de la parte superior y seleccione la ejecución de canalización.
    Para examinar una ejecución de canalización específica, haga clic en uno de los números de ejecución de canalización en la parte superior.

Resultados

Enhorabuena. Ejecutó una canalización, examinó la ejecución de la canalización y vio una tarea de operación de usuario que requirió aprobación para que la canalización continúe ejecutándose. También utilizó el menú Acciones en la ejecución de la canalización para regresar al modelo de canalización y realizar los cambios necesarios.

Qué hacer a continuación

Para obtener más información sobre cómo usar Code Stream para automatizar el ciclo de lanzamiento de software, consulte Tutoriales para usar Code Stream.