Menu da documentação
Painel e análises
Runners gerenciados
Equipe e notificações
Faturamento e planos
Arquivos de workflow
Como funciona o provisionamento
O que acontece entre um job entrar na fila do GitHub e um runner o pegar: pools a quente, inícios a frio com registro just-in-time, o teto de concorrência e por que um job pode esperar.
Resumo
- Um job na fila é pego em cerca de dois segundos por um runner a quente que já está online, ou uma máquina nova faz um início a frio com registro just-in-time.
- Todo runner é efêmero: um job por VM, credenciais de uso único, máquina encerrada após o job.
- Hoje todo plano recebe a mesma linha de base a quente: um runner a quente sempre ligado mais capacidade estacionada em
latchkey-small. A demanda além disso faz início a frio. - 40 runners ocupados simultaneamente por workspace para começar, o número do plano Launch; runners a quente ociosos e runners estacionados nunca contam contra o limite.
Quando o GitHub enfileira um job com um rótulo latchkey-*, um webhook avisa o Latchkey imediatamente, e o Latchkey toma uma decisão: entregar o job a um runner que já está aquecido ou lançar uma máquina nova para ele. Você nunca vê essa decisão, mas ela é a diferença entre um job que começa quase de imediato e um que espera uma máquina inicializar, e ela explica a maior parte do que esta página cobre.
latchkey-*Captação a quente vs início a frio#
Uma captação a quente significa que um runner pré-provisionado já estava online para o seu workspace: o job é entregue direto a ele e começa em cerca de dois segundos. Um início a frio significa que nenhum runner a quente servia, então uma máquina nova inicializa só para aquele job, registra-se no GitHub usando uma configuração just-in-time de uso único e então executa seus passos. Os dois caminhos terminam de forma idêntica: o runner pega exatamente um job e a máquina é encerrada quando o job termina.
Três jobs chegam a um runner de três jeitos. O job 1, em latchkey-small, é pego por um runner quente já online, em cerca de dois segundos. O job 2, em latchkey-small, espera uma máquina estacionada ser retomada. O job 3, em latchkey-large, espera uma máquina nova iniciar e se registrar just-in-time. Cada máquina roda seu único job e é encerrada em seguida.
Pools a quente#
| Plano | Pool a quente |
|---|---|
| Developer | Um runner latchkey-small a quente mais capacidade estacionada |
| Launch | A mesma linha de base: um runner a quente mais capacidade estacionada |
| Scale | A mesma linha de base: um runner a quente mais capacidade estacionada |
Hoje todo plano recebe a mesma linha de base a quente, e ela cobre apenas latchkey-small: um runner a quente sempre ligado, apoiado por máquinas estacionadas que retomam sob demanda. Qualquer coisa além disso, e qualquer job que peça um tamanho maior, faz início a frio. A capacidade a quente não custa nada enquanto está ociosa; a cobrança é por minuto de job, e um runner a quente ocioso não está executando um job.
Efêmero, sempre#
O provisionamento nunca reutiliza uma máquina. A quente ou a frio, um runner pega exatamente um job e é encerrado em seguida, junto com seu disco, e é por isso que os nomes de runner na visualização de execução do GitHub mudam a cada execução e por isso que qualquer coisa que um job escreva no disco local some quando o job termina. O lado de segurança desse design, credenciais just-in-time, nenhum acesso de rede de entrada e discos criptografados de uso único, é coberto em Arquitetura de segurança.
Concorrência#
Um workspace executa até 40 runners ocupados simultaneamente para começar (o número do plano Launch; Developer 20, Scale 80 após uma mudança de plano; os limites do Enterprise são definidos em contrato), e só runners ocupados contam: runners a quente ociosos nunca consomem uma vaga, então a capacidade a quente não compete com seus jobs reais. Quando um pico precisa de mais do que o seu número de uma vez, os jobs excedentes ficam na fila e começam sozinhos; nada dá erro e nada se perde. Um job do Latchkey CI mantém seu lugar na fila e começa assim que uma vaga libera. Perto do limite, ele também começa antes dos jobs de um lote que estão na fila, e cada um deles cede a vez por no máximo 30 minutos na fila. Um job do GitHub Actions espera na fila do GitHub até uma vaga liberar. Quando um job do GitHub Actions do workspace termina, o Latchkey oferece a vaga dele a um job em espera na hora, a menos que um runner a quente ocioso pegue esse job antes; uma varredura a cada 5 minutos pega qualquer job em espera que esse momento deixe passar, então esse job pode começar alguns minutos depois que a vaga libera. No GitHub Actions, um runner a quente que já estava ocioso quando o limite foi atingido ainda aceita o único job que estava aguardando, então um workspace pode ter, no máximo, um job acima do seu número em execução para cada runner nessa situação; o Latchkey nunca para um runner para impor o número. Se seus picos entram na fila com frequência, limites maiores estão disponíveis, contate o suporte.
Um workspace no plano Launch, cujo limite é de 40 runners ocupados, tem 36 de 40 runners em uso. Uma rajada de 8 jobs entra na fila de uma vez. Os jobs 1 a 4 ocupam as quatro vagas livres e começam, e o workspace chega a 40 de 40. Os jobs 5 a 8 ficam na fila; nada dá erro e nada se perde. Um runner ocupado termina e libera uma vaga, e o job 5 começa nela; outro termina e o job 6 começa; mais dois terminam e os jobs 7 e 8 começam. A rajada inteira roda, os últimos quatro jobs depois de esperar na fila. Runners quentes ociosos e estacionados não ocupam vaga.
Limites rígidos#
- Um job do Latchkey CI define
timeout-minutesaté 180 (padrão 30), um da CLI roda até 3 horas e um runner do Latchkey on GH até 4 horas desde o seu início, ou até 8 se o job ainda estiver em execução ao completar 4 horas. - Os runners são apenas Ubuntu 24.04 LTS em x86_64: sem hosts Windows, macOS, arm64 ou GPU.
- Os runners rodam em AWS us-east-1.
A tabela completa, incluindo tamanhos de disco e contagens de configurações personalizadas por plano, está em Limites e concorrência.
Por que um job pode ficar parado na fila#
Quando o provisionamento não pode ou não vai lançar um runner, não há erro do lado do GitHub; o job simplesmente espera. Isso é por design: jobs direcionados a rótulos latchkey-* permanecem na fila do GitHub em vez de dar erro. As causas usuais:
- Um erro de digitação no rótulo: nenhuma configuração corresponde ao rótulo, então nada nunca pega o job.
- O repositório não está monitorado, ou a configuração do runner está desabilitada.
- Um bloqueio de cobrança ou trial: um trial expirado, uma assinatura vencida ou um nível gratuito esgotado em um trial sem cartão. O Latchkey envia uma notificação "Managed runner blocked" para esse bloqueio no máximo uma vez por dia, e não para a cota gratuita depois que a notificação "Free tier running out" do mês foi enviada; um bloqueio por um trial expirado continua desligado no e-mail e no Slack até você ligar o evento.
- A imagem de um runner personalizado ainda está sendo construída; jobs direcionados ao rótulo dele esperam até o build terminar.
- O workspace está no seu teto de runners ocupados (40 para começar, o número do plano Launch); quando um job do GitHub Actions do workspace termina, o Latchkey oferece a vaga liberada a um job em espera na hora, a menos que um runner a quente ocioso o pegue antes, e uma varredura a cada 5 minutos pega qualquer job que esse momento deixe passar, então esse job pode começar alguns minutos depois.
O passo a passo sintoma por sintoma, com como confirmar cada causa, está em Solução de problemas.
Q.01Por que meu job fica em queued?
Ou ele espera capacidade além da base quente, e nesse caso uma máquina nova está fazendo cold start para ele, ou algo o está bloqueando: o label, o monitoramento, a configuração, a cobrança, um build de imagem em andamento ou o teto de concorrência. Verifique nessa ordem.
Q.02Qual a diferença entre pickup quente e cold start?
Um pickup quente entrega o job a uma máquina que já está rodando, em cerca de dois segundos quando o runner já está online. Um cold start provisiona uma máquina nova com registro just-in-time e leva mais tempo. Hoje todos os planos têm a mesma base quente: um runner sempre ligado mais capacidade estacionada em latchkey-small.
Q.03Runners quentes ociosos contam para o meu limite de concorrência?
Não. O número de runners simultâneos do seu workspace (40 para começar) conta apenas runners ocupados, então capacidade quente à espera de trabalho nunca consome o limite que você está acompanhando.