GitHub (TMS)

Le contenu est traduit de l’anglais par Phrase Language AI.

Disponible pour

Les forfaits Team, Business et Enterprise

Contactez le service commercial pour toute question relative aux licences.

Disponible pour

Les forfaits Ultimate et Enterprise (anciens)

Contactez le service commercial pour toute question relative aux licences.

Astuce

Pour plus d'informations sur l'intégration GitHub dans Phrase Strings, reportez-vous à GitHub (Strings).

Le connecteur GitHub permet de télécharger des fichiers source et de charger des fichiers cible directement depuis/vers le référentiel GitHub.

Le connecteur utilise l'API GitHub pour implémenter l'intégration. Le connecteur permet d'accéder à tous les référentiels associés à un compte GitHub. L'authentification du compte GitHub peut également être effectuée dans la GitHub App.

Cas d'utilisation

Il existe un certain nombre de cas d'utilisation pour le connecteur :

Les chefs de projet peuvent ajouter des fichiers directement aux projets depuis un référentiel en ligne.
Configurez le submitter portal pour permettre aux envoyeurs d’ajouter directement des fichiers aux demandes depuis le référentiel en ligne.
Utilisez la création de projets automatisée (APC) pour que de nouveaux projets soient automatiquement créés lorsqu'une taille de fichier est détectée pour des fichiers ou un dossier suivis.
- Ce connecteur prend en charge le paramétrage de chemin absolu. Les fichiers de traduction cible peuvent être stockés uniquement dans la même branche que le fichier source.
Configurez des travaux continus pour que les fichiers sélectionnés soient surveillés pour toute modification.

GitHub (Bêta)

Remarque

Le connecteur est en version bêta depuis juin 2026.

Authentification

Le connecteur GitHub (Bêta) utilise le jeton d'installation de l'application GitHub plutôt qu'un compte utilisateur individuel. Les jetons sont de courte durée et se renouvellent automatiquement. Si un utilisateur quitte l'organisation ou perd l'accès au référentiel, le connecteur continue de fonctionner.

Le connecteur GitHub (Beta) prend uniquement en charge l'authentification par application GitHub. L'option OAuth de l'ancien connecteur n'est pas prise en charge.

Exporter

Le connecteur GitHub (Beta) regroupe tous les fichiers d'un seul export dans un commit et une demande de tirage, de sorte que l'intégration continue s'exécute une fois par export, quel que soit le nombre de fichiers.

Les fichiers sont regroupés dans un seul commit lorsque tout le contenu partage le même responsable de référentiel, référentiel et branche.

Si l'APC est configuré pour charger les fichiers au fur et à mesure qu'ils sont terminés individuellement, chaque fichier sera validé séparément plutôt que regroupé.

Les messages de commit sont générés automatiquement et ne peuvent pas être personnalisés. En cas d'exportation sous forme de demande de tirage, le nom de la demande de tirage et le nom de la branche cible peuvent être personnalisés.

Limitations connues

Le connecteur peut uniquement lister, télécharger et charger des fichiers. La suppression ou le déplacement de fichiers dans GitHub n'est pas pris en charge. Toute suppression ou tout renommage doit être effectué directement dans GitHub.
La liste des fichiers peut ne pas fonctionner correctement pour les référentiels contenant plus de 50 000 fichiers en raison des limitations de l'API GitHub.
GitHub Enterprise Server n'est actuellement pas pris en charge.
Le nouveau connecteur ne prend pas en charge le flux OAuth de l'ancien connecteur. Si votre organisation impose des restrictions sur les installations d'applications GitHub, résolvez-les avant de migrer.

Migration vers le nouveau connecteur GitHub (Beta)

Une migration automatisée n'est pas possible en raison du changement de modèle d'authentification.

Prérequis :

Accès administrateur à votre organisation GitHub pour installer une application GitHub. Installez-le au niveau de l'organisation afin qu'il couvre tous les référentiels surveillés par vos APC.
Paramètres APC existants visibles (gardez l'ancien connecteur ouvert dans un deuxième onglet).
Une branche de test ou un référentiel hors production pour valider avant de basculer les flux de travail en direct.

Suivez ces étapes :

Installez l'application Phrase GitHub.
1. Dans Phrase TMS, à partir de la page des paramètres , faites défiler vers le bas jusqu'à la section Intégrations.
2. Cliquez sur Connecteurs.
  
  La page Connecteurs s'ouvre.
3. Cliquez sur Nouveau connecteur.
  
  La page Créer un connecteur s'ouvre.
4. modifier le Type sur GitHub (Beta).
5. Cliquez sur Connecter.
  
  Phrase redirige vers GitHub pour autoriser l'application Phrase GitHub.
6. Sur GitHub, Sélectionner l'organisation ou le compte et les référentiels auxquels accéder, puis confirmer l'installation. Incluez chaque référentiel actuellement surveillé par le ou les connecteur(s) existant(s).
  
  GitHub redirige automatiquement vers Phrase.
7. Sélectionner le compte utilisateur ou organisation à connecter.
Créer un nouveau connecteur.
1. Dans Phrase TMS, à partir de la page des paramètres , faites défiler vers le bas jusqu'à la section Intégrations.
2. Cliquez sur Connecteurs.
3. Cliquez sur Nouveau connecteur.
4. Sélectionner l'installation de l'application GitHub configurée à la première étape.
5. Copier les paramètres du connecteur existant :
  - Référentiel et branche
  - Chemin du sous-dossier (si vous utilisez la surveillance de sous-dossier)
  - Regex de filtre de fichier (si configuré)
  - Mode d'exportation : commit direct ou pull request, et branche cible
  - Nom de la pull request et nom de la branche cible (si le mode PR est utilisé)
  Il est possible de Créer plusieurs connecteurs sous la même installation d'application GitHub, chacun avec des paramètres indépendants.
Recréer les APC existants en utilisant le mode dry-run.

Ne pas Supprimer ou désactiver les APC existants pour le moment.
1. Créer de nouveaux APC pointant vers le nouveau connecteur, en reproduisant la configuration APC existante.
2. Activer le mode dry-run sur chaque nouvel APC avant de l'activer. Le mode dry-run analyse le référentiel et fait correspondre les fichiers sans déclencher de tâches de traduction.
3. Examiner les fichiers correspondants. Confirmer que la portée correspond à ce que l'APC existant surveille.
Valider avec un export de test.
1. Effectuer une petite modification sur un fichier dans la portée surveillée.
2. Déclencher un export via le nouveau connecteur.
3. Confirmer :
  - Un seul commit est créé (pas un par fichier).
  - Le commit apparaît sous l'identité de l'application GitHub, et non d'un compte personnel.
  - L'intégration continue (CI) s'exécute une fois, et non une fois par fichier.
Basculer les workflows en direct.

Une fois la validation réussie :
1. Désactiver les APC sur l'ancien connecteur.
2. Activer les APC sur le nouveau connecteur (retirer le mode dry-run).
3. Surveillez un ou deux cycles d'exporter avant de mettre hors service l'ancien connecteur.
Mettez hors service l'ancien connecteur.

Après avoir confirmé que le nouveau connecteur est stable :
1. Supprimer les anciens APC.
2. Supprimer l'ancien connecteur depuis Paramètres → Connecteurs → GitHub (ancien).
3. Optionnellement, révoquez le jeton OAuth pour le compte utilisateur qui était utilisé par l'ancien connecteur.

Paramètres GitHub (ancien)

Aucune modification n'est requise.

Paramètres Phrase TMS

Important

En cas d'accès depuis un domaine Personnalisé (ex. mydomain.phrase.jp), ouvrez une fenêtre de navigation privée et connectez-vous via cloud.memsource.com ou us.cloud.memsource.com pour appliquer l'authentification requise pour la création ou l'enregistrement du connecteur. Après l'enregistrement, le connecteur est accessible via le domaine Personnalisé.

À partir de la page des paramètres, faites défiler vers le bas jusqu'à la section Intégrations.
Cliquez sur Connecteurs.

La page Connecteurs s'ouvre.
Cliquez sur Nouveau connecteur.

La page Créer un connecteur s'ouvre.
Modifier le Type en GitHub et donnez un nom au connecteur.
Sélectionnez éventuellement Export translations as pull requests et indiquez une branche de pull request.
Si nécessaire, sélectionnez Use Github app pour afficher l'URL de l'application Phrase GitHub et importer/exporter des fichiers en utilisant le flux d'autorisation de l'application GitHub :
1. Cliquez sur le lien pour ouvrir la page officielle du connecteur Phrase App dans un nouvel onglet : https://github.com/apps/phrase-app-connector-eu (centre de données UE) ou https://github.com/apps/phrase-app-connector-us (centre de données US).
2. Installez l'application Phrase GitHub sur le compte GitHub cible.
  
  Remarque
  
  Si l'application GitHub n'est pas installée sur le compte GitHub cible de l'utilisateur, seuls les dépôts publics seront visibles par le connecteur GitHub.
3. Terminer la procédure d'installation en sélectionnant les dépôts privés qui seront visibles et accessibles pour le connecteur GitHub.
4. Retournez sur la page Connectors/Create de Phrase pour autoriser l'application GitHub et vous connecter à GitHub.
Cliquez sur Connect to GitHub. Si vous n'êtes pas connecté via l'application GitHub, une fenêtre contextuelle ou un nouvel onglet apparaîtra pour demander l'autorisation.
Fournissez un Commit message si nécessaire.
Cliquez sur le bouton Authorize Phrase.

Si vous utilisez l'application GitHub, cliquez sur le bouton Authorize Phrase App Connector.

En cas de succès, la fenêtre/l'onglet disparaîtra et une petite coche apparaîtra à côté du bouton Connect to GitHub.
Cliquez sur Enregistrer.

Le connecteur est ajouté à la liste de la page Connecteurs.

Important

Si le connecteur GitHub est créé à l'aide du flux d'autorisation de l'application GitHub, il n'est pas possible de modifier la méthode d'autorisation après avoir enregistré les paramètres du connecteur.