Skip to main content
CData Arc は、ほとんどのアプリケーション設定に対してGit ベースのバージョン管理をサポートしており、エンタープライズグレードの変更管理をデータ統合プラットフォームにもたらします。この機能により、チームは完全な監査証跡を伴って設定変更を追跡し、テスト環境と本番環境を分離して維持し、正常な状態にロールバックすることで問題から素早く復旧できます。 Git 統合により、チームメンバーは適切な帰属と変更履歴を伴ってArc の設定で共同作業でき、設定エラーのリスクを低減しながらコンプライアンス要件を満たすことができます。組織は、すでにアプリケーションコードに使用しているのと同じ厳格なバージョン管理の手法を、Arc の設定にも適用できます。 Arc はGit バージョン管理を、GitHub、GitLab、Azure DevOps、Bitbucket などのホスト型Git プラットフォームに接続するリモートリポジトリでサポートしています。 デフォルトでは、1つのグローバルリポジトリがArc インスタンス全体を対象とします。個々のワークスペースに専用の別のリポジトリを持たせることもできます。詳細については、グローバルリポジトリとワークスペースリポジトリを参照してください。
Arc は設定ファイル（*.cfg、XML、JSON、バイナリなど）を追跡しますが、Vault とその内容、およびユーザーとロールの2つは例外です。トークン、ユーザー名、パスワードなどの機密値をバージョン管理しないようにするため、CData は、すべての 機密値をVault に保存し、機密値が必要なコネクタではVault のアイテムを参照することを推奨します。追跡されるファイルの種類の完全な一覧については、アーキテクチャを参照してください。ワークスペースに独自のリポジトリがある場合、そのワークスペースのファイルは、グローバルリポジトリではなくワークスペースリポジトリで追跡されます。

​
インストールと設定

​
前提条件

バージョン管理機能を使用する前に、開発環境や本番環境を含むすべてのArc 環境にGit をインストールする必要があります。 リモートリポジトリを使用する場合は、バージョン管理を設定する前にリポジトリを作成する必要があります。Arc は、GitHub、GitLab、Azure DevOps、Bitbucket を含むすべての主要なGit プラットフォームをサポートしています。

​
Git のインストール

Windows
  1. git-scm.com/download/win からGit インストーラーをダウンロードします。
  2. インストーラーを実行し、お好みの設定でインストールウィザードに従います。
  3. コマンドプロンプトまたはPowerShell を開き、次を実行してインストールを確認します。
インストールされたGit のバージョンが出力に表示されるはずです。
Linux Debian/Ubuntu
次を実行します：
Linux Fedora/RHEL/CentOS
次を実行します：
次のコマンドを実行してインストールを確認します：
Git のインストールと確認が完了したら、Arc のバージョン管理機能の使用を開始できます。

​
バージョン管理の設定

バージョン管理は、アプリケーション全体（グローバルリポジトリ）と、必要に応じて個々のワークスペースの2つのレベルで設定できます。2つの関係については、グローバルリポジトリとワークスペースリポジトリを参照してください。

​
グローバルリポジトリの設定

設定 > 高度な設定 > Git バージョン管理に移動してバージョン管理を設定します。詳細については、Git バージョン管理設定を参照してください。 リモートリポジトリの場合は、リポジトリのURL と認証情報を入力します。リモートリポジトリ自体の作成は本ドキュメントの範囲外ですので、お使いのGit プラットフォームのドキュメントを参照してください。例えば、GitHub でHTTPS 認証を使用する場合、認証にはパスワードの代わりにPersonal Access Token（PAT）を使用する必要があります。

​
ワークスペースリポジトリの設定

個々のワークスペースを専用のリポジトリでバージョン管理するには：
  1. ワークスペースを開き、省略記号メニューの設定をクリックします。Git バージョン管理タブをクリックします。
  2. Git バージョン管理を有効にするスイッチをオンにします。グローバルリポジトリがセットアップされている場合は、ワークスペースのバージョン管理を有効にするとグローバルリポジトリから除外され、設定したリポジトリでのみ追跡されることを説明する警告が表示されます。 バージョン管理が有効なワークスペース設定のGit バージョン管理タブ
  3. リポジトリを設定します。フィールドはアプリケーションレベルのリポジトリと同じです。詳細については、Git バージョン管理設定を参照してください。 リモートリポジトリの場合は、リポジトリURL と認証情報を指定します。
  4. 保存をクリックします。
