Pular para o conteúdo principal
Proton v5

Proton Runner

O Proton Runner é o aplicativo que liga uma máquina ao Proton e executa nela as automações. Ele roda no Windows e no Linux, numa máquina física ou virtual.

Baixar​

No portal do Proton, abra Ajuda > Proton Runner. A página mostra a versão atual, o que mudou em cada versão e os botões Baixar para Windows e Baixar para Linux.

SistemaArquivo
Windowsproton-runner-<versão>-setup.exe
Linuxproton-runner-<versão>.AppImage

Instalar​

Execute o proton-runner-<versão>-setup.exe e siga o assistente. Se o navegador avisar que o arquivo não é comum, mantenha o download.

Instale e rode o Runner com o usuário do Windows que vai executar as automações: é na sessão dele que as automações de desktop e de SAP GUI abrem as janelas.

O Runner se atualiza sozinho: quando sai uma versão nova, ela entra ao reiniciar o aplicativo. Em Runners > Gerenciar, o portal marca os runners desatualizados.

Conectar​

Para conectar, o Runner pede uma conexão com:

CampoO que preencher
Nome da ConexãoOpcional. Sem nome, o Runner usa o endereço do servidor.
Servidorhttps://app.protoncloud.com.br
E-mail ou identificador do robôO identificador da conta robô, ou o e-mail de uma conta pessoal. Ver Conta do runner.
SenhaA senha da conta. Ela vai para o cofre do sistema operacional (Gerenciador de Credenciais no Windows, chaveiro no Linux), nunca para um arquivo.
OrganizaçãoAparece quando a conta participa de mais de uma organização: escolha em qual o runner vai entrar.

Também dá para criar a conexão a partir do portal: em Meu Perfil, o botão Abrir no Runner abre o Runner já com o servidor e a conta preenchidos, e Copiar dados copia os mesmos dados. A senha é sempre informada no Runner.

Conectado, o runner aparece no portal, em Runners > Gerenciar, como Livre, esperando execução. A organização em uso aparece na barra superior do Runner.

Configurações​

ConfiguraçãoO que faz
Execuções ParalelasQuantas automações o runner executa ao mesmo tempo. As outras esperam na fila.
Modo PrivadoSó o dono da conexão pode mandar execuções para este runner.
Notificação de StatusUma notificação do sistema a cada mudança de status do runner.

No portal, em Runners > Gerenciar, quem administra o Proton pode dar um apelido ao runner (sem apelido, vale o nome do dono). Em Runners > Cluster, junta runners num cluster, que divide as execuções entre eles.

Como uma execução acontece​

  1. O Proton manda a execução ao runner, que a põe na fila.
  2. O runner baixa o código do repositório do projeto, na branch escolhida no disparo, pela integração git cadastrada no Proton. O código fica em cache: a próxima execução do mesmo commit não baixa de novo.
  3. O runner reconhece o projeto pelo arquivo na raiz do repositório e roda:
    • 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>.
  4. A automação recebe no ambiente do processo o endereço do Proton (PROTON_HOST), o id da execução (idDatasetRun) e um token que vale só para ela (PROTON_TOKEN). A Proton Cloud SDK lê esses valores sozinha.
  5. No fim, o runner sobe a saída do processo como arquivo de log da execução.

Cada etapa (o download do projeto, a espera pelo preparo, o início e o fim da automação) aparece no log da execução, para acompanhar no portal.

A primeira execução de um repositório num runner baixa o código e prepara as dependências antes do primeiro passo, e pode levar alguns minutos.

Parar uma execução​

A execução pode ser parada no portal ou na janela do Runner. Nos dois casos, o processo da automação é encerrado na máquina.

Conexão instável​

Se a conexão com o Proton cair, o Runner tenta reconectar sozinho e mantém a sessão por alguns minutos. A execução em andamento continua rodando enquanto isso.

Aparelhos conectados​

O ícone de celular na barra superior abre a lista dos aparelhos Android que a máquina enxerga, com o que falta para cada um ficar pronto. Ver Mobile (Android).