Saltar a contenido

Orquestando tu automatización

Prerrequisitos

Descripción general

La automatización de orquestación es posible para gestionar la ejecución de tareas de manera automatizada, pudiendo aislar tareas para que se ejecuten de forma secuencial.

BotCity Maestro es una plataforma de automatización utilizada para respaldar el desarrollo de procesos de bots y otros tipos de automatización, implementación y orquestación de procesos en tiempo de ejecución.

Ciclo de vida

El proceso de automatización contiene un ciclo de vida dividido en algunos pasos:

  • Preparación del proceso: el desarrollador debe conocer el flujo de procesamiento.
  • Creación del proyecto: el desarrollador crea el proyecto de automatización, que puede ser en Python, Java, Javascript o Typescript.
  • Desarrollo del robot: el robot se desarrollará en este paso.
  • Implementación y lanzamiento en Maestro: después de que se haya realizado la compilación, el desarrollador enviará el robot a la plataforma y elegirá qué versión se utilizará en producción.
  • Creación del runner: el desarrollador creará el runner.
  • Configuración de BotRunner: el desarrollador establece el machineId en la configuración del SDK.
  • Creación de la automatización: el desarrollador creará la automatización, seleccionando el Runner que se creó y el robot que se implementó.
  • Inicio de BotRunner: el desarrollador iniciará BotRunner desde la terminal.
  • Creación de tarea: el desarrollador o el usuario que se encargará de ejecutar el robot creará una tarea para que BotRunner la ejecute.
  • Ejecución de tarea: BotRunner realizará la tarea.

Creación de un proyecto

Para construir un bot, necesitamos crear un proyecto en Java, Javascript o Python que se utilizará para desarrollar el bot.

Para crear un proyecto, sigue los tutoriales a continuación:

Important

Además de los proyectos de plantilla, también puedes orquestar tus propios proyectos personalizados.

Consulta más detalles sobre orquestar proyectos personalizados.

Info

Para este tutorial, utilizaremos un proyecto de Bot web en Python.

Construcción de tu proyecto

Para enviar el bot a Maestro, debes construir el proyecto. Si estás en Windows, ejecuta el archivo build.bat en el directorio raíz del proyecto, de lo contrario, ejecuta el archivo build.sh en Linux o macOS.

.\build.bat
./build.sh

Tip

Si obtienes un error de permisos, asegúrate de que tu script build.sh tenga permisos de ejecución.

Puedes establecer los permisos con el siguiente comando:

chmod +x build.sh

Proyecto en Java

Para proyectos en Java, carga el archivo .jar generado en la carpeta dist/, si genera dos archivos .jar, carga el archivo con jar-with-dependencies en el nombre de archivo.

Proyecto en Python

Para proyectos en Python, carga el archivo .zip o .tar.gz generado en la carpeta dist/.

Proyecto en Javascript

Para proyectos en Javascript, carga un archivo .zip que contenga los archivos del proyecto, como bot.js, la carpeta resources y package.json.

Implementación fácilitada

Después de construir el proyecto, el siguiente paso es implementar la automatización en BotCity Maestro.

La forma más sencilla de realizar tu primera implementación es a través de la función Implementación fácilitada de Maestro.

El proceso de implementación fácilitada se divide básicamente en tres pasos:

  1. Crear una automatización
  2. Implementar un bot
  3. Elegir dónde ejecutarlo

Primer paso: Crear una automatización

El primer paso es completar el nombre de nuestro proceso de automatización.

Implementación fácilitada

Info

Consulta más detalles sobre la gestión de automatizaciones en esta sección.

Segundo paso: Implementar un bot

El segundo paso es completar la información sobre tu bot.

Deberás cargar el archivo correspondiente al bot, definir qué tecnología se está utilizando y, por último, el nombre y versión que deseas utilizar para la implementación.

IImplementación fácilitada - Paso 2

Advertencia para proyectos heredados

Para automatizaciones en Python, si estás utilizando una plantilla de proyecto heredada, el identificador del bot debe coincidir con el ID definido al crear el proyecto.

Si el nombre generado automáticamente no es el mismo que el ID del proyecto creado, cámbialo para que los identificadores coincidan.

Básicamente, el identificador del bot aparece en el nombre del archivo .tar.gz generado que se está utilizando.

Paso final: Elegir dónde ejecutarlo

El tercer y último paso es definir qué Runner se asociará con esta automatización.

Puedes seleccionar un Runner que hayas creado previamente o ingresar un identificador para crear uno nuevo.

Implementación fácilitada - Paso 3

Important

En el archivo conf.bcf del BotCity Studio SDK, ingresa el ID del Runner que se utilizará.

machineId=vm-01  # <- aquí tu ID de runner
logScreen=true
logApplication=true