ワークスペースリポジトリには、デフォルトワークスペースに関する制限など、いくつかのルールがあります。詳細については、グローバルリポジトリとワークスペースリポジトリを参照してください。リモートURL は、設定を保存した後でも変更できます（リモートURL の編集を参照してください）。

​
グローバルリポジトリとワークスペースリポジトリ

Arc は2種類のリポジトリをサポートしています：
  • グローバル：設定 > 高度な設定 > Git バージョン管理で設定するアプリケーションレベルのリポジトリです。デフォルトでは、すべてのワークスペースを含むインスタンス全体の設定を追跡します。
  • ワークスペース：グローバルリポジトリとは別に、単一のワークスペースをバージョン管理する任意のリポジトリです。
ワークスペースリポジトリを使用する際は、次の点に注意してください：
  • グローバルリポジトリがセットアップされている場合、ワークスペースリポジトリを有効にすると、ワークスペースはグローバルリポジトリから移動されます。有効にした後は、ワークスペースは設定したリポジトリでのみ追跡されます。
  • 共有リソースはグローバルリポジトリに残ります。ワークスペースが使用する接続、証明書、プロファイルはグローバルリポジトリに残ります。そのため、ワークスペースリポジトリは、ワークスペースに必要なすべてのものの自己完結型のバックアップではありません。
  • ワークスペースリポジトリはグローバルリポジトリから独立しています。グローバルリポジトリをセットアップしているかどうかにかかわらず、ワークスペースリポジトリを有効にできます。
  • デフォルトワークスペースには独自のリポジトリを設定できません。そのGit バージョン管理タブには、デフォルトワークスペースには、別個のGit リポジトリを使用できません。 というメッセージが表示されます。

​
一度に1つのリポジトリ

すべてのバージョン管理アクションは、ちょうど1つのリポジトリ、つまり現在選択しているリポジトリに適用されます。コミット、プッシュ、プル、ブランチ、破棄、復元、およびステータスはすべて選択したリポジトリにのみ適用され、他のリポジトリには適用されません。複数のリポジトリにまたがるアクションはありません。
  • リポジトリリストの行から開始したアクションは、アクションの実行中にアクティブなワークスペースが変わっても、その行のリポジトリに対して実行されます。
  • 進行状況、エラー、および件数はリポジトリごとに個別に追跡されるため、1つのリポジトリでの失敗が別のリポジトリでの作業を妨げることはありません。
デフォルトで選択されるリポジトリは、Arc 内のどこにいるかによって決まります。フローページでは、選択は作業中のワークスペースに従います。それ以外の場所では、選択はグローバルリポジトリです。選択はいつでも変更できます（リポジトリの選択を参照してください）。

​
開発環境

共有された本番環境でArc のバージョン管理を使用する場合、CData は、チームメンバーごとに個別の開発環境をセットアップすることを推奨します。これにより、ユーザーに最良のエクスペリエンスを提供し、複数のユーザーが共有環境で同時に変更をプッシュおよびプルしようとした際に発生し得るコンフリクトを回避できます。 バージョン管理を使用して共有された本番環境で直接作業すると、次のような事態を招く可能性があります：
  • 複数のユーザーが同時に変更を行った際のマージコンフリクト
  • 競合するバージョン管理操作による不十分なユーザーエクスペリエンス
