Configuración del Runner¶
Como vimos anteriormente, BotCity Runner es responsable de solicitar tareas a BotCity Maestro y ejecutarlas en un ambiente de ejecución.
La configuración de un nuevo Runner se puede dividir básicamente en dos pasos:
- Creación de un Runner en BotCity Maestro (ver más detalles aquí).
- Configuración del Runner en el ambiente de ejecución.
En las siguientes secciones, veremos más detalles sobre la instalación y configuración de un Runner en el ambiente de ejecución.
Configuración de un Runner en el ambiente de ejecución¶
BotCity Runner es parte del SDK de BotCity Studio. Para utilizar las herramientas correctamente, consulta la documentación sobre la instalación del SDK de BotCity Studio.
En la carpeta donde se instaló el SDK, abre el archivo wizard-X.Y.Z, donde X.Y.Z es la versión del Wizard.
Desde esta pantalla, podemos seleccionar la opción Configurar BotCity Runner.
En este paso, proporcionaremos nuestras credenciales de acceso para que se pueda realizar la autenticación en Maestro.
Tip
Si estás utilizando un espacio de trabajo exclusivo, por ejemplo: https://yourcompany.botcity.dev,
puedes utilizar esta URL personalizada al informar el Servidor.
Para la versión comunitaria, utiliza https://developers.botcity.dev.
Al hacer clic en siguiente, podrás ver todos los Runners existentes en tu espacio de trabajo de Maestro.
Simplemente selecciona el identificador del Runner que deseas vincular al Runner de este ambiente de ejecución.
De esta manera, al iniciar el Runner en el ambiente de ejecución a través de los scripts BotRunner o BotRunner-gui del SDK,
este Runner estará asociado al Runner que se creó en BotCity Maestro.
Tip
También puedes crear nuevos Runners desde el Wizard; solo selecciona la opción Crear uno nuevo e ingresa un identificador para el Runner.
En este caso, la creación en la plataforma y la asociación con el Runner de ejecución se realizarán automáticamente.
Personalización de la configuración del Runner¶
Info
La configuración del Runner se define mediante información en el archivo conf.bcf, ubicado en la carpeta conf donde se instaló el SDK.
Puedes ver más detalles sobre el archivo de configuración a través de este enlace.
El archivo de configuración del SDK de BotCity Studio tiene algunas configuraciones específicas del Runner de BotCity.
Algunas de estas configuraciones ya están incluidas por defecto al instalar el SDK de BotCity Studio.
Además de las configuraciones predeterminadas, también podemos incluir configuraciones personalizadas según sea necesario.
En la siguiente tabla, podemos ver más detalles sobre las configuraciones adicionales disponibles que se pueden utilizar en el archivo de configuración del Runner.
| Configuración | Requerido | Predeterminado | Descripción |
|---|---|---|---|
| machineId | Sí | El identificador único de la instancia del Runner de BotCity. | |
| javaParams | No | Parámetros de JVM que se pasarán para la ejecución de la automatización. | |
| pythonBinary | No | python | El binario de Python que se utilizará, como python3, py o la ruta completa al binario. |
| logScreen | No | true | Si se establece en true, habilita el uso compartido de pantalla con BotCity Maestro para automatizaciones basadas en GUI. |
| logApplication | No | true | Si se establece en true, habilita el uso compartido de registros con BotCity Maestro. |
| logTelemetry (desde 2.7.0) | No | false | Si se establece en true, habilita el uso compartido de telemetría del sistema con BotCity Maestro, como el % de CPU, el uso de memoria, etc. |
| startup | No | La ruta a un script de inicio que se ejecutará una vez que BotCity Runner inicie su ejecución. | |
| beforeTask (desde 2.7.0) | No | La ruta a un script que se ejecutará antes de cada tarea. | |
| debugEnabled (desde 2.7.0) | No | false | Si se establece en true, produce una salida de registro adicional detallada. |
| ignoreSSL (desde 2.7.0) | No | false | Si se establece en true, ignora los problemas de SSL al comunicarse con BotCity Maestro. Esto es útil cuando tu red intercepta conexiones HTTPS. |
Info
En el archivo conf.bcf, debes incluir el nombre de la configuración deseada y el valor que recibirá.
Iniciando el Runner¶
Ahora BotCity Runner admite la ejecución con o sin una interfaz gráfica (GUI).
Ejecución con GUI¶
Simplemente ejecuta el script BotRunner-gui disponible con tu SDK de BotCity Studio o utiliza el parámetro -gui si invocas manualmente el archivo botrunner.jar.
En este caso, es necesario hacer clic en el botón START para que el Runner establezca una conexión con Maestro y comience a procesar las tareas.
Ejecución sin GUI (Headless)¶
Simplemente ejecuta el script BotRunner disponible con tu SDK de BotCity Studio. En este caso, solo se iniciará una terminal que hace referencia al proceso del Runner.
Ejecución en un contenedor¶
Es posible ejecutar el Runner en contenedores utilizando nuestras imágenes, consulta más detalles en la sección de contenedores.