Consulta más detalles sobre la configuración del SDK de BotCity Studio.

Info

Consulta más detalles sobre la gestión de Runners en esta sección.

¡Éxito! 🚀

¡Felicitaciones! 🏆

En pocos segundos, has configurado tu proceso de automatización, lo has asociado con tu bot y has definido dónde se ejecutará.

Ahora tienes la opción de crear una nueva tarea para esta automatización.

Al hacerlo, se enfilerá una nueva tarea y tan pronto como el Runner asociado con la automatización esté activo, la ejecución comenzará automáticamente.

Implementación fácilitada - Nueva tarea

En las siguientes secciones, cubriremos con más detalle cómo crear y ejecutar tareas.

Gestión de automatizaciones a través de BotCity Maestro

El proceso de Implementación fácilitada es muy útil para la primera implementación de nuestra automatización.

Sin embargo, en ciertos momentos, es posible que necesitemos implementar nuevas versiones o actualizar versiones existentes de nuestro bot asociado con nuestra automatización.

BotCity Maestro ofrece varias funciones para gestionar nuestras automatizaciones.

Desde el menú Mis bots puedes:

  • Implementar nuevos bots y versiones
  • Establecer versiones como la versión de lanzamiento (versión de producción)
  • Actualizar el código del bot
  • Descargar el código del bot para una versión determinada
  • Excluir un bot.

Bots

Actualizar tu bot

Puedes actualizar un bot simplemente haciendo clic en el icono de lápiz en el lado derecho de la línea asociada con la versión del bot deseada y seleccionando un nuevo archivo para reemplazar el actual.

Icono de actualización del bot

Tip

El archivo seleccionado será una versión actualizada del archivo que se genera en el proceso de build.

Para generar un nuevo archivo, simplemente repite el proceso de construcción después de actualizar el código del bot.

Actualización del bot

Implementar una nueva versión del bot

Puedes implementar un nuevo bot o una nueva versión de un bot existente simplemente haciendo clic en el botón Implementar y completando el formulario con el ID del bot, versión, archivo y tecnología utilizados.

Implementar bot

Definir una versión de lanzamiento

Puedes definir la versión de lanzamiento simplemente haciendo clic en el icono de cinta (resaltado por la flecha roja a continuación). La versión marcada como "lanzamiento" será la versión del bot que se utilizará en el momento de la ejecución.

Lanzamiento del Bot

Info

Consulta más detalles sobre la gestión de Bots en esta sección.

Gestión de tareas

Las tareas son instancias de una Automatización que son creadas por el usuario a través de la Interfaz de Usuario de Maestro, la CLI de BotCity, el SDK de Maestro o la API de Maestro.

Página de creación de tareas

Puedes crear una tarea a través de la página de creación de tareas en Maestro.

Simplemente haz clic en el botón Nueva Tarea que corresponda al proceso de automatización que deseas ejecutar.

Nueva Tarea

Tip

La Automatización creada en el proceso de Implementación fácilitada se mostrará en esta página.

Info

Consulta más detalles sobre la página de Nueva Tarea en esta sección.

Ejecución de tareas

Después de crear una tarea, esta se enviará a la fila y en ese momento estará lista para ser ejecutada.

El último paso necesario es activar el Runner. Simplemente ejecuta el script BotRunner o BotRunner-gui desde el SDK de BotCity Studio.

Finalización de una tarea

Una vez que las tareas son creadas, se encolan en el BotMaestro y se recogen para su ejecución por parte del BotRunner.

Hay dos formas de finalizar una tarea: mediante código (junto con el código del bot) o mediante la CLI.

Es responsabilidad del desarrollador del bot informar al BotMaestro a través del SDK el estado final adecuado de una tarea.

Haz clic aquí para aprender cómo finalizar una tarea utilizando el SDK de Maestro.

Info

Finalizar una tarea es solo una de las posibles integraciones que podemos hacer con BotCity Maestro.

Consulta más detalles sobre las integraciones de BotCity Maestro en esta sección.

Tip

La mayoría de las funcionalidades mencionadas anteriormente también se pueden realizar a través de la Interfaz de Línea de Comandos de BotCity.

Consulta más detalles sobre las líneas de comandos que se pueden utilizar.

Solución de problemas

P: El Runner no ejecuta el robot

  1. Asegúrate de elegir correctamente el runner en la automatización.
  2. Verifica si la configuración del SDK tiene el machineId correcto.
  3. Asegúrate de iniciar el runner.
    • Si tienes el runner con GUI, haz clic en el botón "START" para ejecutar las tareas en la fila.
  4. Abre el archivo log.txt en el directorio raíz del SDK y verifica si hubo algún error.
  5. Asegúrate de que el runner se esté ejecutando en la terminal.
  6. Verifica que el runner tenga acceso a internet.