請務必在每次主要版本升級之前進行一致性備份,以便在需要時能夠復原。
bin/upgrade 指令並依照螢幕上的提示操作即可。
值得注意的是,Docker 映像檔版本(位於 config/version)與 Toolkit 程式碼更新是分開管理的。更新 Toolkit 程式碼不會自動變更您正在執行的 Docker 映像檔版本。這表示在大多數情況下,您可以升級 Toolkit 版本而不需升級您的部署。
bin/upgrade 腳本
當您執行 bin/upgrade 指令時,腳本會檢查 Toolkit 程式碼是否有可用的更新,並詢問是否要更新您的 Toolkit。您隨時可以拒絕此升級,任何內容都不會變更。
如果您選擇更新 Toolkit 程式碼,腳本接著會檢查_預設_ Docker 映像檔版本是否已變更,並詢問是否要將您的本機版本檔案(位於 config/version)升級為新的預設值。
如果您選擇切換版本,腳本會引導您完成關閉 Docker 服務、進行備份以及重新啟動 Docker 服務的流程。您的舊版本檔案會自動複製到 config/__old-version,以防您需要復原到該版本的 Docker 映像檔。
對於手動匯入 Docker 映像檔的離線隔離(air-gapped)環境,請在
config/overleaf.rc 檔案中設定 PULL_BEFORE_UPGRADE=false。有關在離線隔離/離線環境中部署的更多資訊,請參閱這裡。升級路徑
如果您正在執行 v6.0.0 之前的舊版 Overleaf Community,請參閱 Overleaf 官方文件以完成升級。 在 Ayakaleaf Pro 中,請先升級至目前版本線的最新修補版本,再升級至下一個版本線,例如6.2.0 → 6.2.2 → 6.3.2。請閱讀您所經過每個版本的版本資訊,其中部分版本需要額外的步驟。僅支援最新的發行版本。
若要查看您正在執行的映像檔,請使用
docker inspect --format '{{.Config.Image}}' sharelatex。
問與答
upgrade-user-features 指令碼有什麼作用?
upgrade-user-features 指令碼有什麼作用?
回答:它會將您執行個體的預設功能套用至現有使用者,例如由
COMPILE_TIMEOUT 設定的編譯逾時時間。它只會提高數值,絕不會降低,因此編譯逾時時間較長的使用者會保留原有設定。它不屬於升級流程的一部分,也不會自行執行;只有在您提高 COMPILE_TIMEOUT 等預設值之後才需要使用。預設情況下,它會以試執行模式列出將會變更的使用者;加上 --dry-run=false 即可儲存變更:
