GitHub (TMS)

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

利用可能対象

Team、BusinessおよびEnterpriseプラン

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

利用可能対象

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

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

ヒント

Phrase StringsにおけるGitHub統合機能の詳細については、GitHub (Strings)を参照してください。

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

このコネクターはGitHub APIを使用して統合機能を実装します。このコネクターにより、GitHubアカウントに関連付けられたすべてのリポジトリへのアクセスが可能になります。GitHubアカウントの認証は、GitHubアプリで行うこともできます。

使用例

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

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

GitHub (ベータ版)

備考

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

認証

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

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 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. 確定:
  - コミットは1つだけ作成されます（ファイルごとに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 を入力します。
オプションで翻訳をプルリクエストとしてエクスポートを選択し、プルリクエストブランチを指定します。
必要に応じて、Use Github appを選択して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に接続します。
Connect to GitHubをクリックします。GitHubアプリを使用して接続していない場合は、認証を求めるポップアップウィンドウまたは新しいタブが表示されます。
必要に応じてCommit messageを入力します。
Authorize Phraseボタンをクリックします。

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

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

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

注意

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

コネクターを削除する

コネクターを削除するには:

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

Delete connectorウィンドウが開きます。
「delete」と入力し、Deleteをクリックします。

コネクターが削除され、コネクターの一覧が表示されます。

備考

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

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