GitHub (TMS)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

利用可能対象

Team、BusinessおよびEnterpriseプラン

ライセンスに関する質問は、営業担当までお問い合わせください。

利用可能対象

UltimateおよびEnterpriseプラン（従来）

ライセンスに関する質問は、営業担当までお問い合わせください。

ヒント

Phrase StringsでのGitHub統合に関する詳細については、GitHub (Strings)を参照してください。

GitHubコネクタを使用すると、GitHubリポジトリとの間で直接、ソースファイルのダウンロードやターゲットファイルのアップロードを行うことができます。

このコネクタはGitHub APIを使用して統合を実装します。このコネクタを使用すると、GitHubアカウントに関連付けられているすべてのリポジトリにアクセスできます。GitHubアカウントの認証は、GitHub Appで行うこともできます。

使用例

コネクターにはいくつかの使用例があります。

プロジェクトマネージャは、オンラインリポジトリからプロジェクトに直接ファイルを追加できます。
提出者ポータルを設定して、提出者がオンラインリポジトリから直接リクエストにファイルを追加できるようにします。
監視対象のファイルまたはフォルダでファイルサイズの変更が検出されたときに新しいプロジェクトが自動的に作成されるよう、プロジェクト自動作成（APC）を設定します。
- このコネクタは絶対パス設定をサポートしています。ターゲット翻訳ファイルは、ソースファイルと同じブランチにのみ保存できます。
継続的ジョブを設定して、選択したファイルの変更を監視します。

GitHub（ベータ版）

備考

このコネクタは2026年6月時点でベータ版です。

認証

GitHub（ベータ版）コネクタは、個人のユーザーアカウントではなくGitHub Appインストールトークンを使用します。トークンは短期間で有効期限が切れ、自動的に更新されます。ユーザーが組織を離れたり、リポジトリへのアクセス権を失ったりした場合でも、コネクタは引き続き機能します。

GitHub（ベータ版）コネクタは、GitHub App認証のみをサポートしています。元のコネクタのOAuthオプションはサポートされていません。

エクスポート

GitHub（ベータ版）コネクタは、1回のエクスポートで出力されるすべてのファイルを1つのコミットと1つのプルリクエストにまとめるため、ファイル数に関係なく、CIはエクスポートごとに1回だけ実行されます。

すべてのコンテンツのリポジトリ所有者、リポジトリ、ブランチが同じ場合、ファイルはまとめて1つのコミットに記録されます。

APCが各ファイルの完了時に個別にアップロードするように設定されている場合、ファイルはまとめて処理されず、それぞれ個別にコミットされます。

コミットメッセージは自動的に生成され、カスタマイズすることはできません。プルリクエストとしてエクスポートする場合、プルリクエスト名とターゲットブランチ名をカスタマイズできます。

エクスポートパスとサブフォルダ

「オンラインリポジトリファイルをパスにエクスポート」のパスが/（絶対パス）で始まる場合、GitHub（ベータ版）コネクタはソースファイルのサブフォルダ構造を保持します。各翻訳ファイルは、

監視対象フォルダに直接あるファイルは、エクスポートパスに直接エクスポートされます。相対エクスポートパスの場合、またはサブフォルダが含まれていない場合は、サブフォルダは追加されません。

絶対エクスポートパスは、ソースブランチのリポジトリルートから始まります。

既知の制限事項

このコネクタは、ファイルのリスト表示、ダウンロード、アップロードのみが可能です。GitHubでのファイルの削除や移動はサポートされていません。削除や名前の変更は、すべてGitHubで直接行う必要があります。
GitHub APIの制限により、ファイル数が50,000を超えるリポジトリでは、ファイルリスト表示が正しく機能しない場合があります。
GitHub Enterprise Serverは現在サポートされていません。
新しいコネクタは、レガシーコネクタのOAuthフローをサポートしていません。組織でGitHub Appのインストールに制限がある場合は、移行前にそれらを解決してください。

新しいGitHub（ベータ版）コネクタへの切り替え

認証モデルの変更により、自動移行はできません。

備考

継続的APCをレガシーコネクタから新しいコネクタに切り替えることは、移行ではありません。Phraseはこれを新しいコネクタ設定として扱うため、APCは既存のジョブを更新するのではなく、ソースファイルを新しいジョブとして再インポートします。ファイルは新しいコンテンツとして扱われるため、以前に処理された単語や機械翻訳ユニット（MTU）は引き継がれません。プロジェクトの途中でコネクタを切り替える場合、影響を受けるファイルの単語数とMTU/クレジットの消費量は、ファイル全体を再インポートした場合と同じになると考えてください。

前提条件：

GitHub Appをインストールするための、GitHub組織への管理者アクセス権。APCが監視するすべてのリポジトリをカバーするように、組織レベルでインストールしてください。
GitHub Appのインストールには、翻訳対象のコンテンツが含まれるリポジトリへのアクセス権が必要です。そうでない場合、APC経由のインポートは失敗します。
既存のAPC設定が表示されていること（古いコネクタを別のタブで開いたままにしてください）。
ライブワークフローを切り替える前に検証するためのテストブランチまたは非本番リポジトリ。

以下の手順に従ってください：

Phrase GitHub Appをインストールします。
1. Phrase TMSの「設定」ページで、下にスクロールして「統合」セクションを表示します。
2. [コネクタ]をクリックします。
  
  「コネクタ」ページが開きます。
