# Execute seu primeiro job em um runner do Latchkey

> Troque um job do GitHub Actions para um runner gerenciado alterando uma linha de YAML, veja-o ser captado e verifique-o no dashboard.

Source: https://latchkey.dev/pt/documentation/run-your-first-job

## Summary

- Altere uma linha: `runs-on: latchkey-small` (a forma em array `[self-hosted, latchkey-small]` funciona de forma idêntica).
- Verifique pelo nome do runner na execução do GitHub e pela atividade da frota na página de Runners.
- Um job que permanece na fila indica um problema de roteamento ou cobrança, não um erro; veja Solução de problemas.

**Antes de começar**
- [ ] O GitHub App do Latchkey está instalado na minha organização
- [ ] O repositório é monitorado no Latchkey
- [ ] Meu trial ou assinatura está ativo

## A alteração de uma linha

Você nunca precisa digitar um rótulo de memória: cada linha da tabela **Your runners** na [página de Runners](/documentation/runners-dashboard) tem uma ação **Copy CI snippet**, e o painel de detalhes de cada runner inclui um cartão **Use in CI** com o rótulo e um snippet copiável.

Ambas as formas de rótulo roteiam de forma idêntica; use a que suas convenções preferirem:

## Ou gere-o

## Publique e verifique

1. **Faça commit e dispare o workflow** Faça o push da alteração ou dispare o workflow manualmente. No GitHub, o job aparece como enfileirado até que um runner o capte: segundos se houver um runner a quente disponível, cerca de 10 segundos para um runner novo (os hospedados pelo GitHub costumam levar 30-60 segundos), sem tempo de fila em qualquer caso.
2. **Verifique onde ele rodou** Na visão de execução do GitHub, o nome do runner do job confirma que uma máquina do Latchkey o assumiu em vez de uma hospedada pelo GitHub. Como todo runner é destruído após um job, não espere um nome familiar de execução para execução: uma máquina nova assume cada job, que é o [design efêmero](/documentation/runners-overview) funcionando como pretendido.
3. **Encontre os minutos** No dashboard do Latchkey, a [página de Runners](/documentation/runners-dashboard) mostra a execução na atividade da sua frota, e seus minutos aparecem contra seu nível gratuito. Com o tempo, os mesmos números aparecem em mais dois lugares: o modal de cobrança (progresso do nível gratuito, minutos cobráveis, custo estimado até agora) e a página [Análise de custos](/documentation/cost-analysis), que rastreia o gasto com runners do Latchkey junto ao seu gasto com o GitHub. Detalhes em [Uso de runners e minutos gratuitos](/documentation/runner-usage-and-free-minutes).

## Se o job simplesmente fica em "queued"

Um job que nunca é captado é o sintoma padrão de todo problema de roteamento: o repositório não é monitorado, os runners gerenciados não estão habilitados, o rótulo tem um erro de digitação, a imagem de um runner personalizado ainda está sendo construída, ou os lançamentos de runner estão bloqueados por cobrança. Não há erro explícito na interface do GitHub nesses casos. Percorra [Solução de problemas: job permanece na fila](/documentation/troubleshooting) para identificar qual é.

## Perguntas comuns

### Meus rótulos hospedados pelo GitHub continuam funcionando?

Sim. `ubuntu-latest` e afins continuam funcionando lado a lado; instalar o Latchkey não muda nada sobre eles. Você pode migrar um job de cada vez e deixar o resto intocado pelo tempo que quiser.

### Posso misturar runners do Latchkey e hospedados pelo GitHub em um workflow?

Sim, livremente. `runs-on` é decidido por job, então um workflow pode rodar seus jobs Linux em rótulos `latchkey-*` enquanto jobs que precisam de GPU, Windows, macOS ou hosts arm64 permanecem nos hospedados pelo GitHub ou outros runners.

### Preciso mudar algo além de runs-on?

Para a maioria dos workflows, não. A [imagem do runner](/documentation/runner-image-software) é projetada para igualar ou superar os runners hospedados pelo GitHub, e os passos `actions/setup-*` resolvem a partir do mesmo layout de toolcache, então o restante do job permanece como está.

### Quanto essa primeira execução me custa?

Os minutos são cobrados por minuto, arredondados para cima por job, pela tarifa do tamanho, e todo plano inclui minutos gratuitos por mês. A menos que você já tenha esgotado seu nível gratuito, uma execução de teste curta não custa nada. Veja [Uso de runners e minutos gratuitos](/documentation/runner-usage-and-free-minutes).

> **Migrando muitos workflows**
> A ferramenta **Migrate Runners** (owners/admins, na barra lateral do dashboard e na [página de Runners](/documentation/runners-dashboard)) abre um pull request pronto para revisão por repositório, até 20 repositórios monitorados por passagem, em vez de você editar arquivos um por um. O guia completo é [Migre dos runners hospedados pelo GitHub](/documentation/migrate-from-github-hosted).

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt