GitHub (TMS)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Verfügbar für

Pläne für Team, Business und Enterprise

Nimm Kontakt mit Vertrieb für Fragen zur Lizenzierung auf.

Verfügbar für

Ultimate- und Enterprise-Pläne (Legacy)

Nimm Kontakt mit Vertrieb für Fragen zur Lizenzierung auf.

Tipp

Für Informationen zur GitHub-Integration in Phrase Strings siehe GitHub (Strings).

Der GitHub-Konnektor ermöglicht das Herunterladen von Quelldateien und das Hochladen von Zieldateien direkt zum/vom GitHub-Repository.

Der Konnektor verwendet die GitHub-API, um die Integration umzusetzen. Der Konnektor ermöglicht den Zugriff auf alle Repositories, die mit einem GitHub-Konto verbunden sind. Die Authentifizierung des GitHub-Kontos kann auch im GitHub App erfolgen.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können Dateien direkt aus einem Online-Repository zu Projekten hinzufügen.
Richte das Einreicher-Portal ein, um Einreichenden zu ermöglichen, Dateien direkt aus dem Online-Repository zu Anfragen hinzuzufügen.
Verwende die Automatisierte Projekterstellung (APC), um neue Projekte automatisch zu erstellen, wenn eine Änderung in der Dateigröße bei überwachten Dateien oder einem Ordner festgestellt wird.
- Dieser Konnektor unterstützt die Einstellung absoluter Pfade. Zielübersetzungsdateien können nur im selben Branch wie die Quelldatei gespeichert werden.
Richte kontinuierliche Jobs ein, um ausgewählte Dateien auf Änderungen zu überwachen.

GitHub (Beta)

Hinweis

Der Konnektor befindet sich seit Juni 2026 in der Beta.

Authentifizierung

Der GitHub (Beta) Konnektor verwendet das Token der GitHub App-Installation anstelle eines individuellen Benutzerkontos. Tokens sind kurzlebig und erneuern sich automatisch. Wenn ein Benutzer die Organisation verlässt oder den Zugriff auf das Repository verliert, funktioniert der Konnektor weiterhin.

Der GitHub (Beta) Konnektor unterstützt nur die Authentifizierung über die GitHub App. Die OAuth-Option des ursprünglichen Konnektors wird nicht unterstützt.

Exportieren

Der GitHub (Beta) Konnektor fasst alle Dateien aus einem einzelnen Export in einem Commit und einem Pull-Request zusammen, sodass CI einmal pro Export unabhängig von der Dateizahl ausgeführt wird.

Dateien werden in einem einzelnen Commit zusammengefasst, wenn alle Inhalte denselben Repository-Eigentümer, dasselbe Repository und denselben Branch teilen.

Wenn der APC so konfiguriert ist, dass Dateien hochgeladen werden, sobald sie einzeln abgeschlossen sind, wird jede Datei separat und nicht gebündelt eingecheckt.

Commit-Nachrichten werden automatisch generiert und können nicht angepasst werden. Wenn als Pull-Request exportiert wird, können der Name des Pull-Requests und der Ziel-Branch-Name angepasst werden.

Bekannte Einschränkungen

Der Konnektor kann nur Dateien auflisten, herunterladen und hochladen. Das Löschen oder Verschieben von Dateien in GitHub wird nicht unterstützt. Alle Löschungen oder Umbenennungen müssen direkt in GitHub vorgenommen werden.
Die Dateiauflistung funktioniert möglicherweise nicht korrekt für Repositories mit mehr als 50.000 Dateien aufgrund von Einschränkungen der GitHub API.
GitHub Enterprise Server wird derzeit nicht unterstützt.
Der neue Konnektor unterstützt den OAuth-Flow des alten Konnektors nicht. Wenn Ihre Organisation Einschränkungen für die Installation von GitHub Apps hat, beheben Sie diese, bevor Sie migrieren.

Migration zum neuen GitHub (Beta) Konnektor

Eine automatisierte Migration ist aufgrund der Änderung im Authentifizierungsmodell nicht möglich.

Voraussetzungen:

Admin-Zugriff auf Ihre GitHub-Organisation, um eine GitHub-App zu installieren. Installieren Sie es auf Organisationsebene, damit es alle Repositories abdeckt, die Ihre APCs überwachen.
Vorhandene APC-Einstellungen sichtbar (halten Sie den alten Konnektor in einem zweiten Tab geöffnet).
Ein Test-Branch oder ein nicht-produktives Repository zur Validierung, bevor Sie die Live-Workflows umschalten.

Befolge diese Schritte:

Installieren Sie die Phrase GitHub-App.
1. In Phrase TMS, auf der Seite Einstellungen , scrollen Sie nach unten zum Abschnitt Integrationen.
2. Klicken Sie auf Konnektoren.
  
  Die Seite Konnektoren wird geöffnet.
3. Klicken Sie auf Neuer Konnektor.
  
  Die Seite Konnektor erstellen wird geöffnet.
4. Ändern Sie den Typ zu GitHub (Beta).
5. Klicken Sie auf Verbinden.
  
  Phrase leitet zu GitHub weiter, um die Phrase GitHub-App zu autorisieren.
6. Wählen Sie auf GitHub die Organisation oder das Konto und die Repositories aus, für die Sie Zugriff gewähren möchten, und bestätigen Sie dann die Installation. Schließen Sie jedes Repository ein, das derzeit von den bestehenden Konnektoren überwacht wird.
  
  GitHub leitet automatisch zu Phrase weiter.