開発環境を使用することで、各チームメンバーは独立して作業し、変更をローカルでテストし、完了した作業を他のメンバーに干渉したり本番運用を妨げたりすることなくリポジトリにプッシュできます。 本番のArc インスタンスをミラーリングするローカル開発環境を設定するには、次の手順に従ってください：
  1. 本番環境からデータ暗号化キーをエクスポートします（キーの使用方法の詳細については、データ暗号化キーとマスターキーについてを参照してください）
    1. 本番環境で、API キーを使用して管理API のexportDataEncryptionKeyエンドポイントを呼び出します。passphrase パラメータを使用して、開発環境にキーをインポートする際に使用するパスフレーズを作成します。
    2. このデータ暗号化キーは開発環境で必要になるため、レスポンスを保存してください。
  2. 本番環境からVault をエクスポートします。
    1. UI を使用する
      1. 設定 > 高度な設定 > 移行 > エクスポートに移動します
      2. カスタムエクスポートを選択してパスワードを作成し、次へをクリックします
      3. 設定タブで、Vaultのみをチェックします
      4. エクスポートをクリックしてエクスポートを実行し、ファイルをダウンロードします
    2. Vault オプションを有効にした管理API のexportエンドポイントを使用する
  3. 開発環境にArc をインストールします（まだインストールされていない場合）
    1. 開発マシンにArc をインストールします
    2. 初期設定を完了し、最初のユーザーアカウントを作成します
    3. 開発用ライセンスをインストールします
    4. API アクセス用のAPI キーを作成します
  4. データ暗号化キーを開発環境にインポートします：開発環境で、API キーを使用して、本番環境からキーをエクスポートした際に使用したのと 同じパスフレーズ で管理API のimportDataEncryptionKeyエンドポイントを呼び出します。これにより、開発環境が同じデータ暗号化キーを使用し、Vault の内容を復号できるようになります。
  5. Vault を開発環境にインポートします
    1. UI を使用する
      1. 設定 > 高度な設定 > 移行 > インポートに移動します
      2. 先ほどエクスポートしたVault ファイルをアップロードします
      3. インポートプロセスを完了します
    2. 管理API のimportエンドポイントを使用して、Vault ファイルをアップロードしてインポートします。
  6. リモートリポジトリをプルして、開発環境を本番の設定と同期します。本番環境の一部のワークスペースに独自のリポジトリがある場合は、それらのリポジトリも設定してプルしてください。接続、証明書、プロファイルなどの共有リソースはグローバルリポジトリに残るため、グローバルリポジトリもプルする必要があります。
    1. UI を使用する
      1. 前提条件の手順に従ってGit をインストールします
      2. 設定 > 高度な設定 > Git バージョン管理に移動します
      3. リモートリポジトリ接続を設定します（手順については、Git バージョン管理設定を参照してください）
      4. リモートリポジトリから最新の変更をプルします
    2. 標準のGit コマンドを使用して、ローカルマシンでリポジトリ接続を設定する
開発環境を設定すると、次のことができるようになります：
  • 本番に影響を与えることなく、ローカルで変更を行いテストする
  • ローカルリポジトリに変更をコミットする
  • 完了した作業をリモートリポジトリにプッシュする
  • 他のチームメンバーが行った更新をプルする
  • 共同開発のために標準のGit ワークフロー（ブランチやプルリクエストなど）に従う
これで、本番環境は、制御されたスケジュールに従って、承認された変更をリモートリポジトリからプルできるようになります。

​
バージョン管理操作

Arc のGit 統合は、設定変更の管理、リモートリポジトリとの同期、複数の開発ブランチの維持を可能にする、不可欠なバージョン管理操作を提供します。これらの操作は標準のGit ワークフローに従いつつ、Arc の設定管理のニーズに合わせて特別に調整されています。 バージョン管理が環境に実装されると、標準のArc フッターは、変更されたローカルファイル数、リモートコミット数、選択したリポジトリ、現在のブランチなどのGit メトリクスとアクションを表示するステータスバーになります。これらすべてのメトリクスとアクションは、選択したリポジトリに適用されます（一度に1つのリポジトリを参照してください）。 選択したリポジトリを表示するGit バージョン管理のフッターツールバー

​
権限

バージョン管理は管理者に制限されています。グローバルリポジトリとワークスペースリポジトリの両方で、バージョン管理ログの表示を含むバージョン管理機能を使用できるのは、Admin ロールのユーザーのみです。それ以外のすべてのユーザーには、UI にバージョン管理のオプションが表示されません。

