> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab 同期

> GitLab アカウントをリンクし、プロジェクトをインポートまたはエクスポートし、変更を双方向に同期し、リンクを解除します。

プロジェクトを GitLab リポジトリに接続します。変更は双方向に、**Sync** をクリックしたときにのみ反映されます。自動的に同期されるものはありません。

> [!NOTE]
>
> まず管理者が [GitLab 同期](https://ayakaleaf-pro.mintlify.site/ja/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md) を有効にする必要があります。

## GitLab アカウントをリンクする

これは一度だけ行います。

**1. アカウント設定を開く**

**Account**、続いて **Account settings** をクリックします。**Project synchronisation** の下で **GitLab** を探し、**Link** をクリックします。

![Link ボタンがあるアカウント設定の GitLab セクション](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cd34b300ea3566a7083df441f465a163)

アカウント設定の GitLab

**2. GitLab で承認する**

GitLab が開きます。求められたらサインインし、アプリケーションを承認します。

**3. リンクを確認する**

アカウント設定に戻ります。GitLab アカウントがリンクされたことを示す緑色のメッセージが表示され、ボタンが **Unlink** に変わっています。

![Unlink ボタンがあるアカウント設定の GitLab セクション](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f187b1d6ba770789495f03ecac75c7f7)

GitLab アカウントがリンクされた状態

アカウントがまだリンクされていない場合、**Import from GitLab** とエディターの **GitLab** カードは、まずリンクするよう求めます。**Link to your GitLab account** をクリックします。この場合もアカウント設定に移動し、エディターから始めた場合は新しいタブで開きます。その後、元の画面に戻ってやり直してください。

![Link to your GitLab account ボタンがある Import from GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=50ded943f918001121d5a00ef345d008)

アカウントがリンクされていないときの案内

## リポジトリをインポートする

GitLab リポジトリから、そのリポジトリにリンク済みの新しいプロジェクトを作成します。

**1. インポートダイアログを開く**

プロジェクトページで **New project**、続いて **Import from GitLab** をクリックします。

![Import from GitLab がある New project メニュー](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=4065d1b3b3e2fc5542272e38e2d01f61)

New project メニュー

**2. リポジトリを選ぶ**

リポジトリの横にある **Import to Overleaf** をクリックします。一覧には、自分のリポジトリと所属するグループのリポジトリが含まれます。

![4 つのリポジトリが一覧表示された Import from GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cb0ba36bfa954e101ec1ccd8dac0bca3)

GitLab リポジトリ

**3. プロジェクトを確認する**

新しいプロジェクトが、リポジトリのファイルとともに開きます。

![インポートされたプロジェクトのファイルとコンパイル済み PDF を表示したエディター](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=a467df37fd623dffe523b5a92ebc47c1)

インポートされたプロジェクト

## プロジェクトを新しいリポジトリにエクスポートする

プロジェクトからリポジトリを作成し、両者をリンクします。プロジェクトをリンクできるのは、この方法かインポートだけです。既存のリポジトリにはリンクできません。

**1. エディターで GitLab を開く**

プロジェクトを開きます。左側のバーで **Integrations**、続いて **GitLab** をクリックします。

![GitLab カードがある Integrations パネル](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=df24d11afeb5bbec55a8a745fd58f47a)

Integrations パネル

**2. リポジトリ情報を入力する**

**Owner** を選びます。自分自身か、所属するグループのいずれかです。グループを選ぶと、この欄の名前は **Organization** になります。**Repository Name** の初期値はプロジェクト名です。説明は任意で、**Private** が既定で選択されています。**Create a GitLab repository** をクリックします。

![入力済みの Export Project to GitLab フォーム](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=ba5191a105be584e994ad663565ee511)

Export Project to GitLab

名前がすでに使われている場合、ダイアログに **Please check that the repository name is valid, and that you have permission to create the repository.** と表示されます。名前を変更して、もう一度ボタンをクリックしてください。

**3. リンクを確認する**

ダイアログに **This project is linked to** とリポジトリ名が表示されます。

![エクスポート後の Sync with GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6e18dc3c00fb9a29b3bb2f1a76cec08e)

プロジェクトがリンクされた状態

## 同期する

**1. 同期ダイアログを開く**

リンク済みのプロジェクトを開きます。左側のバーで **Integrations**、続いて **GitLab** をクリックします。

**Recent commits in GitLab** に、プロジェクトに取り込まれる内容が一覧表示されます。

![新しいコミットが 1 つ表示された Sync with GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e67529c0cad7a0cb7eafaa5f8d134b0a)

GitLab で待機中の新しいコミット

**2. 変更内容を記述する**

プロジェクトで何かを変更した場合、コミットメッセージの入力欄が表示されます。入力は任意で、空欄のままにするとコミット名は `Updates from Overleaf` になります。

![コミットメッセージが入力された Sync with GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=45677a6ea3a96235bcde72e1cdaa436a)

変更のコミットメッセージ

**3. Sync をクリックする**

**Sync** をクリックします。GitLab の新しいコミットがプロジェクトに取り込まれ、あなたの変更はリポジトリの既定ブランチに送られます。両側で異なる部分が変更されていれば、自動的にマージされます。

**4. 結果を確認する**

ダイアログに **No new commits in GitLab since last merge.** と表示され、コミットメッセージの入力欄が消えます。エディターのファイルと GitLab のコミットは最新の状態です。

![同期後、新しいコミットがない Sync with GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=74dd7ceacb36ac0289d76504e95e7ba7)

すべて同期済み

### 両側で同じ行が変更された場合

ダイアログに、変更をマージできなかったことと、あなたの変更を保持する新しいブランチ `overleaf-YYYY-MM-DD-HHMMSS` の名前が表示されます。Overleaf は、そのブランチから GitLab 上にマージリクエストも作成します。

![マージコンフリクトの警告が表示された Sync with GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=da33555666132affd667ce24b61221c9)

コンフリクト

1. GitLab 上または Git で、そのブランチを既定ブランチにマージします。その間ダイアログを閉じてもかまいません。もう一度開くと同じメッセージが表示されます。
2. **I have manually merged. Continue** をクリックします。マージされた結果がプロジェクトに取り込まれます。ブランチをマージする前にクリックした場合、ダイアログはそのままです。
3. マージ時に削除しない限り、ブランチは GitLab に残ります。不要になったら削除してください。

コンフリクトする行がなくても、リポジトリのマージルールがマージリクエストを保留した場合（承認が必要な場合など）、同じダイアログが表示されます。ルールが許可したら、GitLab でマージリクエストをマージし、**I have manually merged. Continue** をクリックします。[GitLab との同期の仕組み](https://ayakaleaf-pro.mintlify.site/ja/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#how-syncing-works-with-gitlab) を参照してください。

## プロジェクトのリンクを解除する

プロジェクトの同期をやめたいときに行います。

**1. Unlink をクリックする**

同期ダイアログで **Unlink** をクリックします。

**2. 確認する**

**Confirm** をクリックします。これはリンクを解除するだけです。警告に記載されている、自分が所有するリポジトリへの接続は、解除後に選べるオプションであり、今すぐ行われるものではありません。

![リンク解除の確認を求める Sync with GitLab ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8d7469fda58abd012ed1364f9f54005d)

リンク解除の確認

**3. 結果を確認する**

ダイアログに **Export Project to GitLab** が表示されます。プロジェクトとリポジトリはどちらも内容を保持します。再び同期するには、プロジェクトを新しいリポジトリにエクスポートするか、リポジトリを新しいプロジェクトにインポートします。

## GitLab アカウントのリンクを解除する

**Account settings** の **GitLab** で **Unlink** をクリックし、ダイアログでもう一度 **Unlink** をクリックします。

![Unlink GitLab Account ダイアログ](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=478ab26a1f13d3a9cb08ffc15ad64bc1)

アカウントのリンクを解除する

プロジェクトはそれぞれのリポジトリにリンクされたままです。アカウントを再度リンクするまで、同期はできません。

> [!NOTE]
>
> 共有プロジェクトで誰が何をできるかについては、[リンクと同期ができるユーザー](https://ayakaleaf-pro.mintlify.site/ja/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#who-can-link-and-sync) を参照してください。


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