FAQ
Perguntas Frequentes
Encontre respostas para perguntas comuns sobre a plataforma de análise e otimização de CI/CD do Latchkey.
Autocorreção
O que é a autocorreção?
A autocorreção é um recurso dos runners do Latchkey que detecta, diagnostica e corrige automaticamente etapas de build de CI/CD com falha enquanto o job ainda está em execução, para que seu pipeline continue avançando sem intervenção humana.
Que tipos de erros a autocorreção detecta?
Falhas transitórias e ambientais: problemas de rede (timeouts de registry e 5XXs de npm, Yarn, PyPI, Docker, Terraform), erros de memória (OOM kills, SIGKILL), erros de disco cheio (ENOSPC), ferramentas ausentes (command-not-found, instaladas a partir de uma allowlist verificada) e desvios de ambiente ou configuração (variáveis ausentes, incompatibilidades de versão de toolchain, limites de file-handle). Bugs reais no seu código, como testes com falha ou erros de compilação, explicitamente não são corrigidos e falham com os logs originais.
Quais runners do Latchkey oferecem suporte à autocorreção?
Todos os runners do Latchkey. Ela funciona tanto em runners de warm-pool quanto de cold-start, sem configuração adicional.
A autocorreção vem ativada por padrão?
Sim. Toda organização do Latchkey tem a autocorreção ativada por padrão em cada runner. Owners e admins podem desativá-la para toda a organização em Settings > Self-Healing, ou alterná-la por configuração de runner caso queira desativá-la apenas para runners específicos.
A autocorreção tem custo adicional?
Não há taxa separada. A autocorreção é executada de forma inline durante seu workflow, portanto qualquer tempo de execução extra que ela adiciona é cobrado pela tarifa padrão por minuto do runner que essa etapa está usando. É a mesma tarifa que você pagaria por qualquer outro minuto de CI nesse runner.
Como a autocorreção resolve uma falha tão rapidamente?
Quando uma etapa falha, o Latchkey diagnostica a causa e aplica a correção apropriada em segundos. Falhas transitórias simples são repetidas imediatamente; falhas mais complexas são resolvidas por um agente de IA que opera dentro de um conjunto limitado de ações. De qualquer forma, o build continua avançando sem intervenção humana.
Quais dados o agente de IA vê, e ele toca no meu código?
O agente recebe stderr, stdout, exit code e um conjunto selecionado de arquivos de manifesto (por exemplo, package.json, requirements.txt) para poder raciocinar sobre a falha. O código-fonte não é enviado. As ações do agente são limitadas a uma allowlist verificada; ele não pode executar comandos arbitrários nem modificar seu código.
A autocorreção pode resolver um problema permanentemente?
Sim, por meio de pull requests de correção. Quando uma correção bem-sucedida remonta a uma causa estrutural, como uma etapa de setup ausente no workflow ou um timeout de job baixo demais, o Latchkey pode abrir um pull request com a correção duradoura para você revisar e fazer merge. Mudanças duradouras sempre chegam como PRs revisáveis; a autocorreção nunca modifica seu código durante uma execução.
Posso ver o que a autocorreção fez com meu build?
Sim. A visão Recent Heals do dashboard mostra o veredito, a categoria da causa, a ação tomada e (para correções feitas pelo agente de IA) a transcrição completa do agente e o custo.
Latchkey Runners
O que são os Latchkey Runners?
Os Latchkey Runners são runners do GitHub Actions efêmeros e de alto desempenho que você pode adotar com uma alteração de uma única linha no YAML do seu workflow (por exemplo: runs-on: latchkey-medium). Quatro tamanhos predefinidos estão disponíveis (small, medium, large e extra large), e os AI Scan Runners podem gerar um runner sob medida para o seu repositório. Cada job é executado em um ambiente novo e isolado que faz cold-start em cerca de 10 segundos, enquanto os runners hospedados pelo GitHub normalmente levam de 30 a 60 segundos, e os warm runners pegam jobs em segundos. Os runners são totalmente compatíveis com os workflows existentes do GitHub Actions.
Como faço para migrar para os Latchkey Runners?
A adoção é simples: substitua seu valor de runs-on existente (por exemplo, runs-on: ubuntu-latest) pelo label do runner do Latchkey de sua escolha (latchkey-small, latchkey-medium, latchkey-large ou latchkey-xlarge) no arquivo YAML do seu workflow. Nenhuma outra alteração é necessária. Seus workflows, actions e steps continuam funcionando exatamente como antes, mas os jobs são executados na infraestrutura dedicada e mais rápida do Latchkey.
Posso migrar vários repositórios de uma vez?
Sim. A ferramenta Migrate Runners na página Runners abre um pull request pronto para revisão por repositório, para até 20 repositórios por vez. Apenas as linhas de runs-on são alteradas; todas as outras linhas de cada arquivo permanecem byte a byte idênticas, e os jobs de Windows e macOS ficam intocados. Nada muda até que sua equipe faça o merge.
Quais sistemas operacionais os Latchkey Runners suportam?
Os Latchkey Runners executam Ubuntu 24.04 em x86_64. Runners de Windows, macOS, arm64 e GPU não são oferecidos no momento, e o ferramental de migração deliberadamente deixa esses jobs sendo executados onde estão hoje.
Os Latchkey Runners são efêmeros? Meu código está seguro?
Sim. Cada job é executado em uma instância de runner nova e efêmera que é destruída após a conclusão do job. Nenhum dado, artefato ou estado persiste entre os jobs. Isso proporciona um forte isolamento entre as execuções de workflow e elimina o risco de contaminação entre jobs ou vazamento de credenciais que pode ocorrer com runners self-hosted persistentes.
Há limites de duração ou de quantos jobs posso executar?
Cada runner executa exatamente um job e é destruído em seguida. Os jobs podem ser executados por até 4 horas, e as organizações podem executar até 20 jobs simultâneos por padrão. Se sua equipe precisar de mais simultaneidade, entre em contato pelo suporte.
Quanto custam os Latchkey Runners?
Os minutos de runner são cobrados por tamanho: latchkey-small (2 vCPU / 8 GB) custa $0.0025 por minuto, latchkey-medium (4 vCPU / 16 GB) custa $0.005, latchkey-large (8 vCPU / 32 GB) custa $0.01 e latchkey-xlarge (16 vCPU / 64 GB) custa $0.02. Os runners personalizados são cobrados pela tarifa do xlarge. Isso é até 70% mais barato por minuto do que os runners hospedados pelo GitHub. Todo plano inclui minutos de runner gratuitos a cada mês (2,000 no Developer, 4,000 no Launch, 6,000 no Scale), e o uso além dos minutos incluídos é cobrado pela tarifa por minuto.
O Latchkey inclui caching?
Sim. O Latchkey inclui duas actions de caching integradas: latchkey-dev/cache-action@v1 para caches de dependências e latchkey-dev/docker-cache-action@v1 para camadas do Docker. Ambas funcionam sem configuração alguma nos runners do Latchkey, já que o armazenamento e as credenciais são pré-provisionados, e cada save ou restore ocorre em uma única requisição de streaming, com o armazenamento na mesma região do seu runner.
Como os Latchkey Runners se integram com análise e otimização?
Os Latchkey Runners alimentam dados de desempenho e custo diretamente no dashboard do Latchkey. Você obtém visibilidade em tempo real sobre a latência de inicialização do runner, tempos de fila, durações dos jobs e custos por minuto. O motor de otimização por IA do Latchkey analisa os padrões de uso do runner junto com os dados do seu workflow para trazer recomendações como o dimensionamento adequado dos recursos do runner ou a melhoria do caching, oferecendo uma visão unificada de todo o seu pipeline de CI/CD.
IA e Insights
O que são os insights de otimização por IA?
A IA do Latchkey analisa seus workflows do GitHub Actions e traz recomendações específicas, como adicionar caching de dependências, dimensionar runners adequadamente ou fixar actions, cada uma com uma pontuação de confiança e uma economia estimada em dólares por mês e tempo por execução. Você revisa cada mudança proposta como um diff de YAML, aceita ou pula cada uma, e as mudanças aceitas são enviadas como um único pull request que o Latchkey abre para você.
Meu agente de código pode ler as falhas de CI do Latchkey?
Sim. O Latchkey inclui um servidor MCP que entrega ao seu agente de código o contexto completo de uma falha: a causa raiz, o arquivo exato que falhou e os logs completos. Gere uma API key somente leitura (lk_live_) em Settings > API Keys, adicione o servidor ao Claude Code, Cursor ou qualquer agente compatível com MCP, e ele poderá obter os pacotes de falha diretamente. As keys são somente leitura, então um agente pode ler o contexto da falha, mas nunca alterar nada no seu repositório ou conta.
O Latchkey alguma vez altera meu código sem revisão?
Não. Toda alteração de repositório que o Latchkey faz, seja um insight de otimização, uma correção de heal ou uma migração de runner, chega como um pull request que você revisa e faz merge. Nada entra no seu repositório sem a sua aprovação.
Cobrança e Planos
Quais planos o Latchkey oferece?
Quatro planos: Developer a $5/month (1 repositório, 2,000 minutos de runner gratuitos, 1 seat), Launch a $19/month (até 10 repositórios, 4,000 minutos gratuitos, 1 seat incluído e seats extras a $5/month), Scale a $49/month (até 40 repositórios, 6,000 minutos gratuitos, 5 seats incluídos) e Enterprise com preço personalizado. Todo plano começa com um teste gratuito de 30 dias.
Preciso de cartão de crédito para começar o teste gratuito?
No Developer ou Launch, não: escolha um plano e ganhe 30 dias gratuitos com acesso completo aos recursos, sem cartão. Cada workspace tem direito a um teste.
O que exatamente conta como um "repositório monitorado"?
Um repositório monitorado é qualquer repositório do GitHub que você seleciona explicitamente no onboarding ou no dashboard do Latchkey para analisar. Não cobramos por repositórios inativos, arquivados ou não selecionados na sua conta do GitHub. Você tem controle total para ativar ou desativar o monitoramento de repositórios específicos e se manter dentro do limite do seu plano.
Vocês cobram pelo número de execuções de workflow?
Não. A análise e o monitoramento são ilimitados dentro do limite de repositórios do seu plano; quer você execute 10 builds por dia ou 10,000, o monitoramento custa o mesmo. Os minutos de runner são o único uso medido: todo plano inclui minutos gratuitos a cada mês, e o uso além deles é cobrado pela tarifa por minuto do runner.
Preciso pagar por cada desenvolvedor da minha equipe (preço por seat)?
Cada plano inclui seats: o Developer é de um único seat, sem membros de equipe, o Launch inclui 1 seat e o Scale inclui 5. No Launch e no Scale você pode adicionar seats por $5/month cada, para que toda a sua equipe de engenharia possa acessar o dashboard e os insights.
O que acontece se eu exceder o limite de repositórios do meu plano?
Se você precisar monitorar mais repositórios do que o seu tier atual permite, será necessário fazer upgrade para um tier superior para incluir esses repositórios adicionais no seu dashboard. Você pode fazer upgrade do seu plano a qualquer momento diretamente no menu de cobrança do dashboard, bem como adicionar novos repositórios para monitorar.
O que acontece se eu ficar sem minutos de runner gratuitos?
Os minutos gratuitos são redefinidos no início de cada período de cobrança mensal. Depois de usados, os minutos de runner adicionais são medidos pela tarifa por minuto do tamanho de runner que você usa. Se você estiver em um teste sem cartão, novos jobs de runner ficam bloqueados até que você adicione uma forma de pagamento.
O que acontece quando o teste gratuito de 30 dias termina?
Se você tiver uma forma de pagamento cadastrada, sua assinatura é convertida automaticamente para o plano que você escolheu, com a cobrança tratada de forma segura pelo Stripe. Se você começou sem cartão, o Latchkey solicita que você assine: escolha qualquer plano no dashboard e continue de onde parou. Seus dados são mantidos em qualquer um dos casos.
O que acontece com meus dados se eu desativar um repositório ou cancelar?
Desativar um repositório arquiva seus dados em vez de excluí-los. Cancelar sua assinatura mantém seus dados, para que você possa retomar de onde parou se voltar, e você pode solicitar a exclusão completa dos dados a qualquer momento.
Técnico e Segurança
O Latchkey oferece suporte a contas pessoais do GitHub?
Não. O Latchkey funciona apenas com contas de organização do GitHub. Instalar o GitHub App requer uma organização do GitHub que seja proprietária dos repositórios que você deseja monitorar; instalações em contas pessoais são automaticamente rejeitadas e removidas.
O Latchkey armazena meu código-fonte?
Não. O GitHub App do Latchkey lê execuções de workflow, resultados de jobs e seus arquivos YAML de workflow. Ele nunca lê seu código-fonte, secrets ou valores de ambiente, e as únicas escritas que ele pode fazer em um repositório são pull requests que você revisa e faz merge.
Como instalo o Latchkey? Preciso editar meus arquivos YAML?
Para análise e otimização, nosso onboarding leva menos de 5 minutos. Instale o GitHub App do Latchkey, selecione os repositórios para monitorar e pronto. Nenhuma edição de YAML é necessária. Se você também quiser usar os Latchkey Runners, a única mudança é atualizar o runs-on para um label de runner do Latchkey (por exemplo, latchkey-medium) nos seus arquivos de workflow. A análise é totalmente agentless, e os runners exigem apenas essa alteração de uma linha.
Vocês oferecem suporte a repositórios privados e ao GitHub Enterprise?
Sim, o Latchkey funciona com repositórios públicos e privados no GitHub.com. No entanto, instâncias on-premise do GitHub Enterprise Server não são suportadas no momento.
Posso usar o dashboard no celular?
O dashboard do Latchkey é somente para desktop por enquanto. Notificações do Slack e push do navegador mantêm você informado longe da sua mesa, mas o dashboard em si é feito para navegadores de desktop.
Vocês oferecem suporte a GitLab, Azure DevOps ou Bitbucket?
Atualmente, o Latchkey é altamente otimizado para o GitHub Actions. Estamos totalmente focados em oferecer primeiro os insights mais profundos possíveis para o ecossistema do GitHub. O suporte a outros provedores de CI/CD está em nosso roadmap.