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 sind unter GitHub (Strings) zu finden.

Der GitHub-Connector ermöglicht das Herunterladen von Quelldateien und das Hochladen von Zieldateien direkt aus dem bzw. in das GitHub-Repository.

Der Connector verwendet die GitHub-API, um die Integration zu implementieren. Der Connector ermöglicht den Zugriff auf alle Repositories, die mit einem GitHub-Konto verknüpft sind. Die Authentifizierung des GitHub-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.
Das Einreicher-Portal einrichten, damit Einreicher Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können.
Mit der automatisierten Projekterstellung (APC) lassen sich automatisch neue Projekte erstellen, wenn bei überwachten Dateien oder einem überwachten Ordner eine Änderung der Dateigröße festgestellt wird.
- Dieser Connector unterstützt die Einstellung absoluter Pfade. Zielsprachige Übersetzungsdateien können nur in demselben Branch wie die Quelldatei gespeichert werden.
Kontinuierliche Jobs einrichten, um ausgewählte Dateien auf Änderungen zu überwachen.

GitHub (Beta)

Hinweis

Der Connector befindet sich Stand Juni 2026 in der Beta-Phase.

Authentifizierung

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

Der GitHub (Beta)-Connector unterstützt ausschließlich die GitHub-App-Authentifizierung. Die OAuth-Option des ursprünglichen Connectors wird nicht unterstützt.

Export

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

Dateien werden in einem einzigen 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 fertiggestellt sind, wird jede Datei separat committet, anstatt sie zusammenzufassen.

Commit-Nachrichten werden automatisch generiert und können nicht angepasst werden. Beim Export als Pull Request können der Name des Pull Requests und der Name des Ziel-Branches angepasst werden.

Exportpfad und Unterordner

Wenn der Pfad für „Online-Repository-Dateien in Pfad exportieren“ mit / (einem absoluten Pfad) beginnt, behält der GitHub (Beta)-Connector die Unterordnerstruktur der Quelldateien bei. Jede übersetzte Datei wird in denselben Unterordner unter dem Exportpfad exportiert, in dem sich die Quelldatei unterhalb des von der automatisierten Projekterstellung (APC) überwachten Ordners befindet.

Eine Datei, die sich direkt im überwachten Ordner befindet, wird direkt in den Exportpfad exportiert. Für einen relativen Exportpfad oder wenn keine Unterordner einbezogen werden, wird kein Unterordner hinzugefügt.

Ein absoluter Exportpfad beginnt am Repository-Stammverzeichnis des Quell-Branches.

Bekannte Einschränkungen

Der Connector 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 Repositorys mit mehr als 50.000 Dateien aufgrund von GitHub-API-Einschränkungen möglicherweise nicht korrekt.
GitHub Enterprise Server wird derzeit nicht unterstützt.
Der neue Connector unterstützt den OAuth-Flow des bisherigen Connectors nicht. Falls für die Installation von GitHub-Apps in der Organisation Beschränkungen gelten, müssen diese vor der Migration behoben werden.

Wechsel zum neuen GitHub (Beta)-Connector

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

Hinweis

Das Umstellen eines kontinuierlichen APC vom bisherigen Connector auf den neuen Connector ist keine Migration. Phrase behandelt dies als neue Connector-Konfiguration. Daher importiert der APC die Quelldatei als neuen Job, statt den bestehenden zu aktualisieren. Die Datei wird als neuer Inhalt behandelt, sodass zuvor verarbeitete Wörter und Machine Translation Units (MTUs) nicht übernommen werden. Bei einem Connector-Wechsel während eines Projekts spiegeln die Wortanzahl und der MTU-/Guthabenverbrauch für die betroffenen Dateien einen vollständigen Neuimport wider.

Voraussetzungen:

Administratorzugriff auf die GitHub-Organisation zur Installation einer GitHub-App. Die App auf Organisationsebene installieren, damit sie alle von den APCs überwachten Repositories abdeckt.
Die Installation der GitHub-App muss Zugriff auf Repositorys mit Inhalten für die Übersetzung haben, andernfalls schlägt der Import über APC fehl.
Vorhandene APC-Einstellungen einsehbar (den bisherigen Connector in einem zweiten Tab geöffnet lassen).
Ein Test-Branch oder ein Nicht-Produktions-Repository zur Validierung, bevor Live-Workflows umgestellt werden.

Folge diesen Schritten:

Die Phrase-GitHub-App installieren.
1. In Phrase TMS auf der Seite Einstellungen nach unten zum Bereich Integrationen scrollen.
2. Klicke auf Konnektoren.
  
  Die Seite Konnektoren wird geöffnet.
3. Auf Neuer Connector klicken.
  
  Die Seite Connector erstellen wird geöffnet.
4. Den Typ in GitHub (Beta) ändern.
5. Auf Verbinden klicken.
  
  Phrase leitet zur Autorisierung der Phrase-GitHub-App zu GitHub weiter.
6. Auf GitHub die Organisation oder das Konto sowie die Repositories auswählen, für die Zugriff gewährt werden soll, und anschließend die Installation bestätigen. Alle Repositories einbeziehen, die derzeit von den bestehenden Connectoren überwacht werden.
  
  GitHub leitet automatisch zu Phrase weiter.
