Contenedores¶

Utilizando las imágenes disponibles de BotCity, puedes tener acceso rápidamente a BotCity CLI y BotCity Runner para tu proyecto.

Utilizando las imágenes disponibles de BotCity, puedes configurar tu ambiente de desarrollo en poco tiempo.

Imágenes disponibles¶

Actualmente proporcionamos las siguientes imágenes:

La imagen botcity-base es una imagen base y contiene Java, así como BotCity Runner y CLI. Todas las demás imágenes se derivan de esta imagen y agregan características adicionales.

Espejos¶

Las imágenes de contenedor de BotCity están disponibles en los siguientes espejos:

Cuándo usar cada imagen¶

Si solo deseas utilizar BotCity CLI, puedes utilizar la imagen botcity-base.

Para el desarrollo de Python sin interfaz gráfica, puedes elegir la imagen adecuada para tu proyecto según el navegador en tiempo de ejecución.

Configuración¶

Para poder utilizarlo, deberás proporcionar las siguientes variables de ambiente:

• SERVER: El prefijo del servidor. Ejemplo: developers para developers.botcity.dev.
• LOGIN: La información de inicio de sesión de BotCity Maestro disponible en la página Ambiente de desarrollo.
• KEY: La información de clave de BotCity Maestro disponible en la página Ambiente de desarrollo.
• WORKSPACE: La información del espacio de trabajo de BotCity Maestro disponible en la página Ambiente de desarrollo.
• MACHINE_ID: El ID de la máquina que se utilizará por BotCity Runner.
• IGNORE_SSL: (Opcional) Si se establece en true, ignorará la validación del certificado SSL. ¡Usa con precaución!
• DEBUG_ENABLED: (Opcional) Si se establece en true, habilitará el modo de depuración y producirá registros más detallados. ¡Usa con precaución!

Para obtener más información sobre la configuración, visita la página Ambiente de desarrollo.

Uso¶

Como se mencionó anteriormente, esta imagen contiene las herramientas BotCity Runner y BotCity CLI del SDK de BotCity Studio.

Puedes ejecutarlas mediante los comandos BotCLI y BotRunner, y todos los parámetros se transmiten a las herramientas respectivas.

docker run --rm -ti -e WORKSPACE=TU_ESPACIO_DE_TRABAJO -e SERVER=TU_SERVIDOR -e LOGIN=TU_INICIO_DE_SESIÓN -e KEY=TU_CLAVE -e MACHINE_ID=TU_ID_DE_MÁQUINA

version: "3.0"
services:
    docker-1:
    image: botcity/botcity-python-web-chrome
    command: BotRunner
    environment:
        SERVER: developers
        LOGIN: YOUR_LOGIN
        KEY: YOUR_KEY
        MACHINE_ID: YOUR_MACHINE_ID
    shm_size: '1gb'

BotCity CLI¶

Para ejecutar la herramienta BotCLI, simplemente ejecuta el siguiente comando:

<configuración de Docker> <nombre de la imagen> BotCLI <parámetros aquí>

Para obtener más información sobre la herramienta BotCLI, consulta la documentación de BotCity CLI.

BotCity Runner¶

Para ejecutar la herramienta Runner, simplemente ejecuta el siguiente comando:

<configuración de Docker> <nombre de la imagen> BotRunner <parámetros aquí>

Para obtener más información sobre la herramienta BotCity Runner, consulta la documentación de BotCity Runner.

Ejemplos¶

Aquí tienes algunos ejemplos prácticos utilizando las imágenes de contenedor anteriores.

docker run --rm -ti -e WORKSPACE=company -e SERVER=company -e LOGIN=company -e KEY=COM_123ABCBA321 -e MACHINE_ID=DOCKER_01

Crear una máquina con BotCity CLI¶

En este ejemplo, utilizaremos BotCity CLI para crear una nueva máquina con el machineId como DOCKER_01 utilizando el espejo de AWS ECR.

<configuración de Docker> public.ecr.aws/botcity/botcity-base:latest BotCLI machine new -machineId DOCKER_01

La explicación del comando:

• <configuración de Docker> es el prefijo del comando que describimos al principio de esta sección
• public.ecr.aws/botcity/botcity-base:latest es el nombre de la imagen donde botcity-base es el nombre y latest es la etiqueta
• BotCLI es el nombre del comando
• machine new es la acción del comando
• -machineId DOCKER_01 es el parámetro enviado al comando machine new de BotCLI

Implementar un bot con BotCity CLI¶

En este ejemplo, implementaremos una automatización de Python disponible en el archivo BotPython-1.0.tar.gz utilizando el espejo de Docker Hub.

Dado que necesitamos que BotCity CLI tenga acceso al archivo BotPython-1.0.tar.gz, deberemos compartir la carpeta con el contenedor.

<configuración de Docker> -v my_code_folder:/code botcity/botcity-base:latest BotCLI bot deploy -version 1.0 -botId BotPython -file /code/BotPython-1.0.tar.gz -python

La explicación del comando:

• <configuración de Docker> es el prefijo del comando que describimos al principio de esta sección
• -v my_code_folder:/code es la carpeta con el archivo BotPython-1.0.tar.gz para compartir con el contenedor, y /code es la ruta dentro del contenedor
• botcity/botcity-base:latest es el nombre de la imagen donde botcity-base es el nombre y latest es la etiqueta
• BotCLI es el nombre del comando
• bot deploy es la acción del comando
• -version 1.0 -botId BotPython -file /code/BotPython-1.0.tar.gz -python son los parámetros enviados al comando bot deploy de BotCLI

BotCity Runner para automatizaciones de Python sin interfaz gráfica con Firefox¶

En este ejemplo, utilizaremos BotCity Runner para ejecutar automatizaciones de Python que utilizan el navegador Firefox en modo sin interfaz gráfica utilizando el espejo de AWS ECR.

<configuración de Docker> public.ecr.aws/botcity/botcity-python-web-firefox:latest BotRunner

La explicación del comando:

• <configuración de Docker> es el prefijo del comando que describimos al principio de esta sección
• public.ecr.aws/botcity/botcity-python-web-firefox:latest es el nombre de la imagen donde botcity-python-web-firefox es el nombre y latest es la etiqueta
• BotRunner es el nombre del comando

No se requieren parámetros adicionales para una ejecución estándar de BotCity Runner.

Personalización de las imágenes¶

Si necesitas personalizar las imágenes, puedes crear tu propio Dockerfile y utilizar una de las imágenes anteriores como base.

Como ejemplo, si necesitas agregar paquetes adicionales a la imagen botcity-python-desktop, puedes crear un Dockerfile como el siguiente:

FROM botcity-python-desktop:latest

# Install System Dependencies
RUN apt-get update && \
     \
    apt-get -y install freerdp2-x11 \
    --no-install-recommends && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

Luego puedes construir la imagen utilizando el siguiente comando:

docker build -t my-botcity-python-desktop:latest .

Y luego puedes utilizar la imagen my-botcity-python-desktop:latest en tu proyecto.

Para obtener más información sobre los Dockerfiles y cómo utilizarlos, visita la documentación de Docker.

Solución de problemas¶