ギットハブコネクタ

概要

このページでは、GitHub コネクタが、一連の GitHub リポジトリで発生した変更に基づいてプロジェクトを監視および作成する方法を示します。

汎用

GitHub コネクタは、一定の時間間隔を指定して、GitHub リポジトリ内の特定のファイルを監視します。通常、ローカリゼーションプロジェクトでは、一般的なファイルはJSON、YML、XLIFF、XML、STRINGS、またはその他の構造化された予測可能な形式です。ファイル ハッシュを同じファイルに対して以前に実行された翻訳のリポジトリと比較することにより、変更が検出された場合は新しいプロジェクトが作成され、翻訳プロジェクトが開始されます。

モニタリング戦略

私たちは、そのREST APIを使用してGitHubリポジトリを監視することができます。そのためには、クライアントは、APIにアクセスするために、ビューローワークスでトークンを作成するアカウントを承認する必要があります。これらの資格情報は AES 256 で暗号化され、クライアントのプロファイルに格納されます。

監視戦略には、 分岐 と プル要求の 2つがあります。

枝

コネクタは、1 つ以上のリポジトリ内の 1 つ以上のブランチを常に監視し、監視対象のファイルが変更されると、ビューローワークスにプロジェクトを作成し、チームに通知します。継続的なローカリゼーション プロジェクトでは、以前に翻訳された文字列が完全に考慮されます。

プロジェクトが配信されると、GitHub コネクタは、翻訳が完了した後、ファイルを含むパッチブランチのプルリクエストを作成します。出力ファイルの出力パスと命名方法をカスタマイズできます。これは、チームが開発のために1つまたは少数のブランチを使用する傾向がある場合に、非侵入的で非常にエレガントな配信メカニズムを作成します。

プル要求

ブランチ戦略と同様に、Gitflow または同様のワークフローを使用しているチームのプルリクエストも監視できます。コネクターは、すべての分岐に対して、同じ構成済みファイルのすべてのプル要求をモニターできます。繰り返しますが、ファイルのハッシュに基づいて違いが見つかると、プロジェクトが作成されます。

この戦略との大きな違いは、配信メカニズムです。プル要求はブランチを参照するため、プロジェクトが配信されると、コネクタはプル要求と同じブランチにコミットを作成します。プル要求が受け入れられ、マージされると、翻訳されたファイルがターゲットブランチ(マスター、開発など)に沿って運ばれます。

オーソス・ビューロー・ワークス

GitHub コネクタをセットアップするために、まず、リポジトリにアクセスするビューロー Works を承認する必要があります。セキュリティの追加レイヤーとして、組織内の目的のリポジトリに排他的にアクセスできるユーザーを作成することをお勧めします。

GitHub 承認ワークフローが表示されない場合は、アカウントに適切なロールが適用されていない可能性があります。組織の連絡先に連絡してください、またはその人があなたなら、私たちにメールを送ってください help@bureauworks.com.

1.ビューの右上 にあるマイアカウントを開きます 。

2.上部のバーで 、[GitHub の接続] を選択します。

3.ビューローワークスに接続するアカウントを使用して GitHub にサインインします。

4.GitHub は、ビューローワークスに戻って、認証が成功した場合にメッセージを表示します。

監視および配信パスの提供

ビューローワークスを承認したら、監視が必要なファイルとリポジトリのパスを提供する必要があります。たとえば、iOS プロジェクトでは、Localizable.strings という名前のファイルを各言語フォルダーに配置するのが一般的です。

en.lproj/Localizable.strings # ソース
pt-BR.lproj/ローカライズ可能.文字列 # ターゲット
A.lproj/Localizable.strings # ターゲット B
..

ソースファイルと、翻訳を配信するためのパスを決定する必要があります。選択した戦略に応じて、GitHub コネクタによって実行されるすべての配信は、GitHub リポジトリの正しいフォルダー構造にファイルを配置します。

このステップは、私たちのチームによって実行され、help@bureauworks.comでのサポートを介して管理されています 。

セキュリティとプライバシー

各 GitHub コネクタ インスタンスはクライアント専用で、別のコンテナーで実行され、ビューローワークスのクライアントのプロファイルにバインドされた GitHub トークンにのみアクセスできます。トークンが作成されると、プル要求とコミットを適切に作成するために、その組織内のパブリックリポジトリとプライベートリポジトリにBureau Works acce/zoosが付与されます。

チームは暗号化されたトークンにアクセスできないため、API経由でリポジトリにアクセスすることはできません。必要に応じて詳細な監査証跡を提供し、GitHub システムはトークンの使用状況も追跡します。