> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/vi/bao-tri/upgrading-your-deployment.md).
# Nâng cấp bản triển khai của bạn
{% hint style="danger" %}
Điều quan trọng là phải đảm bảo bạn tạo một [bản sao lưu nhất quán](/on-premises/vi/bao-tri/data-and-backups.md#performing-a-consistent-backup) **trước** ở mỗi lần nâng cấp major version để cho phép bạn quay lại nếu cần.
{% endhint %}
Trường [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) là một kho lưu trữ git, vì vậy việc nhận các tính năng mới của Toolkit rất dễ dàng. Chỉ cần chạy `bin/upgrade` lệnh và làm theo các hướng dẫn trên màn hình.
Điều đáng lưu ý là phiên bản ảnh Docker (tại `config/version`) được quản lý riêng biệt với các bản cập nhật mã Toolkit. Việc cập nhật mã Toolkit sẽ **không** tự động thay đổi phiên bản ảnh Docker mà bạn đang chạy. Điều này có nghĩa là trong hầu hết các trường hợp, bạn có thể nâng cấp phiên bản Toolkit mà không cần nâng cấp bản triển khai của mình.
#### Trường `bin/upgrade` Tập lệnh
Khi bạn chạy `bin/upgrade` lệnh, tập lệnh sẽ kiểm tra xem có bản cập nhật nào cho mã Toolkit hay không, và đề nghị cập nhật Toolkit của bạn. Bạn luôn có thể từ chối nâng cấp này, và sẽ không có gì thay đổi.
Nếu bạn chọn cập nhật mã Toolkit, thì tập lệnh sẽ kiểm tra xem *mặc định* phiên bản ảnh Docker mặc định đã thay đổi, và đề nghị nâng cấp tệp phiên bản cục bộ của bạn (tại `config/version`) để khớp với mặc định mới.
Nếu bạn chọn chuyển phiên bản, tập lệnh sẽ hướng dẫn bạn qua quá trình tắt các dịch vụ Docker, sao lưu, và khởi động lại các dịch vụ Docker. Tệp phiên bản cũ của bạn sẽ được tự động sao chép sang `config/__old-version`, phòng khi bạn cần quay lại phiên bản ảnh Docker đó.
{% hint style="danger" %}
Khi thực hiện nâng cấp Server CE/Pro, chúng tôi khuyến nghị nâng cấp lên bản phát hành mới nhất của phiên bản chính đang triển khai **trước** khi nâng cấp lên bản phát hành mới nhất của **phiên bản chính tiếp theo** . Nếu bản triển khai của bạn lạc hậu hơn một phiên bản chính so với bản mới nhất, bạn sẽ phải thực hiện nâng cấp nhiều bước.
Ví dụ: nếu bạn đang chạy 3.5.10, bạn sẽ cần nâng cấp lên 3.5.13 -> Thực hiện di chuyển Full Project History -> 4.2.9 -> 5.5.4.
Bạn nên **không bao giờ** bỏ qua các phiên bản chính (3.5.10 -> 5.5.4). Nếu bạn đang sử dụng Toolkit và lạc hậu hơn một phiên bản chính so với bản mới nhất, bạn phải **không** sử dụng `bin/upgrade` script vì bạn sẽ cần thực hiện nâng cấp thủ công nhiều bước.
{% endhint %}
{% hint style="info" %}
Đối với các thiết lập air-gapped nhập ảnh Docker thủ công, vui lòng đặt `PULL_BEFORE_UPGRADE=false` trong `config/overleaf.rc` trong tệp.
Vui lòng xem [tại đây](/on-premises/vi/cai-dat/air-gapped-offline-deployments.md) để biết thêm thông tin về triển khai trong môi trường air-gapped/ngoại tuyến.
{% endhint %}
### Lộ trình nâng cấp
Trường `bin/upgrade` lệnh sẽ luôn chọn phiên bản Server Pro/CE mới nhất có sẵn vào thời điểm đó. Nếu chu kỳ nâng cấp của bạn không thường xuyên, điều này có thể dẫn đến việc bỏ qua các phiên bản chính và có khả năng nâng cấp lên một phiên bản mà bạn không ngờ tới.
Khi thực hiện nâng cấp, chúng tôi khuyến nghị nâng cấp lên bản phát hành mới nhất của phiên bản chính hiện tại trước khi nâng cấp lên bản phát hành mới nhất của phiên bản chính tiếp theo. Ví dụ, nếu bạn hiện đang chạy 3.3.2 và phiên bản mới nhất có sẵn là 5.3.1, thì lộ trình nâng cấp đúng sẽ là:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Để tránh mọi sự cố khi nâng cấp, chúng tôi khuyến nghị tham khảo [Ghi chú phát hành](https://docs.overleaf.com/on-premises/release-notes) trước khi thực hiện bất kỳ nâng cấp nào vì một số phiên bản có thể yêu cầu các bước bổ sung. Chẳng hạn như thực hiện thay đổi thủ công đối với Toolkit, nâng cấp cơ sở dữ liệu hoặc chạy các tập lệnh di chuyển.
Nếu bạn chưa làm vậy, hãy đăng ký [danh sách gửi thư](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) để bạn có thể được thông báo khi các phiên bản/cập nhật mới được phát hành. Điều này sẽ cho phép bạn lên lịch các khoảng thời gian bảo trì định kỳ bám sát lịch phát hành của chúng tôi.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/on-premises/vi/bao-tri/upgrading-your-deployment.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.