GitHub (TMS)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Disponível para

Planos Team, Business and Enterprise

Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

Disponível para

Planos Ultimate e Enterprise (Legacy)

Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

Dica

Para informações sobre a integração do GitHub no Phrase Strings, consulte GitHub (Strings).

O conector do GitHub permite o download de arquivos de origem e o upload de arquivos de destino diretamente de/para o repositório do GitHub.

O conector usa a API do GitHub para implementar a integração. O conector permite o acesso a todos os repositórios associados a uma conta do GitHub. A autenticação da conta do GitHub também pode ser feita no GitHub App.

Casos de uso

Existem vários casos de uso para o conector:

Os gerentes de projetos podem adicionar arquivos diretamente a projetos a partir de um repositório online.
Configure o portal do solicitante para permitir que os solicitantes adicionem arquivos às solicitações diretamente do repositório online.
Use a criação de projeto automatizado (APC) para que novos projetos sejam criados automaticamente quando uma alteração no tamanho do arquivo for detectada em arquivos monitorados ou em uma pasta.
- Este conector oferece suporte à configuração de caminho absoluto. Os arquivos de tradução de destino podem ser armazenados apenas na mesma ramificação que o arquivo de origem.
Configure trabalhos contínuos para que arquivos selecionados sejam monitorados quanto a alterações.

GitHub (Beta)

Nota

O conector está em versão beta desde junho de 2026.

autenticação

O conector GitHub (Beta) usa o token de instalação do GitHub App em vez de uma conta de usuário individual. Os tokens têm curta duração e são renovados automaticamente. Se um usuário sair da organização ou perder o acesso ao repositório, o conector continuará funcionando.

O conector GitHub (Beta) oferece suporte apenas à autenticação do GitHub App. A opção OAuth do conector original não é suportada.

Exportar

O conector do GitHub (Beta) agrupa todos os arquivos de uma única exportação em um commit e um pull request, portanto, a CI é executada uma vez por exportação, independentemente da contagem de arquivos.

Os arquivos são agrupados em um único commit quando todo o conteúdo compartilha o mesmo proprietário, repositório e branch.

Se o APC estiver configurado para carregar arquivos à medida que são concluídos individualmente, cada arquivo será commitado separadamente em vez de agrupado.

As mensagens de commit são geradas automaticamente e não podem ser personalizadas. Ao exportar como uma pull request, o nome da pull request e o nome do branch de destino podem ser personalizados.

Limitações conhecidas

O conector pode apenas listar, baixar e fazer upload de arquivos. Excluir ou mover arquivos no GitHub não é suportado. Quaisquer exclusões ou renomeações devem ser feitas diretamente no GitHub.
A listagem de arquivos pode não funcionar corretamente para repositórios com mais de 50.000 arquivos devido às limitações da API do GitHub.
O GitHub Enterprise Server não é suportado atualmente.
O novo conector não suporta o fluxo OAuth do conector legado. Se sua organização tiver restrições quanto a instalações de aplicativos do GitHub, resolva-as antes de migrar.

Alternando para o novo conector do GitHub (Beta)

A migração automatizada não é possível devido à mudança no modelo de autenticação.

Nota

Alternar um APC contínuo do conector legado para o novo conector não é uma migração. O Phrase trata isso como uma nova configuração de conector, portanto, o APC reimporta o arquivo de origem como um novo trabalho em vez de atualizar o existente. O arquivo é tratado como novo conteúdo, portanto, palavras processadas anteriormente e Unidades de Tradução Automática (MTUs) não são transferidas. Ao alternar conectores no meio de um projeto, espere que a contagem de palavras e o consumo de MTU/créditos para os arquivos afetados reflitam uma reimportação completa.

Pré-requisitos:

Acesso de administrador à sua organização do GitHub para instalar um GitHub App. Instale-o no nível da organização para que ele cubra todos os repositórios que seus APCs monitoram.
A instalação do GitHub App deve ter acesso aos repositórios com conteúdo para tradução, caso contrário, a importação por meio do APC falhará.
Configurações de APC existentes visíveis (mantenha o conector antigo aberto em uma segunda guia).
Um branch de teste ou repositório que não seja de produção para validar antes de alternar fluxos de trabalho ativos.

Siga estas etapas:

Instale o aplicativo do Phrase para GitHub
1. No Phrase TMS, na página de configurações role para baixo até a seção de Integrações.
2. Clique em Conectores.
  
  A página Conectores é aberta.
3. Clique em Novo conector.
  
  A página Criar conector é aberta.
4. Altere o Tipo para GitHub (Beta).
5. Clique em Conectar.
  
  O Phrase redireciona para o GitHub para autorizar o GitHub App do Phrase.
6. No GitHub, selecione a organização ou conta e os repositórios aos quais deseja conceder acesso e, em seguida, confirme a instalação. Inclua todos os repositórios monitorados atualmente pelo(s) conector(es) existente(s).
  
  O GitHub redireciona para o Phrase automaticamente.
