Proton Runner
El Proton Runner es la aplicación que conecta una máquina a Proton y ejecuta en ella las automatizaciones. Funciona en Windows y en Linux, en una máquina física o virtual.
Descargar
En el portal de Proton, abre Ayuda > Proton Runner. La página muestra la versión actual, lo que cambió en cada versión y los botones Descargar para Windows y Descargar para Linux.
| Sistema | Archivo |
|---|---|
| Windows | proton-runner-<versão>-setup.exe |
| Linux | proton-runner-<versão>.AppImage |
Instalar
- Windows
- Linux
Ejecuta el proton-runner-<versão>-setup.exe y sigue el asistente. Si el navegador avisa que el archivo no se descarga
con frecuencia, conserva la descarga.
Instala y ejecuta el Runner con el usuario de Windows que va a ejecutar las automatizaciones: es en su sesión donde las automatizaciones de escritorio y de SAP GUI abren las ventanas.
Dale permiso de ejecución al archivo y ábrelo:
chmod +x proton-runner-<versão>.AppImage
./proton-runner-<versão>.AppImage
En un servidor sin interfaz gráfica, usa el Proton Runner CLI.
El Runner se actualiza solo: cuando sale una versión nueva, se aplica al reiniciar la aplicación. En Runners > Gestionar, el portal marca los runners desactualizados.
Conectar
Para conectarse, el Runner pide una conexión con:
| Campo | Qué completar |
|---|---|
| Nombre de la conexión | Opcional. Sin nombre, el Runner usa la dirección del servidor. |
| Servidor | https://app.protoncloud.com.br |
| Correo electrónico o identificador del robot | El identificador de la cuenta robot, o el correo electrónico de una cuenta personal. Ver Cuenta del runner. |
| Contraseña | La contraseña de la cuenta. Va al almacén seguro del sistema operativo (Administrador de credenciales en Windows, llavero en Linux), nunca a un archivo. |
| Organización | Aparece cuando la cuenta participa en más de una organización: elige en cuál va a entrar el runner. |
También puedes crear la conexión desde el portal: en Mi Perfil, el botón Abrir en Runner abre el Runner con el servidor y la cuenta ya completados, y Copiar datos copia esos mismos datos. La contraseña siempre se ingresa en el Runner.
Una vez conectado, el runner aparece en el portal, en Runners > Gestionar, como Libre, esperando ejecución. La organización en uso aparece en la barra superior del Runner.
Configuraciones
| Configuración | Qué hace |
|---|---|
| Ejecuciones paralelas | Cuántas automatizaciones ejecuta el runner al mismo tiempo. Las demás esperan en la cola. |
| Modo privado | Solo el dueño de la conexión puede enviar ejecuciones a este runner. |
| Notificación de estado | Una notificación del sistema cada vez que cambia el estado del runner. |
En el portal, en Runners > Gestionar, quien administra Proton puede darle un apodo al runner (sin apodo, se muestra el nombre del dueño). En Runners > Cluster, agrupa runners en un cluster, que reparte las ejecuciones entre ellos.
Cómo ocurre una ejecución
- Proton envía la ejecución al runner, que la pone en la cola.
- El runner descarga el código del repositorio del proyecto, en la rama elegida al disparar la ejecución, a través de la integración git registrada en Proton. El código queda en caché: la siguiente ejecución del mismo commit no lo descarga de nuevo.
- El runner reconoce el proyecto por el archivo en la raíz del repositorio y ejecuta:
- Java (
pom.xml):mvn -B test -DidDatasetRun=<id>; - Python (
pytest.ini):uv run pytest tests/test_proton_script.py::test_run_proton_execution --id_dataset_run=<id>.
- Java (
- La automatización recibe en el entorno del proceso la dirección de Proton (
PROTON_HOST), el id de la ejecución (idDatasetRun) y un token que vale solo para ella (PROTON_TOKEN). La Proton Cloud SDK lee estos valores por sí sola. - Al final, el runner sube la salida del proceso como archivo de log de la ejecución.
Cada etapa (la descarga del proyecto, la espera de la preparación, el inicio y el fin de la automatización) aparece en el log de la ejecución, para que la sigas en el portal.
La primera ejecución de un repositorio en un runner descarga el código y prepara las dependencias antes del primer paso, y puede tardar unos minutos.
Detener una ejecución
La ejecución se puede detener en el portal o en la ventana del Runner. En ambos casos, el proceso de la automatización se termina en la máquina.
Conexión inestable
Si se cae la conexión con Proton, el Runner intenta reconectarse solo y mantiene la sesión durante unos minutos. La ejecución en curso sigue corriendo mientras tanto.
Dispositivos conectados
El ícono de celular en la barra superior abre la lista de los dispositivos Android que ve la máquina, con lo que le falta a cada uno para quedar listo. Ver Mobile (Android).