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 GitHub. A autenticação da conta 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 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 ter novos projetos criados automaticamente quando uma alteração no tamanho do arquivo for detectada em arquivos monitorados ou em uma pasta.
- Este conector suporta a 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 a partir de 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 um 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 à medida que 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. Ao exportar como um pull request, o nome do 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.

Migração para o novo conector GitHub (Beta)

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

Pré-requisitos:

Acesso admin à sua organização 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.
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 Phrase GitHub App.
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. Alterar o Tipo para GitHub (Beta).
5. Clique em Conectar.
  
  O Phrase redireciona para o GitHub para autorizar o Phrase GitHub App.
6. No GitHub, Selecionar a organização ou conta e os repositórios para 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 GitHub App 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 filtro de arquivo (se configurado)
  - Modo de Exportar: commit direto ou pull request, e ramo de tradução
  - Nome da 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 um exportar de teste.
1. Faça uma pequena alterar em um arquivo no escopo monitorado.
2. Acione um 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.
  - 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. Desabilitar os APCs no conector legado.
2. Ativar os APCs no novo conector (remover o modo dry-run).
3. Monitore por um ou dois ciclos de exportar antes de desativar o conector legado.
Desative o conector legado.

Após confirmar que o novo conector está estável:
1. excluir os APCs antigos.
2. excluir o conector legado em configurações → Conectores → GitHub (legado).
3. Opcionalmente, revogue o token OAuth para a 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 de navegador anônima 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 o 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.
Alterar o Tipo para GitHub e forneça um nome para o conector.
Opcionalmente, Selecionar Exportar traduções 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 do GitHub de tradução.
  
  Nota
  
  Se o aplicativo GitHub não estiver instalado na conta do GitHub de tradução do usuário, apenas repositórios públicos estarão visíveis para o conector GitHub.
3. Concluir o procedimento de instalação Selecionar quaisquer repositórios privados que estarão visíveis e acessíveis para o conector GitHub.
4. Volte para a página conector/criar do Phrase para autorizar o aplicativo GitHub e conectar ao GitHub.
Clique em Conectar ao 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 mensagem de commit se necessário.
Clique no botão Autorizar Phrase.

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

Se for bem-sucedido, a janela/aba 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 é possível alterar o método de autorização após salvar as configurações do conector.