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 Vendas para perguntas sobre licenciamento.

Disponível para

Planos Ultimate e Enterprise (legado)

Entre em contato com Vendas para perguntas sobre 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 do/para o repositório do GitHub.

O conector utiliza 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 Aplicativo do GitHub.

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 do solicitante para permitir que os solicitantes adicionem arquivos às solicitações diretamente do repositório online.
Use 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 de destino podem ser armazenados apenas no mesmo ramo que o arquivo de origem.
Configure trabalhos contínuos para monitorar arquivos selecionados em busca de alterações.

GitHub (Beta)

Nota

O conector está em beta desde junho de 2026.

Autenticação

O conector do GitHub (Beta) usa o token de instalação do aplicativo GitHub em vez de uma conta de usuário individual. Os tokens têm vida útil curta e se renovam automaticamente. Se um usuário deixar a organização ou perder o acesso ao repositório, o conector continuará funcionando.

O conector do GitHub (Beta) suporta apenas autenticação de aplicativo GitHub. 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 único commit e um único pull request, de modo que o CI é executado 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 do 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á comprometido separadamente em vez de ser agrupado.

As mensagens de commit são geradas automaticamente e não podem ser personalizadas. Se exportando como um pull request, o nome do pull request e o nome do ramo de destino podem ser personalizados.

Limitações conhecidas

O conector pode listar, baixar e fazer upload de arquivos apenas. 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 a limitações da API do GitHub.
O GitHub Enterprise Server não é atualmente suportado.
O novo conector não suporta o fluxo OAuth do conector legado. Se a sua organização tiver restrições na instalação de aplicativos do GitHub, resolva isso antes de migrar.

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

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

Pré-requisitos:

Acesso de admin à sua organização do GitHub para instalar um aplicativo do GitHub. Instale-o no nível da organização para que 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 não produtivo para validar antes de mudar os fluxos de trabalho ao vivo.

Siga estas etapas:

Instale o aplicativo do GitHub Phrase.
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 do GitHub Phrase.
6. No GitHub, selecione a organização ou conta e os repositórios para os quais conceder acesso, e então confirme a instalação. Inclua todos os repositórios atualmente monitorados pelo(s) conector(es) existente(s).
  
  O GitHub redireciona automaticamente para a Phrase.
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 no primeiro passo.
5. Copie as 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 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 múltiplos conectores sob a mesma instalação do GitHub App, cada um com configurações independentes.
Recrie os APCs existentes usando o modo de simulação.

Não exclua ou desabilite 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 de simulação escaneia o repositório e combina arquivos sem acionar trabalhos de tradução.
3. Revise os arquivos combinados. 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 aplicativo GitHub, não em uma conta pessoal.
  - A CI é executada uma vez, não uma vez por arquivo.
Troque fluxos de trabalho ao vivo.

Uma vez que a validação seja aprovada:
1. Desabilite os APCs no conector legado.
2. Ative os APCs no novo conector (remova o modo de simulação).
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 (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 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.
Altere o Tipo para GitHub e forneça um nome para o conector.
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 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 Conector do Aplicativo 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 GitHub da Phrase na conta GitHub alvo.
  
  Nota
  
  Se o aplicativo GitHub não estiver instalado na conta GitHub alvo 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 estarão visíveis e acessíveis para o conector do GitHub.
4. Volte para a página Conectores/Criar da 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 Aplicativo Phrase.

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

O conector é 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.