Configurar un Runner¶
El BotCity Runner es responsable de solicitar tareas al BotCity Orquestrador y ejecutarlas en un ambiente de ejecución.
Básicamente, la configuración de un nuevo Runner se puede dividir en dos etapas:
- Creación del Runner en BotCity Orquestrador
- Configuración del Runner en el ambiente de ejecución
En las siguientes secciones, veremos más detalles sobre cómo instalar y configurar un Runner en el ambiente de ejecución.
Orquestrador BotCity
La asignación y configuración del Runner debe realizarse directamente en los ambientes de ejecución.
Ver más en:
Ambiente de ejecución¶
Después de realizar la instalación del BotCity Studio SDK, tendrá la opción de hacer el Setup de un Runner.
En esta etapa puede asignar el Runner creado en Orquestrador BotCity en su ambiente de ejecución, siguiendo los pasos:
- Acceda al ambiente de ejecución
- Busque la carpeta donde se instaló
BotCity Studio SDK - Ejecute el archivo
wizard-X.Y.Z - Haga clic en el botón
Setup Runner
- Siga los pasos guiados por
Wizard:- Seleccione el servidor, por ejemplo:
https://tuempresa.botcity.dev
- Haga clic en el botón
I already have a Runner
- Seleccione de la lista de Runners disponibles en Orquestrador
- Seleccione el servidor, por ejemplo:
Después de completado, su Runner está configurado en el ambiente de ejecución y listo para iniciar.
Crear Runner en Wizard
También puede crear un Runner directamente en el paso Setup Runner al hacer clic en el botón Create a New Runner.
Al crear el Runner en Wizard, automáticamente se creará en Orquestrador BotCity.
Personalizar la configuración del Runner¶
Archivo de configuración
La configuración del Runner se define por la información del archivo conf.bcf, ubicado en la carpeta conf donde se instaló el SDK.
Puede ver más detalles sobre el archivo de configuración a través de este enlace.
El archivo de configuración de BotCity Studio SDK tiene algunas configuraciones específicas de BotCity Runner.
Algunas de estas configuraciones se incluyen por defecto en el momento de la instalación de BotCity Studio SDK.
Además de las configuraciones definidas por defecto, puede incluir configuraciones personalizadas según sea necesario.
Vea en la tabla a continuación más detalles sobre las configuraciones adicionales disponibles que pueden utilizarse en el archivo de configuración del Runner.
| Configuración | Obligatorio | Por defecto | Descripción |
|---|---|---|---|
| machineId | Sí | El identificador único de la instancia de BotCity Runner. | |
| javaParams | No | Parámetros de JVM a pasar para la ejecución de la automatización. | |
| pythonBinary | No | python | El binario Python a usar, como python3, py o la ruta completa al binario |
| logScreen | No | true | Si se establece en 'true', permite compartir pantalla con BotCity Orquestrador para automatizaciones basadas en GUI. |
| logApplication | No | true | Si se establece en 'true', permite compartir registros con BotCity Maestro. |
| logTelemetry (a partir de versión 2.7.0) | No | false | Si se establece en 'true', permite compartir telemetría del sistema con BotCity Orquestrador, como % de CPU, uso de memoria, etc. |
| startup | No | La ruta a un script de inicialización a ejecutar cuando BotCity Runner inicie su ejecución. | |
| beforeTask (a partir de versión 2.7.0) | No | La ruta a un script a ejecutar antes de cada tarea. | |
| debugEnabled (a partir de versión 2.7.0) | No | false | Si se debe producir una salida de registro más detallada. |
| ignoreSSL (a partir de versión 2.7.0) | No | false | Ignorar o no los problemas de SSL al comunicarse con BotCity Maestro. Esto es útil cuando su red intercepta conexiones HTTPS. |
Info
En el archivo conf.bcf debe incluir el nombre de la configuración deseada y el valor que recibirá, ejemplo:
Iniciar el Runner¶
BotCity Runner se puede iniciar de varias formas, vea a continuación.
Ejecución con GUI¶
Simplemente ejecute el script BotRunner-gui disponible en su BotCity Studio SDK o use el parámetro -gui si invoca el archivo botrunner.jar manualmente.
En este caso, es necesario hacer clic en el botón START para que el Runner establezca conexión con Orquestrador y comience a procesar las tareas.
Ejecución Headless (sin GUI)¶
Simplemente, ejecute el script BotRunner disponible en su BotCity Studio SDK. En este caso, solo se iniciará una terminal referente al proceso del Runner.
Ejecución usando contenedor¶
Es posible ejecutar el Runner en contenedores usando nuestras imágenes, vea más detalles en la sección contenedores.