Configure a localização contínua para GitHub Action, GitLab CI/CD, Bitbucket Pipelines ou a CLI autónoma. Todas estas opções executam a CLI da Lingo.dev no seu pipeline, por isso a configuração resume-se aos mesmos três passos: configurar a CLI, adicionar a sua chave de API e escolher um workflow.
Vai configurar antes a GitHub App?
A GitHub App não usa este fluxo — não há CLI local, i18n.json nem secret da chave de API. Instala a app uma vez e adiciona um .lingo/config.json ao repositório. Em vez disso, siga o guia da GitHub App.
Pré-requisitos
Antes de adicionar CI/CD, precisa de uma configuração da CLI funcional, com um ficheiro i18n.json, e da capacidade de executar npx lingo.dev@latest run localmente.
Passo 1. Configurar a CLI#
Se ainda não o fez, siga o guia de Configuração da CLI. No final, deverá ter:
- Um ficheiro
i18n.jsonna raiz do projeto - Uma chave de API (seja
LINGO_API_KEYpara o motor da Lingo.dev, seja uma chave de fornecedor comoOPENAI_API_KEY) - A capacidade de gerar traduções localmente com
npx lingo.dev@latest run
Passo 2. Adicione a sua chave de API como secret de CI#
Guarde a sua chave de API no gestor de secrets da sua plataforma de CI:
- Aceda a Settings > Secrets and variables > Actions
- Clique em New repository secret
- Nome:
LINGODOTDEV_API_KEY, Valor: a sua chave de API - Clique em Add secret
Passo 3. Escolha um workflow e adicione a configuração#
Escolha o workflow que melhor se adapta à sua equipa e siga depois o guia específico da plataforma:
| Workflow | Ideal para |
|---|---|
| Commit para a main | Equipas pequenas que querem atualizações de tradução sem atrito e sem intervenção |
| PR a partir da main | Equipas que querem rever as traduções antes de chegarem à main |
| Commit para branch feature | Equipas com branches feature de longa duração |
| PR a partir de branch feature | Equipas que querem o máximo de controlo sobre cada alteração de tradução |
Não tem a certeza de qual escolher? Comece por "Commit para a main" — é a opção mais simples. Pode mudar mais tarde sem alterar o seu i18n.json.
Para instruções de configuração específicas por plataforma e exemplos de workflow, consulte:
Verificar a configuração#
Depois de configurar o seu workflow de CI, faça push de uma alteração para o acionar. A integração deverá:
- Executar o pipeline de tradução
- Fazer commit das traduções ou abrir um PR (consoante o workflow)
- Atualizar o ficheiro
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 --frozenIsto termina com um estado diferente de zero se existir conteúdo por traduzir — útil como gate de deployment. Consulte Advanced Patterns para ver exemplos.
