GitHub (TMS)

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

Verfügbar für

Team-, Business- und Enterprise-Pläne

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Verfügbar für

Ultimate- und Enterprise-Pläne (Legacy)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Tipp

Informationen zur GitHub Integration in Phrase Strings finden Sie unter GitHub (Strings).

Der GitHub-Konnektor ermöglicht das Herunterladen von Ausgangssprache-Dateien und das Hochladen von Zielsprache-Dateien direkt aus dem/in das GitHub-Repository.

Der Konnektor verwendet die GitHub API, um die Integration zu implementieren. Der Konnektor ermöglicht den Zugriff auf alle Repositories, die mit einem GitHub User-Konto verknüpft sind. Die Authentifizierung des GitHub User-Kontos kann auch in der GitHub App erfolgen.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen.
Richte das Submitter Portal ein, um Einreichern zu ermöglichen, Dateien direkt aus dem Online-Repository zu Anfragen hinzuzufügen.
Verwende die Automatisierte Projekterstellung (APE), um automatisch neue Projekte erstellen zu lassen, wenn bei überwachten Dateien oder Ordnern eine Änderung der Dateigröße festgestellt wird.
- Dieser Konnektor unterstützt die Einstellung absoluter Pfade. Zielsprache-Übersetzungsdateien können nur im selben Branch wie die Ausgangssprache-Datei 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-Phase.

Authentifizierung

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

Der GitHub (Beta)-Konnektor unterstützt nur die GitHub App-Authentifizierung. 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 unabhängig von der Dateianzahl einmal pro Export ausgeführt wird.

Dateien werden in einem einzigen Commit zusammengefasst, wenn der gesamte Content denselben Repository-Eigentümer, dasselbe Repository und denselben Branch teilt.

Wenn die APE so konfiguriert ist, dass Dateien hochgeladen werden, sobald sie einzeln fertiggestellt sind, wird jede Datei separat committet, anstatt sie zusammenzufassen.

Commit-Nachrichten werden automatisch generiert und können nicht angepasst werden. Beim Exportieren als Pull Request können der Name des Pull Requests und der Name des Zielsprache-Branch angepasst werden.

Bekannte Einschränkungen

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

Migration zum neuen GitHub (Beta)-Konnektor

Eine automatisierte Migration ist aufgrund der Änderung des Authentifizierungsmodells nicht möglich.

Voraussetzungen:

Admin-Zugriff auf Ihre GitHub-Organisation, um eine GitHub App zu installieren. Installieren Sie diese auf Organisationsebene, damit sie alle Repositories abdeckt, die Ihre APEs überwachen.
Vorhandene APE-Einstellungen sichtbar (lassen Sie den alten Konnektor in einem zweiten Tab geöffnet).
Ein Test-Branch oder ein Nicht-Produktions-Repository zur Validierung vor dem Wechsel zu Live-Workflows.

Folge diesen Schritten:

Installieren Sie die Phrase GitHub App.
1. Scrolle in Phrase TMS auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
2. Klicke auf Konnektoren.
  
  Die Seite Konnektoren wird geöffnet.
3. Klicken Sie auf Neuen Konnektor erstellen.
  
  Die Seite Konnektor erstellen öffnet sich.
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 User-Konto sowie die Repositories aus, auf die Sie zugreifen möchten, und bestätigen Sie dann die Installation. Schließe jedes Repository ein, das derzeit vom bestehenden Konnektor bzw. den bestehenden Konnektoren überwacht wird.
  
  GitHub leitet automatisch zu Phrase weiter.
7. Wählen Sie das User-Konto oder die Organisation aus, das bzw. die verbunden werden soll.
Einen neuen Konnektor erstellen.
1. Scrolle in Phrase TMS auf der Seite Einstellungen nach unten zum Abschnitt Integrationen.
2. Klicke auf Konnektoren.
3. Klicken Sie auf Neuen Konnektor erstellen.
4. Wählen Sie die im ersten Schritt festgelegte GitHub App-Installation aus.
5. Einstellungen vom bestehenden Konnektor kopieren:
  - Repository und Branch
  - Pfad zum Unterordner (bei Verwendung der Unterordner-Überwachung)
  - Dateifilter-Regex (falls konfiguriert)
  - Export-Modus: direkter Commit oder Pull Request sowie Zielsprache-Branch
  - Name des Pull Requests und Name des Zielsprache-Branchs (bei Verwendung des PR-Modus)
  Es ist möglich, mehrere Konnektoren unter derselben GitHub App-Installation zu Erstellen, jeder mit unabhängigen Einstellungen.
Erstellen Sie bestehende APEs im dry-run-Modus neu.