7. Wählen Sie das Benutzer- oder Organisationskonto aus, das Sie verbinden möchten.
Erstellen Sie einen neuen Konnektor.
1. In Phrase TMS, auf der Seite Einstellungen , scrollen Sie nach unten zum Abschnitt Integrationen.
2. Klicken Sie auf Konnektoren.
3. Klicken Sie auf Neuer Konnektor.
4. Wählen Sie die GitHub-App-Installation aus, die im ersten Schritt festgelegt wurde.
5. Einstellungen vom vorhandenen Konnektor kopieren:
  - Repository und Branch
  - Unterordnerpfad (wenn Sie die Überwachung von Unterordnern verwenden)
  - Dateifilter-Regex (wenn konfiguriert)
  - Exportmodus: direkter Commit oder Pull-Request und Ziel-Branch
  - Name des Pull-Requests und Name des Ziel-Branches (wenn Sie den PR-Modus verwenden)
  Es ist möglich, mehrere Konnektoren unter derselben GitHub-App-Installation zu erstellen, jeder mit unabhängigen Einstellungen.
Bestehende APCs im Dry-Run-Modus neu erstellen.

Löschen oder Deaktivieren Sie die vorhandenen APCs noch nicht.
1. Erstellen Sie neue APCs, die auf den neuen Konnektor zeigen und die Konfiguration der vorhandenen APCs spiegeln.
2. Aktivieren Sie den Dry-Run-Modus für jede neue APC, bevor Sie sie aktivieren. Der Dry-Run-Modus scannt das Repository und vergleicht Dateien, ohne Übersetzungsjobs auszulösen.
3. Überprüfen Sie die übereinstimmenden Dateien. Bestätigen Sie, dass der Umfang mit dem übereinstimmt, was die vorhandene APC überwacht.
Validieren Sie mit einem Testexport.
1. Ändern Sie eine Datei im überwachten Umfang geringfügig.
2. Lösen Sie einen Export über den neuen Konnektor aus.
3. Bestätigen:
  - Ein einzelner Commit wird erstellt (nicht einer pro Datei).
  - Der Commit erscheint unter der Identität der GitHub-App, nicht unter einem persönlichen Konto.
  - CI läuft einmal, nicht einmal pro Datei.
Live-Workflows umschalten.

Sobald die Validierung bestanden ist:
1. Deaktivieren Sie die APCs am Legacy-Konnektor.
2. Aktivieren Sie die APCs am neuen Konnektor (Entfernen Sie den Trockenlaufmodus).
3. Überwachen Sie ein oder zwei Exportzyklen, bevor Sie den Legacy-Konnektor außer Betrieb nehmen.
Den Legacy-Konnektor außer Betrieb nehmen.

Nachdem bestätigt wurde, dass der neue Konnektor stabil ist:
1. Löschen Sie die alten APCs.
2. Löschen Sie den Legacy-Konnektor aus Einstellungen → Konnektoren → GitHub (Legacy).
3. Optional, widerrufen Sie das OAuth-Token für das Benutzerkonto, das vom Legacy-Konnektor verwendet wurde.

GitHub-Einstellungen (Legacy)

Es sind keine Änderungen erforderlich.

Phrase TMS-Einstellungen

Wichtig

Wenn Sie von einer benutzerdefinierten Domain (z. B. mydomain.phrase.jp) aus zugreifen, öffnen Sie ein Inkognito-Browserfenster und melden Sie sich über cloud.memsource.com oder us.cloud.memsource.com an, um die Authentifizierung anzuwenden, die für die Erstellung oder Speicherung des Konnektors erforderlich ist. Nach dem Speichern kann auf den Konnektor über die benutzerdefinierte Domain zugegriffen werden.

Scrolle auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
Klicken Sie auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Klicken Sie auf Neuer Konnektor.

Die Seite Konnektor erstellen wird geöffnet.
Ändere den Typ zu GitHub und gib einen Namen für den Konnektor an.
Wähle optional Übersetzungen als Pull-Requests exportieren und gib einen Pull-Request-Branch an.
Wähle, falls erforderlich, Github-App verwenden, um die URL der Phrase GitHub-App anzuzeigen und Dateien über den Autorisierungsfluss der GitHub-App zu importieren/exportieren:
1. Klicke auf den Link, um die offizielle Seite des Phrase App Connectors in einem neuen Tab zu öffnen: https://github.com/apps/phrase-app-connector-eu (EU-Rechenzentrum) oder https://github.com/apps/phrase-app-connector-us (US-Rechenzentrum).
2. Installiere die Phrase GitHub-App im Ziel-GitHub-Konto.
  
  Hinweis
  
  Wenn die GitHub-App nicht im Ziel-GitHub-Konto des Benutzers installiert ist, sind nur öffentliche Repositories für den GitHub-Konnektor sichtbar.
3. Schließe das Installationsverfahren ab, indem du alle privaten Repositories auswählst, die für den GitHub-Konnektor sichtbar und zugänglich sein sollen.
4. Gehe zurück zur Phrase Konnektoren/Erstellen-Seite, um die GitHub-App zu autorisieren und eine Verbindung zu GitHub herzustellen.
Klicke auf Mit GitHub verbinden. Wenn nicht über die GitHub-App verbunden, erscheint ein Popup-Fenster oder ein neuer Tab, der um Autorisierung bittet.
Gib eine Commit-Nachricht an, falls erforderlich.
Klicke auf die Schaltfläche Phrase autorisieren.

Wenn du die GitHub-App verwendest, klicke auf die Schaltfläche Phrase App Connector autorisieren.

Wenn erfolgreich, verschwindet das Fenster/der Tab und ein kleines Häkchen erscheint neben der Schaltfläche Mit GitHub verbinden.
Klicke auf Speichern.

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.

Wichtig

Wenn der GitHub-Konnektor über den Autorisierungsfluss der GitHub-App erstellt wird, ist es nach dem Speichern der Konnektoreinstellungen nicht möglich, die Autorisierungsmethode zu ändern.