Uso de runner e minutos gratuitos

Como os minutos de runner gerenciado são medidos, o que o nível gratuito cobre, onde o uso aparece e o que acontece quando os minutos gratuitos acabam.

Por Daniel Zoghalchali·Latchkey

Como funciona a medição#

• O uso é cobrado por minuto, arredondado para cima por job. Um job de 90 segundos no latchkey-small são 2 minutos.
• Cada tamanho tem sua própria taxa: small $0.0025, medium $0.0050, large $0.0100, xlarge $0.0200 por minuto. Runners de configuração personalizada são cobrados na taxa do xlarge.
• Somente o tempo em que seu job realmente ocupa o runner é cobrado; os jobs são limitados pela vida útil de 4 horas do runner.
• O self-healing não tem taxa separada: o tempo de execução extra durante um heal é cobrado na taxa padrão por minuto do runner.
• Jobs avulsos do Latchkey CLI ou da ferramenta MCP run_job são medidos da mesma forma: mesmas taxas por minuto, mesmo pool de minutos gratuitos, arredondado para cima por job. Eles têm por padrão um timeout de 30 minutos, extensível a 2 horas, e o tempo de fila nunca é cobrado.
• O excedente aparece como itens de linha medidos na mesma fatura mensal do Stripe do seu plano.

O arredondamento acontece por job, não por mês, o que importa quando os jobs são curtos: um job de 61 segundos é cobrado como 2 minutos, então um workflow que se divide em muitos jobs de um minuto consome minutos visivelmente mais rápido do que seu tempo total de relógio sugere. Se isso alguma vez ficar visível no seu medidor, consolidar jobs muito curtos é a alavanca.

O nível gratuito#

Os minutos gratuitos reiniciam no primeiro dia de cada mês do calendário. Os minutos dentro do nível gratuito não custam nada; só o uso além dele é cobrado nas taxas por minuto.

Um exemplo prático#

Os números abaixo são ilustrativos; as taxas e franquias são as reais. Digamos que uma equipe no Launch (4.000 minutos gratuitos) execute 6.000 minutos de latchkey-small em um mês:

O tamanho escala isso linearmente: os mesmos 6.000 minutos no latchkey-medium ($0.0050/min) dariam $10.00 de excedente, e no latchkey-large ($0.0100/min) $20.00. A calculadora abaixo faz a mesma aritmética com seus próprios números.

Estime seu custo#

Onde ver o uso#

• O modal de cobrança mostra uma barra de progresso do nível gratuito, o total e os minutos cobráveis deste período, e o custo estimado de runner até agora.
• A página Latchkey Runners mostra o custo em nível de frota, a economia estimada versus os hospedados no GitHub e o consumo do nível gratuito.
• A página Cost Analysis acompanha o gasto com runners Latchkey junto com seu gasto no GitHub, incluindo medidores do nível gratuito para ambos.
• Jobs iniciados a partir do Latchkey CLI ou de um agente aparecem no Cost Analysis como sua própria linha CLI Jobs; acompanhe jobs individuais a partir do próprio CLI (latchkey status, latchkey logs).

Ficando sem minutos gratuitos#

• Workspaces sem cartão registrado são avisados em 80% e novamente em 100% dos minutos incluídos, no máximo uma vez por dia.
• Com uma assinatura registrada: os jobs continuam rodando e o excedente é medido na sua fatura. Não há limite rígido de gasto.
• Em um teste sem cartão: uma vez esgotados os minutos gratuitos, novos jobs de runner gerenciado são bloqueados até você assinar. Jobs bloqueados permanecem na fila do GitHub (sem erro na interface do GitHub) e uma notificação "Managed runner blocked" é enviada.

A linha do tempo em resumo#

Trate o aviso de 80% como o ponto de decisão, e não o de 100%: ainda resta um quinto do nível, o que dá espaço para reduzir o uso (a página Cost Analysis mostra de onde vem o gasto) ou aceitar o excedente conscientemente. Com uma assinatura registrada não há limite rígido de gasto, então aceitar é uma resposta perfeitamente válida; só precisa ser uma escolha deliberada.

Se os lançamentos estiverem bloqueados#