Löschen oder deaktivieren Sie die bestehenden APEs noch nicht.
1. erstellen Sie neue APEs, die auf den neuen Konnektor verweisen, und spiegeln Sie die bestehende APE-Konfiguration.
2. Aktivieren Sie den dry-run-Modus für jede neue APE, bevor Sie sie aktivieren. Der dry-run-Modus scannt das Repository und gleicht Dateien ab, ohne Übersetzungsaufträge auszulösen.
3. Überprüfen Sie die abgeglichenen Dateien. Bestätigen Sie, dass der Umfang mit dem übereinstimmt, was die bestehende APE überwacht.
Validieren Sie mit einem Test-export.
1. Nehmen Sie eine kleine Änderung an einer Datei im überwachten Bereich vor.
2. Lösen Sie einen export über den neuen Konnektor aus.
3. Bestätigen:
  - Es wird ein einzelner Commit erstellt (nicht einer pro Datei).
  - Der Commit erscheint unter der GitHub App-Identität, nicht unter einem persönlichen User-Konto.
  - CI läuft einmal, nicht einmal pro Datei.
Schalten Sie Live-Workflows um.

Sobald die Validierung erfolgreich war:
1. Deaktivieren Sie die APEs auf dem Vermächtnis Konnektor.
2. Aktivieren Sie die APEs auf dem neuen Konnektor (entfernen Sie den dry-run-Modus).
3. Überwachen Sie ein oder zwei export-Zyklen, bevor Sie den Vermächtnis Konnektor außer Betrieb nehmen.
Deaktivieren Sie den Vermächtnis-Konnektor.

Nachdem Sie bestätigt haben, dass der neue Konnektor stabil ist:
1. Löschen Sie die alten APCs.
2. Löschen Sie den Vermächtnis-Konnektor unter Einstellungen → Konnektoren → GitHub (Vermächtnis).
3. Widerrufen Sie optional das OAuth-Token für das User-Konto, das vom Vermächtnis-Konnektor verwendet wurde.

GitHub Einstellungen (Vermächtnis)

Es sind keine Änderungen erforderlich.

Phrase TMS-Einstellungen

Wichtig

Wenn Sie über einen Individuell-Fachbereich zugreifen (z. B. mydomain.phrase.jp), öffnen Sie ein Inkognito-Browserfenster und melden Sie sich über cloud.memsource.com oder us.cloud.memsource.com an, um die für das Erstellen oder Speichern des Konnektors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann über den Individuell-Fachbereich auf den Konnektor zugegriffen werden.

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

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

Die Seite Konnektor erstellen öffnet sich.
Ändern Sie den Type zu GitHub und geben Sie einen Namen für den Konnektor an.
Wählen Sie optional Export translations as pull requests aus und geben Sie einen Pull request branch an.
Wählen Sie bei Bedarf Use Github app aus, um die Phrase GitHub App-URL anzuzeigen und Dateien über den GitHub App-Autorisierungsablauf zu importieren/exportieren:
1. Klicken Sie auf den Link, um die offizielle Seite des Phrase Konnektor 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. Installieren Sie die Phrase GitHub App für das Zielsprache-GitHub-User-Konto.
  
  Hinweis
  
  Wenn die GitHub App nicht für das Zielsprache-GitHub-User-Konto des User installiert ist, sind für den GitHub-Konnektor nur öffentliche Repositories sichtbar.
3. Schließen Sie den Installationsvorgang ab, indem Sie alle privaten Repositories auswählen, die für den GitHub-Konnektor sichtbar und zugänglich sein sollen.
4. Gehen Sie zurück zur Phrase Connectors/Create-Seite, um die GitHub App zu autorisieren und eine Verbindung zu GitHub herzustellen.
Klicken Sie auf Connect to GitHub. Wenn keine Verbindung über die GitHub App besteht, erscheint ein Popup-Fenster oder ein neuer Tab, in dem Sie zur Autorisierung aufgefordert werden.
Geben Sie bei Bedarf eine Commit message an.
Klicken Sie auf die Schaltfläche Authorize Phrase.

Wenn Sie die GitHub-App verwenden, klicken Sie auf die Schaltfläche Authorize Phrase App Konnektor.

Bei Erfolg wird das Fenster/der Tab geschlossen und ein kleines Häkchen erscheint neben der Schaltfläche Connect to GitHub.
Klicke auf Speichern.

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

Wichtig

Wenn der GitHub-Konnektor mithilfe des GitHub-App-Autorisierungsablaufs erstellt wurde, ist es nicht möglich, die Autorisierungsmethode nach dem Speichern der Konnektor-Einstellungen zu ändern.