Runners e clusters
Os runners são as máquinas que executam as automações, com o Proton Runner instalado. No portal, Runners > Gerenciar mostra cada runner ao vivo, e Runners > Cluster junta runners para dividir as execuções.
Para instalar o Runner numa máquina e conectar ao Proton, veja a Configuração de Ambiente. Esta página trata do que se vê e se faz no portal.
A central de runners
Runners > Gerenciar, aba Runners, é a central ao vivo: atualiza sozinha a cada poucos segundos (o selo Ao vivo fica no canto) e conta o tempo das execuções em andamento.
Indicadores
| Indicador | O que conta |
|---|---|
| Executando | Os runners ocupados. |
| Livres | Os runners conectados e sem execução. |
| Offline | Os runners desconectados. |
| Em andamento | As execuções rodando ou preparando agora. |
| Na fila | As execuções esperando um runner. |
| Desatualizadas | Os runners numa versão anterior à última publicada. |
Executando, Livres e Offline também são filtros: clique para ligar e desligar. A barra tem ainda a busca Buscar runner (pelo apelido, dono, máquina ou sistema) e, para quem vê os clusters, o filtro por cluster.
O cartão do runner
Os cartões vêm na ordem executando, livres e offline. Cada um mostra:
- o nome: o apelido ou, sem apelido, o dono da conexão, com o selo Robô (conta robô) ou Nuvem (Cloud Runner);
- o dono, a máquina e o sistema operacional;
- a versão do Runner, em laranja com "atualizar" quando há versão nova (o Runner se atualiza sozinho ao reiniciar);
- a execução atual: a automação, o tempo correndo, o dataset e o progresso ("Passo X de Y", com o componente), ou "Livre, esperando execução", "Offline" ou "Preparando a execução";
- a fila: quantas execuções esperam este runner;
- o uso de CPU e de Memória da máquina agora (fora do ar, não aparece).
A gaveta do runner
Clicar no cartão abre a gaveta, com a central ainda visível ao lado:
- a execução atual e a Fila, com o dataset, a automação, quem disparou e o status de cada execução;
- a Máquina: nome, sistema, núcleos, memória, versão, se o runner é Privado ou Público e se a notificação de status está ligada;
- os Clusters de que o runner faz parte;
- Hoje: as execuções do dia, quantas passaram, falharam e foram interrompidas, e quanto tempo o runner ficou ocupado.
Apelido
O lápis da gaveta dá um apelido ao runner (até 60 caracteres), que passa a aparecer no lugar do nome do dono em todas as telas, como "Robô do faturamento" ou "Máquina SAP 2". Sem apelido, vale o nome do dono. Exige a permissão de editar runners.
Privado e Público
O Modo Privado é ligado no próprio Runner, na máquina, por quem conectou (ver Proton Runner). No portal, o runner privado aparece só para o dono dele.
Para reservar runners ou clusters a uma automação, use Selecionar Agentes na lista de Automações: a janela de execução daquela automação passa a mostrar só os escolhidos.
Quando o runner sai do ar
- Uma execução imediata para um runner desconectado é recusada e entra na fila de ocorrências, com o módulo de Operação.
- Um agendamento espera o runner voltar por até 1 hora. Depois disso, fica como "não rodou".
- Uma execução em andamento num runner que caiu e não voltou fica como falha depois de 15 minutos sem avançar.
Cloud Runners
A aba Cloud Runners, em Runners > Gerenciar, liga e desliga máquinas na nuvem que trabalham como runners. A máquina é cobrada por hora enquanto está ligada: desligue quando não precisar mais.
- Adicionar abre a janela: escolha a Configuração (cada uma mostra o preço por hora, os vCPUs e a memória) e o Modelo da máquina, e salve.
- A máquina nasce como Pending e passa a Active quando está pronta. Aí ela aparece na central com o selo Nuvem.
- O botão de desligar encerra a máquina (Shutting Down e, depois, Terminated). O runner dela sai da central.
- O cartão mostra o código da máquina, o status, o IP público, quem criou e as datas. Listar Encerrados mostra também as já desligadas, e a lista se atualiza a cada 30 segundos.
As configurações e os modelos de máquina disponíveis são preparados pela Atomic: fale com a Atomic para usar. Ver, criar e encerrar Cloud Runners exigem as permissões próprias.
Clusters
Um cluster junta vários runners para dividir as execuções entre eles. Na hora de executar ou agendar, escolha o cluster no lugar de um runner: o Proton manda cada execução para um runner do cluster.
A lista
Em Runners > Cluster, cada cluster mostra os runners que fazem parte dele, quantos estão executando, livres e offline agora, e se está Ativo. A busca acha o cluster também pelo nome de um runner dele.
Montar o cluster
Adicionar (ou o lápis, para editar) abre o montador:
- Dê um Nome ao cluster.
- À esquerda, escolha os runners. A busca e os filtros de status (Livres, Executando, Offline) e de tipo (Pessoas, Robôs, Nuvem) ajudam a achar. Cada cartão mostra se o runner já está em outro cluster.
- À direita fica o que está no cluster, com quantos runners executam ao mesmo tempo agora, quantos estão livres e os avisos de runner offline ou desatualizado. O X tira um runner do cluster.
- Criar cluster (ou Salvar).
Na edição, a chave Ativo liga e desliga o cluster. Desligado, ele não aparece na escolha de onde executar.
Como o cluster divide as execuções
- Um runner offline nunca recebe execução.
- As execuções de um disparo vão para os runners livres, uma para cada, em rodízio.
- Sem runner livre, as execuções entram na fila dos runners ocupados do cluster.
Permissões e celular
- Runners, clusters e Cloud Runners têm permissões próprias (ver, criar, editar e apagar) no perfil. Ver os clusters também libera o filtro por cluster e o bloco Clusters da gaveta.
- A central, os Cloud Runners e os clusters são feitos para o computador. No celular, a central abre mesmo assim, com a gaveta em tela cheia.
A página do Proton Runner
Em Ajuda > Proton Runner ficam o download do Runner para Windows e para Linux, as novidades de cada versão e as versões anteriores. O menu mostra quantas versões saíram desde a sua última visita. Ver Proton Runner.