7. Selecione a conta de usuário ou organização para conectar.
Crie um novo conector.
1. No Phrase TMS, na página de configurações role para baixo até a seção de Integrações.
2. Clique em Conectores.
3. Clique em Novo conector.
4. Selecione a instalação do GitHub App configurada na primeira etapa.
5. Copie as configurações do conector existente:
  - Repositório e branch
  - Caminho da subpasta (se estiver usando monitoramento de subpasta)
  - Regex de filtro de arquivo (se configurado)
  - Modo de exportação: Commit direto ou Pull Request, e ramo de destino
  - Nome do pull request e nome do ramo de destino (se estiver usando o modo PR)
  É possível criar vários conectores na mesma instalação do GitHub App, cada um com configurações independentes.
Recrie os APCs já existentes usando o modo dry-run.

Ainda não exclua ou desative os APCs existentes.
1. Crie novos APCs apontando para o novo conector, espelhando as configurações dos APCs existentes.
2. Ative o modo dry-run para cada novo APC antes de ativá-lo. O modo dry-run verifica o repositório e faz a correspondência dos arquivos sem acionar trabalhos de tradução.
3. Revise os arquivos encontrados. Confirme se o escopo corresponde ao que os APCs existentes monitoram.
Faça uma validação com uma exportação de teste.
1. Faça uma pequena alteração em um arquivo dentro do escopo monitorado.
2. Acione uma exportação por meio do novo conector.
3. Confirmar
  - Um único commit será criado (não um por arquivo).
  - O commit aparece na identidade do GitHub App, não de uma conta pessoal.
  - A CI será executada uma vez, não uma vez por arquivo.
Altere para os fluxos de trabalho ativos.

Assim que a validação for concluída:
1. Desative os APCs no conector antigo.
2. Ative os APCs no novo conector (remova o modo dry-run dos APCs).
3. Monitore por um ou dois ciclos de exportação antes de descomissionar o conector legado.
Descomissione o conector legado.

Após confirmar que o novo conector está funcionando de forma estável:
1. Exclua os APCs antigos.
2. Exclua o conector legado nas Configurações → Conectores → GitHub (Legado).
3. Opcionalmente, revogue o token OAuth da conta de usuário utilizada pelo conector legado.

Configurações do GitHub (Legacy)

Nenhuma alteração é necessária.

Configurações do Phrase TMS

Importante

Se estiver acessando de um domínio personalizado (ex. mydomain.phrase.jp), abra uma janela anônima do navegador e faça login em cloud.memsource.com ou us.cloud.memsource.com para aplicar a autenticação necessária à criação ou ao salvamento do conector. Após salvar, o conector pode ser acessado por meio do domínio personalizado.

Na página de configurações role para baixo até a seção de Integrações.
Clique em Conectores.

A página Conectores é aberta.
Clique em Novo conector.

A página Criar conector é aberta.
Altere o Tipo para GitHub e forneça um nome ao conector.
Opcionalmente, ative Usar domínio personalizado e forneça o URL da API.
Opcionalmente, selecione Exportar traduções como pull requests e forneça um ramo de pull request.
Se necessário, selecione Usar aplicativo do GitHub para exibir a URL do aplicativo GitHub da Phrase e importar/exportar arquivos usando o fluxo de autorização do aplicativo GitHub:
1. Clique no link para abrir a página oficial do Phrase App Connector em uma nova guia: https://github.com/apps/phrase-app-connector-eu (centro de dados da UE) ou https://github.com/apps/phrase-app-connector-us (centro de dados dos EUA).
2. Instale o aplicativo Phrase GitHub na conta do GitHub de destino.
  
  Nota
  
  Se o aplicativo GitHub não estiver instalado na conta do GitHub de destino do usuário, apenas repositórios públicos estarão visíveis para o conector do GitHub.
3. Conclua o procedimento de instalação selecionando quaisquer repositórios privados que ficarão visíveis e acessíveis para o conector do GitHub.
4. Volte para a página Conectores/Criar do Phrase para autorizar o aplicativo GitHub e conectar ao GitHub.
Clique em Conectar ao GitHub. Se não estiver conectado usando o GitHub App, uma janela pop-up ou uma nova guia aparecerá solicitando autorização.
Forneça uma Mensagem de commit, se necessário.
Clique no botão Autorizar Phrase.

Se estiver usando o aplicativo GitHub, clique no botão Autorizar Phrase App Connector.

Se for bem-sucedido, a janela/guia desaparecerá e uma pequena marca de seleção aparecerá ao lado do botão Conectar ao GitHub.
Clique em Gravar.

O conector está adicionado à lista na página de conectores.

Importante

Se o conector do GitHub for criado usando o fluxo de autorização do aplicativo GitHub, não será possível alterar o método de autorização após salvar as configurações do conector.

Excluir um conector

Para excluir um conector:

Na página Integrações, selecione o conector a ser excluído.
Clique em Excluir.

A janela Excluir conector é exibida.
Digite "delete" e clique em Excluir.

O conector é excluído e a lista de conectores é exibida.

Nota

Um conector não pode ser excluído enquanto ainda estiver vinculado a trabalhos incompletos em um projeto, incluindo trabalhos que estejam na Lixeira. Tentar excluir esse conector gera o erro "Falha ao excluir conector".

Resolução: Abra o projeto associado ao conector e conclua ou exclua quaisquer trabalhos restantes. Vá para Configurações/Lixeira e esvazie-a para remover quaisquer trabalhos ainda vinculados ao conector. Tente excluir o conector novamente.