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 (Beta) コネクタは、個人のユーザーアカウントではなくGitHub Appインストールトークンを使用します。トークンは有効期限が短く、自動的に更新されます。ユーザーが組織を離れたり、リポジトリへのアクセス権を失ったりしても、コネクタは引き続き機能します。

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

エクスポート

GitHub (Beta) コネクタは、1回の書き出しに含まれるすべてのファイルを1つのコミットと1つのプルリクエストにまとめるため、ファイル数に関係なく、書き出しごとにCIが1回実行されます。

すべてのコンテンツのリポジトリ所有者、リポジトリ、およびブランチが同じである場合、ファイルは1つのコミットにまとめられます。

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

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

既知の制限事項

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

新しいGitHub (Beta) コネクタへの切り替え

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

備考

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

前提条件:

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

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

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

既存のAPCをまだ削除または無効化しないでください。
1. 既存のAPC構成をミラーリングし、新しいコネクタを指す新しいAPCを作成してください。
2. 各新しいAPCを有効化する前に、ドライランモードを有効にしてください。ドライランモードでは、リポジトリをスキャンしてファイルを照合しますが、翻訳ジョブはトリガーされません。
3. 照合されたファイルを確認してください。スコープが既存のAPCが監視しているものと一致することを確認してください。
テストエクスポートで検証してください。
1. 監視対象スコープ内のファイルに小さな変更を加えてください。
2. 新しいコネクタを通じてエクスポートをトリガーしてください。
3. 確定
  - （ファイルごとに1つではなく）単一のコミットが作成されます。
  - コミットは個人アカウントではなく、GitHub AppのIDで表示されます。
  - CIはファイルごとに1回ではなく、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アプリコネクタを認証ボタンをクリックします。

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

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

注意

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

コネクタの削除

コネクタを削除するには：

統合ページから、削除するコネクタを選択します。
削除をクリックします。

コネクタを削除ウィンドウが開きます。
「delete」と入力し、削除をクリックします。

コネクタが削除され、コネクタのリストが表示されます。

備考

ゴミ箱にあるジョブを含め、プロジェクト内の未完了のジョブにまだリンクされているコネクタは削除できません。そのようなコネクタを削除しようとすると、「コネクタの削除に失敗しました」というエラーが返されます。

解決策：コネクタに関連付けられているプロジェクトを開き、残っているジョブを完了または削除します。設定/ごみ箱に移動し、コネクタにまだリンクされているジョブをすべて削除するために空にします。コネクタの削除を再試行してください。