Langsung ke konten utama
Penting untuk memastikan Anda membuat backup yang konsisten sebelum setiap upgrade versi mayor agar Anda dapat melakukan rollback jika diperlukan.
ayakaleaf toolkit↗ adalah repositori git, sehingga mudah untuk mendapatkan fitur Toolkit yang baru. Cukup jalankan perintah bin/upgrade dan ikuti petunjuk di layar. Perlu dicatat bahwa versi image Docker (di config/version) dikelola secara terpisah dari pembaruan kode Toolkit. Memperbarui kode Toolkit tidak akan secara otomatis mengubah versi image Docker yang Anda jalankan. Artinya, dalam sebagian besar kasus, Anda dapat meng-upgrade versi Toolkit tanpa meng-upgrade deployment Anda.

Skrip bin/upgrade

Saat Anda menjalankan perintah bin/upgrade, skrip akan memeriksa apakah ada pembaruan yang tersedia untuk kode Toolkit, lalu menawarkan untuk memperbarui Toolkit Anda. Anda selalu dapat menolak upgrade ini, dan tidak ada yang akan berubah. Jika Anda memilih untuk memperbarui kode Toolkit, skrip kemudian akan memeriksa apakah versi image Docker default telah berubah, lalu menawarkan untuk meng-upgrade file versi lokal Anda (di config/version) agar sesuai dengan default yang baru. Jika Anda memilih untuk beralih versi, skrip kemudian akan memandu Anda melalui proses mematikan layanan Docker, membuat backup, dan memulai ulang layanan Docker. File versi lama Anda akan disalin secara otomatis ke config/__old-version, untuk berjaga-jaga jika Anda perlu melakukan rollback ke versi image Docker tersebut.
Untuk lingkungan air-gapped yang mengimpor image Docker secara manual, harap atur PULL_BEFORE_UPGRADE=false di file config/overleaf.rc Anda.Silakan lihat di sini untuk informasi lebih lanjut tentang deployment di lingkungan air-gapped/offline.

Jalur upgrade

Jika Anda menjalankan Overleaf Community versi lama sebelum v6.0.0, lihat dokumentasi resmi Overleaf untuk menyelesaikan upgrade. Di dalam Ayakaleaf Pro, lakukan upgrade terlebih dahulu ke rilis patch terbaru dari lini versi Anda saat ini, lalu ke lini berikutnya, misalnya 6.2.0 → 6.2.2 → 6.3.2. Baca catatan rilis dari setiap versi yang Anda lewati, karena beberapa di antaranya memerlukan langkah tambahan. Hanya rilis terbaru yang didukung. Untuk memeriksa image yang Anda jalankan, gunakan docker inspect --format '{{.Config.Image}}' sharelatex.

Tanya Jawab

Jawaban: Skrip ini memberikan fitur default instans Anda kepada pengguna yang sudah ada, seperti batas waktu kompilasi yang diatur oleh COMPILE_TIMEOUT. Skrip ini hanya menaikkan nilai dan tidak pernah menurunkannya, sehingga pengguna dengan batas waktu kompilasi yang lebih lama tetap mempertahankannya. Skrip ini bukan bagian dari upgrade dan tidak pernah berjalan dengan sendirinya; Anda hanya memerlukannya setelah menaikkan nilai default seperti COMPILE_TIMEOUT. Secara default, skrip ini berjalan sebagai dry run yang menampilkan daftar pengguna yang akan diubahnya; tambahkan --dry-run=false untuk menyimpan perubahan:
Terakhir diubah pada 2 November 2026