​
コミットとプッシュ

コミット は、選択したリポジトリ内のすべての設定変更を単一のアトミックな単位として取得し、そのリポジトリに保存します。コミットすると、Arc は自動的にArc のユーザー名を作成者として記録し、変更にタイムスタンプを付けることで、誰がいつどのような変更を行ったかの完全なトレーサビリティを確保します。変更の目的を文書化するために、コミットメッセージが必須です。 プッシュ は、ローカルのコミットをリモートのGit リポジトリに同期し、変更を他のチームメンバーやバックアップシステムが利用できるようにします。まだプルしていない新しい変更がリモートブランチに含まれている場合、プッシュ操作は失敗し、エラーメッセージと次に行うべきことの提案が表示されます。これにより、他のユーザーの作業を上書きすることを防ぎ、適切なマージ処理を確保します。 リモートリポジトリの場合、コミットとプッシュの操作は単一のアクションで処理されます。詳細については、新しい変更のコミットとプッシュを参照してください。

​
プル

プル は、選択したリポジトリのリモートから最新の変更を取得し、ローカルのArc 設定を更新します。Arc がバックグラウンドで自動的にプルすることはありません。プルする前に、コミットされていないローカルの変更をコミットまたは破棄する必要があります。コミットされていない変更が検出された場合、操作は失敗します。ローカルバージョンとリモートバージョンの間にマージコンフリクトがある場合、プルは失敗し、Git ツールを使用して外部でコンフリクトを解決するよう指示するメッセージが表示されます（詳細については、コミットとプルのコンフリクトの管理を参照してください）。プル操作はGit ツールバーから開始できます。詳細については、変更のプルを参照してください。

​
リポジトリの選択

複数のリポジトリが初期化されている場合、ツールバーには検索可能なリポジトリリストが含まれます。これを使用して、すべてのリポジトリの状態を確認し、どのリポジトリを選択するかを選べます。 グローバルリポジトリとワークスペースリポジトリを表示するリポジトリリスト 各リポジトリについて、リストには次の情報が表示されます：
  • Git プロバイダーとリポジトリ名
  • スコープ：グローバル、またはワークスペースの名前
  • 現在のブランチ
  • ローカルの変更数
  • 受信コミット数
リストの各行には、次のアクションがあります：
  • コミット＆プッシュ：そのリポジトリを事前に選択した状態で、ローカル変更フライアウトを開きます。
  • プル：そのリポジトリの受信コミットをプルします。
  • 選択：そのリポジトリを選択したリポジトリにします。現在のリポジトリには、代わりに選択済みと表示されます。
行から開始したアクションは、常にその行のリポジトリに適用されます。リポジトリでコンフリクトが発生している場合、その行にはメッセージ リポジトリ内に競合があります。競合を解決するには、リポジトリに移動してください。 が表示されます。そのリポジトリを開いてコンフリクトを解決してください（コミットとプルのコンフリクトの管理を参照してください）。

​
ブランチ

ブランチ管理により、開発、テスト、本番の各環境など、さまざまな目的に応じた個別の設定バージョンを維持できます。ブランチは1つのリポジトリに属するため、表示されるブランチや行うブランチの変更は、選択したリポジトリにのみ適用されます。ツールバーのブランチドロップダウンを使用して、ブランチの切り替え、新規作成、または古いブランチの削除を行います。新しいブランチを作成する際は、ブランチ名を指定し、どのブランチから作成するかを選択します（デフォルトでは現在のブランチが使用されます）。これにより、メイン環境に影響を与えることなく設定変更を試すことができます。詳細については、ブランチの作成およびブランチの削除を参照してください。

​
ログ記録

すべてのバージョン管理の変更は、アクティビティページの監査ログセクションに記録されます。必要に応じて、そのページからログをダウンロードできます。 バージョン管理の変更の監査ログ

​
履歴ビューア

