> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/vi/bao-tri/upgrading-your-deployment.md).
# Nâng cấp triển khai của bạn
{% hint style="danger" %}
Điều quan trọng là phải đảm bảo rằng bạn thực hiện 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** cho mỗi lần nâng cấp major version để bạn có thể khôi phục nếu cần.
{% endhint %}
Trường [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) là một kho lưu trữ git, nên rất dễ để nhận các tính năng Toolkit mới. 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.
Cần lưu ý rằng phiên bản image Docker (tại `config/version`) được quản lý riêng 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 của image 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 khả dụng cho mã Toolkit hay không, và sẽ đề 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, tập lệnh sẽ kiểm tra xem *mặc định* phiên bản image Docker mặc định đã thay đổi, và sẽ đề 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 quy trình tắt các dịch vụ Docker, sao lưu, rồi khởi động lại các dịch vụ Docker. Tệp phiên bản cũ của bạn sẽ tự động được sao chép vào `config/__old-version`, phòng khi bạn cần quay lại phiên bản đó của các image Docker.
{% hint style="danger" %}
Khi thực hiện nâng cấp Server CE/Pro, chúng tôi khuyên bạn nên nâng cấp lên bản phát hành mới nhất của major version đ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 **tiếp theo** major version. Nếu bản triển khai của bạn đang lạc hậu hơn một major version so với bản mới nhất, bạn sẽ cần 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 Toàn bộ Lịch sử Dự án -> 4.2.9 -> 5.5.4.
Bạn nên **không bao giờ** bỏ qua các major version (3.5.10 -> 5.5.4). Nếu bạn đang dùng Toolkit và đang lạc hậu hơn một major version 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 một nâng cấp nhiều bước thủ công.
{% endhint %}
{% hint style="info" %}
Đối với các thiết lập air-gapped nhập image Docker thủ công, vui lòng đặt `PULL_BEFORE_UPGRADE=false` trong tệp `config/overleaf.rc` tệp.
Vui lòng kiểm tra [tại đây](/on-premises/vi/cai-dat/air-gapped-offline-deployments.md) để biết thêm thông tin về việc triển khai trong các 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 mới nhất của Server Pro/CE mà nó 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 lớn 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 lớn 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 lớn tiếp theo. Ví dụ, nếu bạn đang chạy 3.3.2 và phiên bản mới nhất hiện có là 5.3.1, 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 bất kỳ sự cố nâng cấp nào, chúng tôi khuyến nghị bạn 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ý vào [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/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 cửa sổ bảo trì định kỳ phù hợp chặt chẽ với 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://ayakaleaf-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.