3. 「新しいコネクタ」をクリックします。
  
  「コネクタの作成」ページが開きます。
4. 「タイプ」を「GitHub (Beta)」に変更します。
5. 「接続」をクリックします。
  
  PhraseからGitHubにリダイレクトされ、Phrase GitHub Appの承認を求められます。
6. GitHubで組織またはアカウントとリポジトリを選択してアクセス権を付与し、インストールを確認します。既存のコネクタによって現在監視されているすべてのリポジトリを含めます。
  
  GitHubは自動的にPhraseにリダイレクトします。
7. 接続するユーザーまたは組織アカウントを選択します。
新しいコネクタを作成します。
1. Phrase TMSの「設定」ページで、下にスクロールして「統合」セクションを表示します。
2. [コネクタ]をクリックします。
3. 「新しいコネクタ」をクリックします。
4. 最初のステップで設定したGitHub Appインストールを選択します。
5. 既存のコネクタから設定をコピーします。
  - リポジトリとブランチ
  - サブフォルダのパス（サブフォルダを監視する場合）
  - ファイルフィルターの正規表現（設定されている場合）
  - エクスポートモード：直接コミットまたはプルリクエスト、およびターゲットブランチ
  - プルリクエスト名およびターゲットブランチ名（PRモードを使用する場合）
  同じGitHub Appインストールで複数のコネクタを作成でき、それぞれに個別の設定を適用できます。
ドライランモードを使用して既存のAPCを再作成します。

既存のAPCをまだ削除または無効化しないでください。
1. 既存のAPCの設定を再現し、新しいコネクタを使用するAPCを新たに作成します。
2. 新しいAPCをそれぞれ有効にする前に、ドライランモードを有効にします。ドライランモードはリポジトリをスキャンし、翻訳ジョブをトリガーせずにファイルを照合します。
3. 照合されたファイルを確認します。対象範囲が既存のAPCの監視対象と一致していることを確認します。
テストエクスポートで検証します。
1. 監視対象の範囲にあるファイルに小さな変更を加えます。
2. 新しいコネクターを通じてエクスポートを実行します。
3. 以下を確認します。
  - （ファイルごとではなく）単一のコミットが作成されます。
  - コミットは個人アカウントではなく、GitHub Appの名義で表示されます。
  - CIはファイルごとではなく、1回実行されます。
運用中のワークフローを切り替えます。

検証に成功したら、以下を実行します。
1. レガシーコネクターのAPCを無効にします。
2. 新しいコネクターのAPCを有効にします（ドライランモードを解除します）。
3. レガシーコネクターを廃止する前に、1～2回のエクスポートが完了するまで動作を監視します。
レガシーコネクターを廃止します。

新しいコネクターが安定していることを確認したら、以下を実行します。
1. 古いAPCを削除します。
2. [設定] → [コネクター] → [GitHub (レガシー)] からレガシーコネクターを削除します。
3. 必要に応じて、レガシーコネクターで使用していたユーザーアカウントのOAuthトークンを取り消します。

GitHubの設定（レガシー）

変更は不要です。

Phrase TMS設定

注意

カスタムドメイン（例：mydomain.phrase.jp）からアクセスする場合は、シークレットウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.com経由でログインして、コネクターの作成または保存に必要な認証を行ってください。保存後、カスタムドメイン経由でコネクターにアクセスできるようになります。

設定ページで、統合機能セクションまでスクロールします。
[コネクタ]をクリックします。

「コネクタ」ページが開きます。
「新しいコネクター」をクリックします。

「コネクターの作成」ページが開きます。
種類をGitHubに変更し、コネクターの名前を入力します。
必要に応じてカスタムドメインを使用を有効にし、API URLを入力します。
必要に応じて翻訳をプルリクエストとしてエクスポートを選択し、プルリクエストのブランチを入力します。
必要な場合は、GitHubアプリを使用を選択してPhrase GitHubアプリのURLを表示し、GitHubアプリの認証フローを使用してファイルをインポート/エクスポートします：
1. リンクをクリックして、Phrase App Connectorの公式ページを新しいタブで開きます：https://github.com/apps/phrase-app-connector-eu（EUデータセンター）またはhttps://github.com/apps/phrase-app-connector-us（USデータセンター）。
2. 対象のGitHubアカウントにPhrase GitHubアプリをインストールします。
  
  備考
  
  GitHubアプリがユーザーの対象GitHubアカウントにインストールされていない場合、GitHubコネクターからはパブリックリポジトリのみが表示されます。
3. GitHubコネクターから表示およびアクセス可能にするプライベートリポジトリを選択して、インストール手順を完了します。
4. PhraseのConnectors/Createページに戻り、GitHubアプリを認証してGitHubに接続します。
GitHubに接続をクリックします。GitHubアプリを使用して接続していない場合は、認証を求めるポップアップウィンドウまたは新しいタブが表示されます。
必要に応じてコミットメッセージを入力します。
Phraseを認証ボタンをクリックします。

GitHubアプリを使用している場合は、Phrase App Connectorを認証ボタンをクリックします。

成功すると、ウィンドウまたはタブが閉じ、GitHubに接続ボタンの横に小さなチェックマークが表示されます。
保存をクリックします。

コネクターが「コネクター」ページの一覧に追加されます。

注意

GitHubアプリの認証フローを使用してGitHubコネクターを作成した場合、コネクター設定を保存した後に認証方法を変更することはできません。