バージョン管理を有効にすると、アクティビティページにコミット履歴タブが表示されます。これは、一度に1つのリポジトリのコミット履歴を表示し、コミットハッシュ、コミットメッセージ、作成者、日時、各コミットで変更されたファイルのリストなどの詳細を提供します。このタブのコンテンツは検索とフィルタリングが可能です。 Activity ページのコミット履歴タブ
  • Repository フィルタを使用して、テーブルに履歴を表示するリポジトリを選択します。このタブには単一のリポジトリの履歴が表示され、すべてのリポジトリを統合した履歴ではありません。テーブルにはリポジトリ列がなく、すべてのリポジトリを一度に表示するオプションもありません。プルや復元など、行に対するアクションは、履歴を表示しているリポジトリに適用されます。リポジトリが設定されていない場合、タブには No repositories available と表示されます。
  • すべておよびすべてのユーザーフィルタを使用して、結果をさらに絞り込みます。
コミットハッシュをクリックすると、Commit Details ページが開きます。これはファイルの変更タブで開き、コミット内のファイルのdiff ビューを表示するため、何が変更されたかを正確に確認できます。詳細タブをクリックすると、作成者、コミットメッセージ、タイムスタンプが表示されます。 ファイルのdiff ビューを含むコミットの詳細 diff には変更されたすべての設定の以前の値と新しい値が表示されます。なお、以下の点に注意してください：
  • パスワードとシークレットはマスクされます
  • Vault の参照はキーシンボルでプレフィックスが付きます
セクション内のすべての設定を表示をクリックすると、そのセクションのすべての設定（コミットで変更されなかったものを含む）の全リストを確認できます。 すべての設定を表示したコミットの詳細 ファイルの変更タブのリソースに移動リンクをクリックすると、ファイルが変更されたArc の該当箇所に移動します。例えば、MySQL コネクタのdiff を表示している場合、リンクをクリックするとそのMySQL コネクタに移動します。

​
バージョン管理ワークフローの例

以下の例は、Arc のGit 統合を使用する際に遭遇する一般的なバージョン管理のシナリオを示しています。これらのワークフローは、不可欠な操作（リモートリポジトリからの更新のプル、ブランチの作成と削除、変更のコミットとプッシュ、変更の復元、ローカルとリモートの変更が分岐した際のコンフリクトの解決、不要な変更の破棄）をカバーしています。

​
変更のプル

プルは選択したリポジトリに適用されます。別のリポジトリをプルするには、先にそのリポジトリを選択するか、リポジトリリストでその行のプルをクリックします。 リモートから変更をプルするには、いくつかの方法があります：
  • ツールバーのプルをクリックして、コミットを確認せずにプルする
  • ツールバーのコミット数をクリックして、リモートコミットをプルプレビューを開く リモートコミットのプルプレビュー
  • アクティビティページのコミット履歴タブに移動し、左側のリモートコミット数へのリンクまたは右側のプルボタンをクリックして、リモートコミットをプルプレビューを開く
リモートコミットをプルプレビューには、プルする準備ができているすべてのコミットが一覧表示されます。コミットをクリックして詳細を確認し、ファイル数にカーソルを合わせると、コミットに含まれるファイルを確認できます。タスクを完了するには、コミットをプルをクリックします。 リモートコミットのプルの確認ダイアログ

​
ブランチの作成

新しいブランチを作成するには、ツールバーのブランチアイコンをクリックします（ここでブランチを切り替えることもできます）。 ツールバーのブランチ切り替え ブランチを追加をクリックし、ブランチに名前を付けます。どのブランチからコピーするかを選択し、追加をクリックします。 ブランチの追加ダイアログ

​
ブランチの削除

ブランチを削除するには、ツールバーのブランチアイコンをクリックします。削除したいブランチにカーソルを合わせ、ゴミ箱アイコンをクリックします。 ブランチの削除ダイアログ

​
新しい変更のコミットとプッシュ

