Pular para o conteúdo
Página inicial da Latchkey
Comece grátis
Menu da documentação

Perguntas frequentes

Respostas rápidas sobre contas, runners, auto-recuperação, dados e cobrança.

Resumo

  1. Respostas rápidas sobre contas, runners, auto-recuperação, dados e cobrança.
  2. Toda resposta aqui é tratada em profundidade em outra parte da documentação e leva adiante por links.

Respostas rápidas, agrupadas por tópico, com links para as páginas completas onde há mais detalhes. Se você está depurando um problema específico em vez de buscar uma resposta, comece pela lista de sintomas:

Contas e configuração#

Posso usar o Latchkey com uma conta pessoal do GitHub?

Sim, para o Latchkey CI: uma conta pessoal se conecta e o executa; adicione o repositório pelo modal de Monitoramento do painel e, depois, faça commit de um arquivo de workflow em .latchkey/workflows/ e dê push. O Latchkey on GH (os runners gerenciados do Latchkey no GitHub Actions) exige uma conta de organização do GitHub. Criar uma organização no GitHub é gratuito e leva um minuto.

Preciso de um cartão de crédito para experimentar?

Não. Seu primeiro workspace inicia automaticamente um trial gratuito de 30 dias no plano Launch, sem cartão de crédito e sem seletor de plano no cadastro. Você pode mudar de plano a qualquer momento em Billing, Change Plan; há um trial gratuito por pessoa.

Quem se torna o dono do workspace?

A pessoa que instala o GitHub App. Há exatamente um dono por workspace, e a propriedade pode ser transferida a outro membro depois com Transfer Ownership. Veja Equipe e papéis.

Posso usar o Latchkey com mais de uma organização do GitHub?

Sim. Cada instalação recebe seu próprio workspace com seu próprio plano, equipe, repositórios e dados, e o menu de workspaces no topo da barra lateral move entre eles.

Posso estar em vários workspaces?

Sim. Se você pertence a vários workspaces, o menu de workspaces no topo da barra lateral move entre eles; cada workspace tem seu próprio plano, equipe e dados.

Preciso selecionar repositórios durante o onboarding?

Não. Você pode pular a seleção de repositórios e adicionar repositórios depois pelo modal de Monitoramento do painel. Veja Gerenciando repositórios.

Posso usar o painel no meu celular?

Ainda não: o painel precisa de uma tela de tablet, laptop ou desktop, e uma tela mais estreita que 768 px mostra um aviso após o login. Notificações por email, Slack e push cobrem você longe da sua mesa.

Runners#

Preciso mudar meus workflows para usar o Latchkey?

Apenas a linha runs-on:, e somente para os jobs que você escolher mover. Todo o resto permanece como está, e runners hospedados no GitHub continuam funcionando lado a lado.

Quais sistemas operacionais estão disponíveis?

Ubuntu 24.04 LTS em x86_64. Não há runners de Windows, macOS, arm64 ou GPU hoje; mantenha esses jobs em outros runners e misture livremente dentro de um workflow.

O Docker funciona?

Sim, nativamente: Docker CE com BuildKit, buildx e compose vêm pré-instalados, incluindo QEMU para builds de imagem multi-arch.

Quão rápido os jobs iniciam?

Cerca de dois segundos quando um runner quente já está online (Launch e Scale incluem capacidade de warm pool). Um cold start leva mais tempo, porque uma máquina nova precisa inicializar e se registrar primeiro.

Por quanto tempo um job pode rodar?

Até 4 horas por runner, ou até 8 se o job ainda estiver em execução ao completar 4 horas. Limites completos em Limites e concorrência.

Quantos jobs podem rodar ao mesmo tempo?

Cada plano define esse número: Developer 20, Launch 40, Scale 80 runners ocupados por workspace, e um trial usa o número do Launch; os limites do Enterprise são definidos em contrato. Runners quentes ociosos e runners estacionados não contam, e jobs além do teto aguardam por uma vaga.

Posso manter arquivos no runner entre jobs?

Não. Runners são de uso único: um job por máquina, destruída depois, então qualquer coisa gravada no disco local se perde quando o job termina. Use artifacts ou caches para persistência.

Onde os runners rodam?

Em AWS us-east-1, em máquinas Ubuntu 24.04 LTS x86_64. Veja Limites e concorrência.

Como os runners personalizados são cobrados?

Runners de configuração personalizada são cobrados à taxa xlarge ($0,0200/min), independentemente do seu formato. Veja Runners personalizados.

Quantas configurações de runner personalizadas posso criar?

2 no Developer e no Launch, 10 no Scale e ilimitadas no Enterprise. Veja Runners personalizados.

Meu agente de IA de codificação pode ver minhas falhas de CI?

Sim: conecte-o ao servidor MCP do Latchkey com uma chave de API e ele poderá triar falhas, puxar pacotes de falha e conduzir correções a partir do seu editor. Com as chaves de opt-in correspondentes, ele também poderá reexecutar workflows e rodar jobs avulsos em runners novos do Latchkey. Veja Conecte seu agente de IA.

