> ## 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.

# Đồng bộ hóa GitLab

> Liên kết tài khoản GitLab, nhập hoặc xuất dự án, đồng bộ thay đổi hai chiều và hủy liên kết.

Kết nối dự án với một kho GitLab. Thay đổi đi theo cả hai chiều, và chỉ khi bạn nhấp vào **Sync**: không có gì tự đồng bộ.

> [!NOTE]
>
> Quản trị viên phải bật [Đồng bộ hóa GitLab](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md) trước.

## Liên kết tài khoản GitLab

Bạn chỉ làm việc này một lần.

**1. Mở cài đặt tài khoản**

Nhấp vào **Account**, sau đó **Account settings**. Trong **Project synchronisation**, tìm **GitLab** và nhấp vào **Link**.

![Mục GitLab trong cài đặt tài khoản với nút Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cd34b300ea3566a7083df441f465a163)

GitLab trong cài đặt tài khoản

**2. Ủy quyền trên GitLab**

GitLab mở ra. Đăng nhập nếu được yêu cầu, sau đó ủy quyền cho ứng dụng.

**3. Kiểm tra liên kết**

Bạn quay lại cài đặt tài khoản. Một thông báo màu xanh lá cho biết tài khoản GitLab của bạn đã được liên kết, và nút giờ hiển thị **Unlink**.

![Mục GitLab trong cài đặt tài khoản với nút Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f187b1d6ba770789495f03ecac75c7f7)

Tài khoản GitLab của bạn đã được liên kết

Nếu tài khoản của bạn chưa được liên kết, **Import from GitLab** và thẻ **GitLab** trong trình soạn thảo sẽ yêu cầu bạn liên kết trước. Nhấp vào **Link to your GitLab account**. Bạn cũng sẽ đến cài đặt tài khoản, trong một tab mới nếu bạn bắt đầu từ trình soạn thảo. Sau đó quay lại và bắt đầu lại.

![Hộp thoại Import from GitLab với nút Link to your GitLab account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=50ded943f918001121d5a00ef345d008)

Lời nhắc khi tài khoản chưa được liên kết

## Nhập kho

Thao tác này tạo một dự án mới từ kho GitLab, đã được liên kết sẵn với kho đó.

**1. Mở hộp thoại nhập**

Trên trang dự án, nhấp vào **New project**, sau đó **Import from GitLab**.

![Menu New project với Import from GitLab](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)

Menu New project

**2. Chọn kho**

Nhấp vào **Import to Overleaf** bên cạnh kho. Danh sách gồm các kho của bạn và của các nhóm của bạn.

![Hộp thoại Import from GitLab liệt kê bốn kho](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cb0ba36bfa954e101ec1ccd8dac0bca3)

Các kho GitLab của bạn

**3. Kiểm tra dự án**

Dự án mới mở ra với các tệp của kho.

![Trình soạn thảo hiển thị dự án đã nhập cùng các tệp và PDF đã biên dịch](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=a467df37fd623dffe523b5a92ebc47c1)

Dự án đã nhập

## Xuất dự án sang kho mới

Thao tác này tạo một kho từ dự án và liên kết chúng. Dự án chỉ có thể được liên kết theo cách này hoặc bằng cách nhập: bạn không thể liên kết nó với một kho đã tồn tại.

**1. Mở GitLab trong trình soạn thảo**

Mở dự án. Ở thanh bên trái, nhấp vào **Integrations**, sau đó **GitLab**.

![Bảng Integrations với thẻ GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=df24d11afeb5bbec55a8a745fd58f47a)

Bảng Integrations

**2. Điền thông tin kho**

Chọn **Owner**, có thể là bạn hoặc một trong các nhóm của bạn. Khi bạn chọn một nhóm, trường này có tên **Organization**. **Repository Name** ban đầu là tên dự án. Mô tả là tùy chọn, và **Private** được chọn theo mặc định. Nhấp vào **Create a GitLab repository**.

