-
Planos Team, Business e Enterprise
Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.
-
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 do GitHub permite o download de arquivos de origem diretamente do repositório do GitHub e o upload de arquivos de destino diretamente para ele.
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.
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 automatizada de projetos (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 branch 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 a partir de junho de 2026.
Autenticação
O conector do 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 do GitHub (Beta) oferece suporte apenas à autenticação via GitHub App. A opção OAuth do conector original não é suportada.
Exportação
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 compartilha o mesmo proprietário do repositório, o mesmo repositório e a mesma branch.
Se a APC estiver configurada para enviar os arquivos à medida que forem concluídos individualmente, cada arquivo será incluído em um commit separado, em vez de ser agrupado com os demais.
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 da branch de destino podem ser personalizados.
Caminho de exportação e subpastas
Quando o campo Exportar arquivos do repositório online para o caminho começa com / (um caminho absoluto), o conector do GitHub (Beta) mantém a estrutura de subpastas dos arquivos de origem. Cada arquivo traduzido é exportado, dentro do caminho de exportação, para a mesma subpasta em que o arquivo de origem se encontra dentro da pasta monitorada pela criação automatizada de projetos (APC).
Um arquivo diretamente na pasta monitorada é exportado diretamente para o caminho de exportação. Nenhuma subpasta é adicionada para um caminho de exportação relativo ou quando subpastas não são incluídas.
Um caminho de exportação absoluto começa na raiz do repositório da branch de origem.
Limitações conhecidas
-
O conector pode apenas listar, baixar e enviar arquivos. Não há suporte para excluir ou mover arquivos no GitHub. 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 nas 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 uma APC contínua do conector legado para o novo conector não é uma migração. O Phrase trata isso como uma nova configuração de conector, portanto, a 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 conector no meio de um projeto, considere que a contagem de palavras e o consumo de MTUs/créditos dos arquivos afetados refletirão uma reimportação completa.
Pré-requisitos:
-
Acesso de administrador à sua organização do GitHub para instalar o GitHub App. Instale-o no nível da organização para que ele cubra todos os repositórios monitorados pelas suas APCs.
-
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 das APCs existentes à vista (mantenha o conector antigo aberto em uma segunda aba).
-
Uma branch de teste ou repositório que não seja de produção para validar antes de mudar fluxos de trabalho ativos.
Siga estas etapas:
-
Instale o Phrase GitHub App.
-
No Phrase TMS, na página Configurações
, role para baixo até a seção .
-
Clique em Conectores.
A página é aberta.
-
Clique em Novo conector.
A página é aberta.
-
Altere o Tipo para GitHub (Beta).
-
Clique em Conectar.
O Phrase redireciona para o GitHub para autorizar o Phrase GitHub App.
-
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 pelos conectores existentes.
O GitHub redireciona automaticamente para o Phrase.
-
Selecione a conta de usuário ou da organização que deseja conectar.
-
-
Crie um novo conector.
-
No Phrase TMS, na página Configurações
-
Clique em Conectores.
-
Clique em Novo conector.
-
Selecione a instalação do GitHub App configurada na primeira etapa.
-
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 da pull request e nome da branch de destino (se estiver usando o modo de PR)
É possível criar vários conectores na mesma instalação do GitHub App, cada um com configurações independentes.
-
-
-
Recrie as APCs existentes usando o modo dry-run.
Não exclua nem desative as APCs existentes por enquanto.
-
Crie novas APCs apontando para o novo conector, reproduzindo a configuração das APCs existentes.
-
Ative o modo dry-run em cada nova APC antes de ativá-la. O modo dry-run verifica o repositório e identifica os arquivos correspondentes sem acionar trabalhos de tradução.
-
Revise os arquivos correspondentes. Confirme se o escopo corresponde ao que a APC existente monitora.
-
-
Valide com uma exportação de teste.
-
Faça uma pequena alteração em um arquivo no escopo monitorado.
-
Acione uma exportação através do novo conector.
-
Confirme:
-
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 integração contínua é executada uma vez, não uma vez por arquivo.
-
-
-
Faça a transição dos fluxos de trabalho ativos.
Assim que a validação for aprovada:
-
Desative as APCs no conector legado.
-
Ative as APCs no novo conector (remova o modo dry-run).
-
Monitore o novo conector 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:
-
Exclua as APCs antigas.
-
Exclua o conector legado em Configurações → Conectores → GitHub (Legado).
-
Opcionalmente, revogue o token OAuth da conta de usuário que era usada pelo conector legado.
-
Configurações do GitHub (legado)
Nenhuma alteração é necessária.
Importante
Se estiver acessando a partir de um domínio personalizado (por exemplo, mydomain.phrase.jp), abra uma janela anônima do navegador e faça login por meio de cloud.memsource.com ou us.cloud.memsource.com para realizar a autenticação necessária para criar ou salvar o conector. Após salvar, o conector pode ser acessado através do domínio personalizado.
-
Na página de configurações
-
Clique em Conectores.
A página é aberta.
-
Clique em Novo conector.
A página é aberta.
-
Altere o Tipo para GitHub e forneça um nome para o conector.
-
Opcionalmente, habilite e forneça a .
-
Opcionalmente, selecione e informe uma .
-
Se necessário, selecione para exibir a URL do aplicativo do Phrase para GitHub e importar/exportar arquivos usando o fluxo de autorização desse aplicativo:
-
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).
-
Instale o aplicativo do Phrase para GitHub na conta de destino do GitHub.
Nota
Se o aplicativo GitHub não estiver instalado na conta do GitHub de destino do usuário, apenas os repositórios públicos estarão visíveis para o conector do GitHub.
-
Conclua a instalação selecionando os repositórios privados que deverão ficar visíveis e acessíveis ao conector do GitHub.
-
Volte para a página do Phrase para autorizar o aplicativo GitHub e conectar-se ao GitHub.
-
-
Clique em Conectar ao GitHub. Se a conexão não for feita pelo aplicativo GitHub, uma janela pop-up ou uma nova guia será exibida solicitando autorização.
-
Forneça uma , se necessário.
-
Clique no botão Autorizar o Phrase.
Se estiver usando o aplicativo GitHub, clique no botão Autorizar o Phrase App Connector.
Se a autorização for bem-sucedida, a janela ou 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 .
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.