Auto-recuperação#

A auto-recuperação vai mudar meu código?

Não. Correções durante a execução só afetam o runner efêmero, que é destruído após o job. Correções duráveis são sempre propostas apenas como pull requests para sua revisão, e nada é mesclado automaticamente.

Posso desligar a auto-recuperação?

Sim: para todo o workspace em Settings, na seção Self-healing (donos e admins), e por configuração de runner na página de Runners. Não há toggle por repositório hoje.

Ela vai mascarar falhas reais?

Não. Ela só intervém em classes transitórias conhecidas (rede, memória, disco, ferramentas ausentes, deriva de configuração). Falhas genuínas de código e de teste falham normalmente, e toda recuperação é registrada no feed Recent Heals.

Como vejo o que a auto-recuperação fez?

Toda intervenção aparece no feed Recent Heals na página de Runners, com sua categoria, veredito e a ação tomada em linguagem simples. Execuções recuperadas também são sinalizadas na tabela de execuções de Pipeline Performance e levam por deep-link ao seu relatório de recuperação.

As tentativas podem inflar minha conta?

Não. As tentativas são limitadas por passo, o estágio de diagnóstico de IA tem um orçamento de tempo rígido de cerca de quatro minutos, e o próprio runner tem um limite de vida útil de 4 horas. Detalhes em Auto-recuperação.

Dados e cobrança#

O que o Latchkey lê do GitHub?

Metadados de execução de workflow e de job, e seus arquivos YAML de workflow. Não o código-fonte da sua aplicação, e nunca segredos ou valores de variáveis de ambiente. Detalhes em Segurança e permissões do GitHub.

O que acontece com meus dados se eu desabilitar um repositório ou cancelar?

Desabilitar um repositório para a ingestão e arquiva seus dados. Cancelar bloqueia o acesso mas retém seus dados, então reassinar os restaura. Excluir o workspace o remove permanentemente.

Como o uso de runners é cobrado?

Por minuto, arredondado para cima por job, a taxas por tamanho, após os minutos gratuitos do seu plano. Veja Uso de runners e minutos gratuitos.

Quando os minutos gratuitos são renovados?

No primeiro dia de cada mês do calendário. Minutos dentro da camada gratuita não custam nada; apenas o uso além dela é cobrado às taxas por minuto.

Existe um limite de gasto no uso de runners?

Não por padrão. Um owner ou admin pode definir um limite de gastos em dólares americanos para o mês do calendário na página Billing. No limite, o Latchkey recusa novos jobs, retém os da fila e interrompe os que estão rodando, incluindo jobs do GitHub Actions em runners do Latchkey; o limite é redefinido com o mês. Sem um limite, um workspace com assinatura continua rodando e o excedente é medido na sua fatura, com avisos aos 80% e novamente aos 100% dos seus minutos incluídos. Em um trial sem cartão, novos jobs de runner gerenciado são bloqueados assim que os minutos gratuitos se esgotam, até você assinar.

O que acontece se meu pagamento falhar?

A assinatura passa a Past Due: o acesso ao painel e à API é bloqueado e os lançamentos de runner param até que o método de pagamento seja corrigido no portal do Stripe. Seus dados não são afetados. Veja Gerenciando sua assinatura.

Onde encontro minhas faturas?

No portal do cliente Stripe: abra a página Billing e clique em Invoices & payment method. Faturas (com PDFs), métodos de pagamento e detalhes da assinatura são todos gerenciados ali.

Posso mudar de plano depois?

Sim: Change plan na página Billing faz upgrade ou downgrade no local. Fazer downgrade abaixo da sua contagem de repositórios monitorados pede que você escolha quais repositórios permanecem monitorados, e fazer downgrade para Developer exige que o workspace tenha apenas um membro. O trial não reinicia com uma mudança de plano.

Equipe e workspaces#

Quantos assentos os planos incluem?

Launch inclui 3 assentos e Scale inclui 5; assentos extras custam $5/month cada. O plano Developer é para uso individual, então convites de equipe não estão disponíveis nele. Veja Equipe e papéis.

Posso conceder o papel de Owner por convite?

Não. Convites concedem Admin ou Member. Para entregar o workspace, o dono usa Transfer Ownership.

Por quanto tempo os convites duram?

Você escolhe uma expiração entre 1 e 30 dias (7 por padrão) e um número máximo de usos. Convites podem ser revogados a qualquer momento na aba Pending Invites.

Segurança#

Vocês podem preencher nosso questionário de segurança?

Sim. Envie-o pelo Suporte e trabalharemos nele com você diretamente. A maioria dos questionários já é coberta por Arquitetura de segurança e Segurança e permissões do GitHub, e relatos de vulnerabilidade vão para security@latchkey.dev.