Orquestando tu automatización¶

Prerrequisitos¶

• Cuenta de BotCity (Regístrate aquí)
• BotCity Studio SDK
• Python 3.7 o superior
• Java 11 o superior

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:

• Proyecto en Python

  • Bot web
  • Bot desktop

• Proyecto en Java

  • Bot web
  • Bot desktop

• Proyecto en Javascript

  • Bot web
  • Bot desktop

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

chmod +x build.sh

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/actualizar una automatización
2. Implementar un bot
3. Elegir dónde ejecutarlo

Para crear una automatización desde cero, seleccione la opción: Crear nueva automatización

Primer paso: Crear una automatización¶

El primer paso es completar cierta información sobre el proceso de automatización que se está creando.

Segundo paso: Implementar un bot¶

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

En este paso, cargará el archivo relacionado con el robot y definirá la versión, el identificador y qué tecnología se está utilizando.

Paso final: Elegir dónde ejecutarlo¶

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

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

¡É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 tiene la opción de crear una nueva tarea o programación 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.

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.

A través de Easy Deploy también podemos actualizar automatizaciones que ya existen en la plataforma.

Luego de seleccionar una automatización existente, podrás editar el robot y también los Runners vinculados a este proceso.

Actualizar tu bot¶

En la pantalla que contiene la información del robot, puedes actualizar la versión actual que se está utilizando o cargar una nueva versión.

Simplemente cargue el archivo del robot e ingrese la versión correspondiente.

Si mantiene la misma versión que ya estaba en uso, este nuevo archivo sobrescribirá el archivo utilizado anteriormente.

Actualizando Runners¶

En esta etapa podrás editar los Runners que están vinculados al proceso de automatizació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.

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.

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.