7. Das zu verbindende Benutzer- oder Organisationskonto auswählen.
Einen neuen Connector erstellen.
1. In Phrase TMS auf der Seite Einstellungen nach unten zum Bereich Integrationen scrollen.
2. Klicke auf Konnektoren.
3. Auf Neuer Connector klicken.
4. Die im ersten Schritt eingerichtete GitHub-App-Installation auswählen.
5. Einstellungen vom bestehenden Connector kopieren:
  - Repository und Branch
  - Unterordnerpfad (bei Verwendung der Unterordnerüberwachung)
  - Dateifilter-Regex (falls konfiguriert)
  - Exportmodus: direkter Commit oder Pull Request sowie Ziel-Branch
  - Name des Pull Requests und Name des Ziel-Branches (bei Verwendung des PR-Modus)
  Unter derselben GitHub-App-Installation können mehrere Connectoren mit jeweils eigenen Einstellungen erstellt werden.
Bestehende APCs im Trockenlaufmodus neu erstellen.

Die bestehenden APCs noch nicht löschen oder deaktivieren.
1. Neue APCs erstellen, die auf den neuen Connector verweisen und der bestehenden APC-Konfiguration entsprechen.
2. Für jeden neuen APC vor der Aktivierung den Trockenlaufmodus aktivieren. Der Trockenlaufmodus durchsucht das Repository und findet passende Dateien, ohne Übersetzungsaufträge auszulösen.
3. Die gefundenen Dateien überprüfen. Prüfen, ob der Umfang dem vom bestehenden APC überwachten Bereich entspricht.
Die Konfiguration mit einem Testexport überprüfen.
1. Eine Datei im überwachten Bereich geringfügig ändern.
2. Einen Export über den neuen Connector auslösen.
3. Folgendes überprüfen:
  - Es wird ein einzelner Commit erstellt (nicht einer pro Datei).
  - Der Commit erscheint unter der Identität der GitHub-App, nicht unter einem persönlichen Konto.
  - CI wird einmal ausgeführt, nicht einmal pro Datei.
Die produktiven Workflows umstellen.

Sobald die Validierung erfolgreich abgeschlossen ist:
1. Die APCs auf dem bisherigen Connector deaktivieren.
2. Die APCs auf dem neuen Connector aktivieren (den Trockenlaufmodus deaktivieren).
3. Ein oder zwei Exportzyklen überwachen, bevor der bisherige Connector außer Betrieb genommen wird.
Den bisherigen Connector außer Betrieb nehmen.

Nachdem bestätigt wurde, dass der neue Connector stabil ist:
1. Die alten APCs löschen.
2. Den bisherigen Connector unter Einstellungen → Connectors → GitHub (Legacy) löschen.
3. Optional das OAuth-Token für das Benutzerkonto widerrufen, das vom bisherigen Connector verwendet wurde.

GitHub-Einstellungen (Legacy)

Es sind keine Änderungen erforderlich.

Phrase TMS-Einstellungen

Wichtig

Bei Zugriff über eine benutzerdefinierte Domain (z. B. mydomain.phrase.jp) ein Inkognito-Browserfenster öffnen und sich über cloud.memsource.com oder us.cloud.memsource.com anmelden, um die für das Erstellen oder Speichern des Connectors erforderliche Authentifizierung durchzuführen. Nach dem Speichern kann über die benutzerdefinierte Domain auf den Connector zugegriffen werden.

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

Die Seite Konnektoren wird geöffnet.
Auf Neuer Connector klicken.

Die Seite Connector erstellen wird geöffnet.
Den Typ in GitHub ändern und einen Namen für den Connector angeben.
Optional Benutzerdefinierte Domain verwenden aktivieren und die API-URL angeben.
Optional Übersetzungen als Pull Requests exportieren auswählen und einen Pull-Request-Branch angeben.
Bei Bedarf GitHub-App verwenden auswählen, um die URL der Phrase GitHub-App anzuzeigen und Dateien über den Autorisierungsablauf der GitHub-App zu importieren und zu exportieren:
1. Auf den Link klicken, 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. Die Phrase GitHub-App für das gewünschte GitHub-Konto installieren.
  
  Hinweis
  
  Wenn die GitHub-App nicht für das gewünschte GitHub-Konto des Benutzers installiert ist, sind für den GitHub-Connector nur öffentliche Repositories sichtbar.
3. Zum Abschließen der Installation die privaten Repositories auswählen, die für den GitHub-Connector sichtbar und zugänglich sein sollen.
4. Zur Phrase-Seite Connectors/Create zurückkehren, um die GitHub-App zu autorisieren und eine Verbindung zu GitHub herzustellen.
Auf Mit GitHub verbinden klicken. Falls die Verbindung nicht über die GitHub-App hergestellt wird, erscheint ein Popup-Fenster oder ein neuer Tab mit der Aufforderung zur Autorisierung.
Bei Bedarf eine Commit-Nachricht angeben.
Auf die Schaltfläche Phrase autorisieren klicken.

Bei Verwendung der GitHub-App auf die Schaltfläche Phrase App Connector autorisieren klicken.

Bei Erfolg schließt sich das Fenster bzw. 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-Connector über den Autorisierungsablauf der GitHub-App erstellt wurde, ist es nach dem Speichern der Connector-Einstellungen nicht mehr möglich, die Autorisierungsmethode zu ändern.