Arc で変更を行っている際、ツールバーには選択したリポジトリで変更されたファイルの合計数が表示されます。 変更されたファイル数を表示するGit ツールバー コミット＆プッシュをクリックして、ローカル変更フライアウトを開きます。これは、選択したリポジトリで変更したファイルに関する詳細を表示します。変更をコミットしてリモートにプッシュするには、コミットメッセージを入力する必要があります。 フライアウトのヘッダーには、コミット先のリポジトリの名前、スコープ（グローバルまたはワークスペース名）、およびブランチを表示するリポジトリセレクターが含まれます。更新アイコンとヘルプアイコン、およびコミット対象として選択されている変更リソースの数を示すボタンも用意されています。リソースを選択リストのチェックボックスを使用して、コミットに含める変更リソースを選択します。 ヘッダーにリポジトリセレクターを含むローカル変更フライアウト 別のリポジトリにコミットするには、ヘッダーのリポジトリセレクターをクリックし、目的のリポジトリの横にある選択をクリックします。変更されたファイル、ブランチ、ステータス、コミットメッセージが、選択したリポジトリに合わせて更新されます。 ローカル変更フライアウトで開いたリポジトリセレクター
リモートリポジトリの場合、コミットとプッシュは単一のステップで行われます。ローカルにコミットしてからプッシュするのではありません。
変更をコミットしてプッシュすると、ツールバーの確認メッセージがアクションの結果を知らせます。

​
以前のリビジョンからの変更の復元

リソースを以前の状態に復元するには、アクティビティページのコミット履歴タブに移動し、Repository フィルタを使用してリソースを含むリポジトリを選択します。復元はそのリポジトリにのみ適用されます。変更ファイル列の右側にある省略記号をクリックし、復元をクリックします。現在の状態と提案される復元ポイントの状態の間のdiff を確認し、次へをクリックします。復元を続行すると、それらのファイル内のコミットされていない変更が完全に失われることに注意してください。タスクを完了するには、リソースを復元をクリックします。

​
コミットとプルのコンフリクトの管理

プッシュするローカルの変更があり、同時にプルするリモートの変更もある場合に、コンフリクトが発生する可能性があります。コンフリクトはリポジトリごとに追跡されます。1つのリポジトリでのコンフリクトが、別のリポジトリでのアクションを妨げることはありません。ツールバーはコンフリクトを反映し、進め方の提案を提供します。同じエラーメッセージは、コミットおよびリモートコミットをプルプレビューページにも表示されます。リポジトリリストでは、コンフリクトが発生しているリポジトリに、リポジトリ内に競合があります。競合を解決するには、リポジトリに移動してください。 というメッセージが表示されます。 ツールバーのコミットとプルのコンフリクトメッセージ 1つの選択肢はコンフリクトを手動で管理することであり、もう1つは現在の変更を別のブランチにコミットすることです。これにより、リモートの変更を現在のブランチにプルできるようになります。 Please commit to a new branch をクリックすると、コミット先の別のブランチを選択できるページが開きます。新しいブランチを選択（または作成）したら、変更をコミット＆プッシュを使用して変更をプッシュできます。

​
変更の破棄

選択したリポジトリの現在の変更を破棄するには、ツールバーのゴミ箱アイコンをクリックします。これにより、変更を破棄ペインが開き、破棄する変更を正確に選択できます。次へをクリックし、選択が正しいことを確認してから、変更を破棄をクリックします。完了すると、確認メッセージが表示され、ツールバーの変更数が破棄された変更の数だけ減少します。 ローカル変更フライアウトで変更を破棄することもできます。破棄するリソースを選択し、コミット…ボタンのドロップダウン矢印を使用して変更を破棄を選択します。選択内容を確認してから、変更を破棄をクリックします。

​
リモートURL の編集

バージョン管理が初期化された後でも、リポジトリのURL を変更できます。すでにリモートに接続されているリポジトリのリモートURL を変更するには：
  1. リポジトリのバージョン管理の設定を開きます。グローバルリポジトリの場合は、設定 > 高度な設定 > Git バージョン管理に移動します。ワークスペースリポジトリの場合は、ワークスペースを開き、省略記号メニューの設定をクリックします。Git バージョン管理タブをクリックします。
  2. リポジトリURL と、必要に応じて認証情報を編集します。
  3. 保存をクリックします。
Arc はリモートを更新し、認証情報を適用します。