Integración de STELA con Jenkins

Documento STELA Jenkins Pipeline script #

Haz clic aquí para visualizar el archivo: STELA JENKINS PIPELINE SCRIPT

Para poder utilizar el Jenkins Pipeline se deben actualizar las variables que se encuentran al inicio del script.

Variables globales de configuración al ambiente #

• Def STELA server = Nombre del servidor STELA donde está publicada la API CI/CD
• Def token = Token del proyecto STELA
• Def id_Automation = Id de la automatización, carpeta o Escenario a ejecutar

Obtener ID y Token #

ID de Automatización, Carpeta o Escenario: Este identificador único se asigna a cada automatización, carpeta o escenario, facilitando su identificación y gestión.

Token del Proyecto: Obtén este token desde el Panel de Administración. El token permite la ejecución de automatizaciones en STELA sin la necesidad de introducir credenciales de usuario y contraseña. Recuerda que la seguridad es primordial. Maneja el token con especial atención, asegurando la integridad y confidencialidad de la información asociada.

Para conocer cómo obtener estos datos seguir los pasos de la siguiente URL: https://www.stela.ai/wiki/obtencion-de-id-y-token-para-ejecutar-stela-desde-un-pipeline-ci-cd/

Instalación de http request plugin #

En kenkins es necesario tener instalado el http request plugin

Pasos:

En Jenkins seleccionar «Administrar Jenkins» del menú de la derecha:

Dentro de «Configuraciones del sistema» o «System Configuration» y seleccionar «Plugins» como se muestra en la imagen:

Dentro de la sección «Complementos instalados» o «Installed plugins» buscar dentro de la lista o ingresarlo directamente en el buscador:

Continuar con la instalación y revisar que una vez instalado esté activado con el botón señalado:

Pasos para utilizar Jenkins #

Ingresar a Jenkins:

Hacer clic en «Nueva Tarea«:

Aquí se presentan diversas opciones:

Es posible crear una carpeta para almacenar las tareas. Para ello se debe hacer clic en la opción «Folder«.

Es necesario ingresar un nombre al proyecto de jenkins y hacer clic en el botón «OK«:

Solicitará un nombre para la carpeta recientemente creada y de manera opcional permite ingresar una descripción. Una vez finalizado hacer clic en «Save«.

A continuación crearemos una nueva tarea haciendo clic en «Create a job«:

Nuevamente regresará al mismo menú con diversas opciones:

Pipeline #

1. Elegir «Pipeline» como el tipo de tarea y hacer clic en el botón «OK«.

2. De manera opcional en las configuraciones generales permite ingresar una «Descripción«.

3. Dirigirse a “Pipeline«.

4. Ingresar Script.

5. Hacer clic en el botón «Guardar«.

6. Hacer clic en «Construir ahora«. De esta manera se iniciará manualmente la ejecución de una tarea o pipeline en ese momento específico.

7.  Se puede observar el historial de tareas con el resultado de la ejecución:

• Se mostrará con el símbolo  cuando se haya ejecutado correctamente.
• Se mostrará con el símbolo cuando hayan ocurrido errores.

Al hacer clic sobre el build se puede observar el detalle de lo ocurrido.