![Biểu mẫu Export Project to GitLab đã điền](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

Nếu tên đã được dùng, hộp thoại hiển thị **Please check that the repository name is valid, and that you have permission to create the repository.** Đổi tên và nhấp lại vào nút.

**3. Kiểm tra liên kết**

Hộp thoại giờ hiển thị **This project is linked to** và tên kho.

![Hộp thoại Sync with GitLab sau khi xuất](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6e18dc3c00fb9a29b3bb2f1a76cec08e)

Dự án đã được liên kết

## Đồng bộ

**1. Mở hộp thoại đồng bộ**

Mở một dự án đã liên kết. Ở thanh bên trái, nhấp vào **Integrations**, sau đó **GitLab**.

**Recent commits in GitLab** liệt kê những gì sẽ vào dự án.

![Hộp thoại Sync with GitLab liệt kê một commit mới](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e67529c0cad7a0cb7eafaa5f8d134b0a)

Một commit mới đang chờ trên GitLab

**2. Mô tả thay đổi của bạn**

Nếu bạn đã thay đổi gì đó trong dự án, một ô nhập thông điệp commit sẽ xuất hiện. Ô này là tùy chọn: nếu bạn để trống, commit có tên `Updates from Overleaf`.

![Hộp thoại Sync with GitLab với thông điệp commit đã điền](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=45677a6ea3a96235bcde72e1cdaa436a)

Thông điệp commit cho thay đổi của bạn

**3. Nhấp vào Sync**

Nhấp vào **Sync**. Các commit mới từ GitLab vào dự án, và thay đổi của bạn đi đến nhánh mặc định của kho. Nếu hai phía thay đổi những phần khác nhau, chúng được hợp nhất giúp bạn.

**4. Kiểm tra kết quả**

Hộp thoại hiển thị **No new commits in GitLab since last merge.** và ô thông điệp commit biến mất. Các tệp trong trình soạn thảo và các commit trên GitLab đều đã cập nhật.

![Hộp thoại Sync with GitLab sau khi đồng bộ, không có commit mới](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=74dd7ceacb36ac0289d76504e95e7ba7)

Mọi thứ đã được đồng bộ

### Nếu cùng các dòng đã thay đổi ở cả hai phía

Hộp thoại cho biết không thể hợp nhất các thay đổi và nêu tên một nhánh mới, `overleaf-YYYY-MM-DD-HHMMSS`, chứa thay đổi của bạn. Overleaf cũng mở một merge request từ nhánh đó trên GitLab.

![Hộp thoại Sync with GitLab với cảnh báo xung đột hợp nhất](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=da33555666132affd667ce24b61221c9)

Xung đột

1. Hợp nhất nhánh đó vào nhánh mặc định trên GitLab hoặc bằng Git. Trong lúc đó, bạn có thể đóng hộp thoại: nó hiển thị cùng thông báo khi bạn mở lại.
2. Nhấp vào **I have manually merged. Continue**. Kết quả đã hợp nhất vào dự án. Nếu bạn nhấp trước khi nhánh được hợp nhất, hộp thoại vẫn giữ nguyên.
3. Nhánh vẫn ở trên GitLab, trừ khi bạn đã xóa nó khi hợp nhất. Hãy xóa nó khi bạn không còn cần.

Hộp thoại tương tự xuất hiện khi quy tắc hợp nhất của kho giữ merge request lại, chẳng hạn khi cần phê duyệt, ngay cả khi không có dòng nào xung đột. Khi quy tắc cho phép, hãy hợp nhất merge request trên GitLab và nhấp vào **I have manually merged. Continue**. Xem [Cách đồng bộ hoạt động với GitLab](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#how-syncing-works-with-gitlab).

## Hủy liên kết dự án

Làm việc này khi bạn không còn muốn dự án đồng bộ.

**1. Nhấp vào Unlink**

Trong hộp thoại đồng bộ, nhấp vào **Unlink**.

**2. Xác nhận**

Nhấp vào **Confirm**. Thao tác này chỉ gỡ liên kết: việc kết nối với một kho bạn sở hữu, được đề cập trong cảnh báo, là một tùy chọn bạn có sau đó, không phải điều xảy ra ngay bây giờ.

![Hộp thoại Sync with GitLab yêu cầu xác nhận hủy liên kết](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8d7469fda58abd012ed1364f9f54005d)

Xác nhận hủy liên kết

**3. Kiểm tra kết quả**

Hộp thoại giờ hiển thị **Export Project to GitLab**. Cả dự án và kho đều giữ nguyên nội dung. Để đồng bộ lại, hãy xuất dự án sang một kho mới, hoặc nhập kho vào một dự án mới.

## Hủy liên kết tài khoản GitLab

Trong **Account settings**, ở mục **GitLab**, nhấp vào **Unlink**, sau đó nhấp **Unlink** lần nữa trong hộp thoại.

![Hộp thoại 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)

Hủy liên kết tài khoản

Các dự án của bạn vẫn liên kết với kho của chúng. Bạn không thể đồng bộ chúng cho đến khi liên kết lại tài khoản.

> [!NOTE]
>
> Để biết ai có thể làm gì trong dự án chia sẻ, hãy xem [Ai có thể liên kết và đồng bộ](https://ayakaleaf-pro.mintlify.site/vi/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.