Configure a localização contínua com GitHub Action, GitLab CI/CD, Bitbucket Pipelines ou a CLI independente. Em todos os casos, a CLI da Lingo.dev roda no seu pipeline, então a configuração segue as mesmas três etapas: configurar a CLI, adicionar sua chave de API e escolher um workflow.
Vai configurar o GitHub App em vez disso?
O GitHub App não usa esse fluxo — não há CLI local, i18n.json nem segredo de chave de API. Você instala o app uma vez e adiciona um .lingo/config.json ao repositório. Nesse caso, siga o guia do GitHub App.
Pré-requisitos
Antes de adicionar o CI/CD, você precisa ter uma CLI configurada e funcionando, com um arquivo i18n.json, e conseguir executar npx lingo.dev@latest run localmente.
Etapa 1. Configure a CLI#
Se ainda não fez isso, siga o guia de Configuração da CLI. Ao final, você deve ter:
- Um arquivo
i18n.jsonna raiz do projeto - Uma chave de API (seja
LINGO_API_KEYpara o Lingo.dev Engine ou uma chave de provedor, comoOPENAI_API_KEY) - A capacidade de gerar traduções localmente com
npx lingo.dev@latest run
Etapa 2. Adicione sua chave de API como segredo no CI#
Armazene sua chave de API no gerenciador de segredos da sua plataforma de CI:
- Acesse Settings > Secrets and variables > Actions
- Clique em New repository secret
- Nome:
LINGODOTDEV_API_KEY, Valor: sua chave de API - Clique em Add secret
Etapa 3. Escolha um workflow e adicione a configuração#
Escolha o workflow que faz mais sentido para sua equipe e siga o guia específico da plataforma:
| Workflow | Ideal para |
|---|---|
| Commit na main | Equipes pequenas que querem atualizações de tradução invisíveis e sem atrito |
| PR a partir da main | Equipes que querem fazer revisão das traduções antes de enviar para a main |
| Commit na branch de feature | Equipes com branches de feature de longa duração |
| PR a partir da branch de feature | Equipes que querem o máximo de controle sobre cada mudança de tradução |
Não sabe qual escolher? Comece com "Commit na main" — é a opção mais simples. Você pode mudar depois sem alterar seu i18n.json.
Para ver instruções de configuração por plataforma e exemplos de workflow, consulte:
Verifique a configuração#
Depois de configurar seu workflow de CI, envie uma alteração para acioná-lo. A integração deve:
- Executar o pipeline de tradução
- Fazer commit das traduções ou abrir um PR, dependendo do workflow
- Atualizar o arquivo
i18n.lock
Para verificar no CI se as traduções estão completas sem gerar novas, use a flag --frozen:
npx lingo.dev@latest run --frozenIsso retorna um status diferente de zero se houver qualquer conteúdo sem tradução — útil como bloqueio de deploy. Consulte Padrões Avançados para ver exemplos.
