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 e Enterprise

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

Disponível para

Planos Ultimate e Enterprise (legado)

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 GitHub permite o download de arquivos de texto original e o upload de arquivos de tradução diretamente de/para o repositório GitHub.

O conector usa a API do GitHub para implementar a integração. O conector permite acessar 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 projeto podem adicionar arquivos diretamente a projetos a partir de um repositório online.
Configure o portal de solicitações 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 podem ser armazenados apenas no mesmo ramo que o arquivo de texto original.
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 continua a funcionar.

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

Exportar

O conector GitHub (Beta) agrupa todos os arquivos de um único exportar em um commit e uma pull request, portanto, a CI é executada uma vez por exportar, independentemente da contagem de arquivos.

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

Se o APC estiver configurado para fazer upload de arquivos conforme eles são concluídos individualmente, cada arquivo será enviado separadamente em vez de agrupado.

As mensagens de commit são geradas automaticamente e não podem ser personalizadas. Se estiver exportando como uma pull request, o nome da pull request e o nome do ramo de tradução podem ser personalizados.

Limitações conhecidas

O conector pode apenas listar, fazer download e 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 servidor não é suportado atualmente.
O novo conector não suporta o fluxo OAuth do conector legado. Se sua organização tiver restrições em instalações de GitHub App, resolva-as antes de migrar.

Alternando para o novo conector GitHub (Beta)

A migração automatizada não é possível devido à alteração 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 texto original 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 para os arquivos afetados reflitam uma reimportação completa.

Pré-requisitos:

Acesso de admin à sua organização do GitHub para instalar um aplicativo GitHub. Instale-o no nível da organização para que ele cubra todos os repositórios que seus APCs monitoram.
Configurações de APC existentes visíveis (mantenha o conector antigo aberto em uma segunda aba).
Um ramo 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 Phrase 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 aplicativo Phrase GitHub.
6. No GitHub, selecionar a organização ou conta e os repositórios aos quais conceder acesso, então confirmar a instalação. Inclua todos os repositórios atualmente monitorados pelo(s) conector(es) existente(s).
  
  O GitHub redireciona para o Phrase automaticamente.
7. Selecionar a conta de usuário ou organização para conectar.
Criar 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. Selecionar a instalação do aplicativo GitHub configurada na primeira etapa.
5. Copiar configurações do conector existente:
  - Repositório e ramo
  - Caminho da subpasta (se estiver usando monitoramento de subpasta)
  - Regex de filtrar de arquivo (se configurado)
  - Modo de Exportar: commit direto ou pull request, e ramo de tradução
  - Nome do pull request e nome do ramo de tradução (se estiver usando o modo PR)
  É possível criar múltiplos conectores sob a mesma instalação do GitHub App, cada um com configurações independentes.
Recriar APCs existentes usando o modo dry-run.

Não Excluir ou desabilitar os APCs existentes ainda.
1. Criar novos APCs apontando para o novo conector, espelhando a configuração de APC existente.
2. Ativar o modo dry-run em cada novo APC antes de ativá-lo. O modo dry-run verifica o repositório e corresponde aos arquivos sem acionar trabalhos de tradução.
3. Revise os arquivos correspondentes. Confirmar se o escopo corresponde ao que o APC existente monitora.
Valide com uma exportação de teste.
1. Faça uma pequena alteração em um arquivo no escopo monitorado.
2. Acione uma exportar através do novo conector.
3. Confirmar:
  - Um único commit é criado (não um por arquivo).
  - O commit aparece sob a identidade do GitHub App, não de uma conta pessoal.
  - O CI é executado uma vez, não uma vez por arquivo.
Alternar fluxos de trabalho ativos.

Assim que a validação for aprovada:
1. Desabilitar os APCs no conector legado.
2. Ativar os APCs no novo conector (remover modo de simulação).
3. Monitore por um ou dois ciclos de exportar antes de desativar o conector legado.
Desativar o conector legado.

Após confirmar que o novo conector está estável:
1. Excluir os APCs antigos.
2. Excluir o conector legado de configurações → Conectores → GitHub (legado).
3. Opcionalmente, revogue o token OAuth da conta de usuário que foi usada pelo conector legado.

Configurações do GitHub (legado)

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 via cloud.memsource.com ou us.cloud.memsource.com para aplicar a autenticação necessária para a criação ou salvamento do conector. Após salvar, o conector pode ser acessado via 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 para o conector.
Opcionalmente, Ativar Usar domínio Personalizado e forneça API URL.
Opcionalmente Selecionar Exportar tradução como pull requests e forneça um ramo de Pull request.
Se necessário, Selecionar Usar aplicativo Github para exibir a URL do aplicativo Phrase GitHub e importar/exportar arquivos usando o fluxo de autorização do aplicativo GitHub:
1. Clique no link para abrir a página oficial do conector Phrase em uma nova aba: 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 de tradução do GitHub.
  
  Nota
  
  Se o aplicativo GitHub não estiver instalado na conta GitHub de destino do usuário, apenas os repositórios públicos estarão visíveis para o conector GitHub.
3. Conclua o procedimento de instalação selecionando quaisquer repositórios privados que ficarão visíveis e acessíveis para o conector GitHub.
4. Volte para a página Phrase Connectors/Create para autorizar o aplicativo GitHub e conectar ao GitHub.
Clique em Connect to GitHub. Se não estiver conectado usando o aplicativo GitHub, uma janela pop-up ou uma nova aba aparecerá solicitando autorização.
Forneça uma Commit message se necessário.
Clique no botão Authorize Phrase.

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

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

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

Importante

Se o conector 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.