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 (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 ter novos projetos 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 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 vida curta 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 uma 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 pertence ao 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 ser 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 branch de destino podem ser personalizados.

Limitações conhecidas

O conector pode apenas listar, baixar e carregar 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 do GitHub App, resolva-as antes de migrar.

Mudança para o novo conector do GitHub (Beta)

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

Nota

Mudar 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 trocar de 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 via 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 Configurações , role para baixo até a seção 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 branch de destino
  - Nome do pull request e nome do branch de destino (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.
Recrie os APCs existentes usando o modo dry-run.

Não exclua ou desative os APCs existentes ainda.
1. Crie novos APCs apontando para o novo conector, espelhando a configuração do APC existente.
2. Ative 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. Confirme 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 exportação 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.
  - A CI é executada uma vez, não uma vez por arquivo.
Alterne os fluxos de trabalho ativos.

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

Após confirmar que o novo conector está estável:
1. Exclua os APCs antigos.
2. Exclua o conector legado em Configurações → Conectores → GitHub (Legacy).
3. Opcionalmente, revogue o token OAuth da conta de usuário que foi usada 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 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 pelo 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, habilite Usar domínio personalizado e forneça a URL da API.
Opcionalmente, selecione Exportar traduções como pull requests e forneça um Branch de pull request.
Se necessário, selecione Usar aplicativo do 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 Phrase App Connector em uma nova guia: https://github.com/apps/phrase-app-connector-eu (data center da UE) ou https://github.com/apps/phrase-app-connector-us (data center 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 verificaçã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.