> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Git バージョン管理設定

Git バージョン管理を設定して、CData Sync ワークスペースをGit リポジトリに接続し、変更の追跡を有効にできます。バージョン管理はワークスペースごとに設定されます。各ワークスペースは単一のリポジトリおよびブランチに接続し、この関連付けは初期化後に変更できません。

バージョン管理を設定する前に、以下の要件を満たしていることを確認してください：

* Git リポジトリへのアクセス権
* そのリポジトリの有効な認証情報

## Git バージョン管理の設定

ワークスペースのバージョン管理を設定するには：

1. Sync ワークスペースを開きます。
2. **ワークスペース設定 > Git Version Control** に移動します。

   ![Git バージョン管理設定ページ](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration_accessing-version-control-settings_1.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=d2d9ba257cdd8cdb52cf54cbfbad1904)

   この操作により、**Configure Git Version Control** ダイアログが開きます。

   ![Git バージョン管理ダイアログ](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration_accessing-version-control-settings_2.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=5dce001e2038bc77539ba5c161ceb174)
3. **Repo Details** ページで、リポジトリ接続と認証の詳細を指定します：
   * **Git Repository URL：** Git リポジトリのURL を入力します。
   * **Auth Scheme：** 認証スキームを選択します。
     * **HTTPS：** このスキームでは、以下のオプションを指定します：
       * **Username：** リモートGit ホスティングサービス（例：GitHub、GitLab、Azure DevOps）のアカウントユーザー名を入力します。
       * **Password/Token：** リモートGit ホスティングサービスのパスワードまたはパーソナルアクセストークン（PAT）を入力します。

         > [!NOTE]
         >
         > * PAT には、リポジトリの内容に対する読み取りおよび書き込み権限が必要です。
         > * GitHub アカウントのパスワードおよび読み取り専用のPAT は、プッシュ操作には使用できません。
     * **SSH：** このスキームでは、以下のオプションを指定します：

       * **SSH Private Key：** **Choose File** をクリックして、SSH 秘密鍵を含むファイルを選択します。
       * （オプション）**Passphrase：** SSH 秘密鍵の生成時に設定したパスフレーズを入力します。秘密鍵がパスフレーズで暗号化されている場合、Sync が鍵を復号して使用できるよう、ここに入力する必要があります。パスフレーズなしで鍵を生成した場合は、このフィールドを空欄のままにします。

       > [!NOTE]
       >
       > SSH 認証は、Sync セルフホスト環境でのみ利用できます。
     * **OAuth：** このスキームでは、**Get Access Token** をクリックします。まだGit ホスティングサービスにログインしていない場合、Microsoft Azure のログイン画面が表示されます。認証が完了すると、**Repo Details** ページの**Get Access Token** ボタンの右側に、確認メッセージ**Access token ready - save to apply** が表示されます。

       > [!NOTE]
       >
       > OAuth 認証は、追加設定なしでセットアップとプッシュ操作の両方をサポートします。
4. **Next** をクリックして**Select Branch** ページに進みます。
5. **Branch** リストからバージョン管理の対象とするブランチを選択するか、**Create New Branch** をクリックして新しいブランチを作成します。

   ![ブランチの選択または作成](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration_accessing-version-control-settings_3.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=791ef75c9c36464faff875ac96b7db92)
6. **Next** をクリックして**Complete Setup** ページに進みます。
7. **Complete Setup** ページで、選択したブランチが正しいことを確認します。

   ![Complete Setup ページ](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration_accessing-version-control-settings_4.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=454661ec0e1d86ae2d45f8350105497f)

   選択したブランチにすでにSync のワークスペース設定が含まれている場合、以下のようにSync が暗号化キーのインポートを求めます。

   ![暗号化キーのインポート](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration_accessing-version-control-settings_5.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=dda8e7f8981d960e80ee304d1c204987)

   **Choose File** をクリックし、このリポジトリの暗号化キーファイルを選択します。

   > [!NOTE]
   >
   > * 元のSync インスタンスからまだキーをエクスポートしていない場合は、続行する前に[暗号化キーのエクスポート](#暗号化キーのエクスポート)を参照してください。
   > * 暗号化キーのインポート時に間違ったパスワードを入力すると、Sync はエラーを表示し、セットアップを完了しません。
8. **Complete Setup** をクリックします。

ダイアログを終了すると、Sync はワークスペースのバージョン管理を初期化し、指定したリポジトリおよびブランチに接続します。**ワークスペース設定**ページに、バージョン管理設定を含むカテゴリが表示されます。

## バージョン管理の削除

バージョン管理を削除するには：

1. **ワークスペース設定 > Git Version Control** に移動します。

   ![削除アイコンを示すバージョン管理設定](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration_removing-version-control_1.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=f43a6b195a6ebd3c42f1a67cd9d7dc99)

2. **削除**アイコン（![削除アイコン](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Delete_TrashCan_icon.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=bfe6164160ef650e0fa133922caa498b)）をクリックします。

接続を削除すると、ワークスペースとGit リポジトリの関連付けが解除されます。

## 暗号化キーのエクスポート

Sync は、機密性の高い設定データをリポジトリにコミットする前に暗号化します。この暗号化キーは、Sync インスタンスがリポジトリに対してバージョン管理を初期化する際に最初に作成され、そのリポジトリに固有のものです。

別のSync インスタンスを同じリポジトリに接続する場合、そのインスタンスは元の暗号化キーにアクセスできません。新しいインスタンスにアクセス権を付与するには、元のインスタンスからキーをエクスポートし、**Complete Setup** の手順でインポートできるようにする必要があります。

新しいSync インスタンスを既存のリポジトリに接続するには、まず元のインスタンスから暗号化キーをエクスポートし、次に[セットアッププロセスの手順7](#complete-setup)でインポートする必要があります。

元のSync インスタンスから暗号化キーをエクスポートするには：

1. リポジトリを最初に初期化したSync インスタンスを開き、**ワークスペース設定**ページのGit 設定エリアに移動します。

2. **Encryption Key** セクションで**Export** をクリックします。

   ![Export ボタンを示すEncryption Key セクション](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Git-Version-Control-Configuration-for-Workspaces_importing-encryption-key-when-connecting-to-existing-git-repository_1.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=ba468f9ea48c30d1352885d08ed1d321)

3. **Export Encryption Key** ダイアログで、エクスポートしたキーファイルを保護するパスワードを入力します。

   ![Export Encryption Key ダイアログ](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Git-Version-Control-Configuration-for-Workspaces_importing-encryption-key-when-connecting-to-existing-git-repository_2.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=cfa1b89fb68b6af5250cb98d3833eebe)

4. **Export** をクリックします。

## 既知の制限事項と問題

Git バージョン管理には以下の制限事項があります：

* ワークスペースは1つのブランチにのみ接続できます。
* 設定したブランチは、初期化後に変更できません。

バージョン管理を削除する際に、次の問題が発生することもあります：

* 一部の環境では、ファイル権限によりリポジトリファイルを削除できない場合、バージョン管理の削除が失敗することがあります。この状況は、`.git` ディレクトリ内のファイルが読み取り専用の場合に発生することがあります。
* この問題が発生した場合は、バージョン管理を再接続する前に、手動でリポジトリファイルを削除する必要がある場合があります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.