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 (Beta)

備考

コネクターは2026年6月現在ベータ版です。

認証

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

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

エクスポート

GitHub（ベータ）コネクターは、単一のエクスポートからすべてのファイルを1つのコミットと1つのプルリクエストにバッチ処理するため、ファイル数に関係なく、エクスポートごとにCIが1回実行されます。

すべてのコンテンツが同じリポジトリオーナー、リポジトリ、およびブランチを共有する場合、ファイルは単一のコミットにバッチ処理されます。

APCがファイルを個別に完了するたびにアップロードするように設定されている場合、各ファイルはバッチ処理されるのではなく、個別にコミットされます。

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

既知の制限

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

新しいGitHub（ベータ）コネクターへの移行

認証モデルの変更により、自動移行は不可能です。

前提条件:

GitHubアプリをインストールするためのあなたのGitHub組織への管理者アクセス。すべてのリポジトリをカバーするように、組織レベルでインストールしてください。
既存のAPC設定が表示されます（古いコネクターを別のタブで開いておいてください）。
本番環境に切り替える前に検証するためのテストブランチまたは非本番リポジトリ。

これらの手順に従ってください：

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

既存のAPCを削除または無効にしないでください。
1. 新しいコネクターを指す新しいAPCを作成し、既存のAPC設定をミラーリングします。
2. 各新しいAPCを有効化する前にドライランモードを有効にします。ドライランモードはリポジトリをスキャンし、翻訳ジョブをトリガーせずにファイルを一致させます。
3. 一致したファイルを確認します。スコープが既存のAPCが監視している内容と一致していることを確認します。
テストエクスポートで検証します。
1. 監視範囲内のファイルに小さな変更を加えます。
2. 新しいコネクターを通じてエクスポートをトリガーします。
3. 確認:
  - 1つのコミットが作成されます（ファイルごとではありません）。
  - コミットはGitHubアプリのアイデンティティの下に表示され、個人アカウントではありません。
  - 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に変更し、コネクターの名前を提供します。
オプションで、翻訳をプルリクエストとしてエクスポートを選択し、プルリクエストブランチを提供します。
必要に応じて、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 コネクター/作成ページに戻って、GitHubアプリを認証し、GitHubに接続します。
GitHubに接続をクリックします。GitHubアプリを使用して接続していない場合、認証を要求するポップアップウィンドウまたは新しいタブが表示されます。
必要に応じて、コミットメッセージを提供します。
Phraseを認証ボタンをクリックします。

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

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

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

注意

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