Docker kullanarak ONLYOFFICE Docs'u güncelleme

Giriş

Bu kılavuz, ONLYOFFICE Docs Community Edition Docker sürümünüzü en son sürüme nasıl güncelleyeceğinizi gösterir.

not

Destek politikamız gereği yalnızca en son kararlı sürümü destekliyoruz. Yeni özellikler ve hata düzeltmeleri içeren yeni ONLYOFFICE Docs sürümlerini düzenli olarak yayımlıyoruz. ONLYOFFICE Docs'un eski bir sürümünü kullanıyorsanız en son sürüme yükseltmenizi öneririz.

Önemli

Eski bir Integration Edition sürümü kullanıyorsanız, onu güncellemenin tek yolu Integration Edition'ı (onlyoffice/documentserver-ie) kaldırmak ve yerine Enterprise Edition'ı kurmaktır.

Güncellemeden önce Docker sürümünüzün sistem gereksinimlerine uygun olduğundan (Docker ekibi tarafından desteklenen herhangi bir sürüm) emin olun.

Başlamadan önce

1. Verilerinizi yedekleyin. Her güncellemeden önce, bir sorun çıkarsa kurtarabilmek için bağlanan veri birimlerinizin yedeğini oluşturun. Aşağıdaki dizinleri arşivleyin:

   sudo tar -czf onlyoffice-docs-backup-$(date +%Y%m%d).tar.gz \
       /app/onlyoffice/DocumentServer/data \
       /app/onlyoffice/DocumentServer/lib \
       /app/onlyoffice/DocumentServer/db

2. Mevcut sürümü not edin. Geri almanız gerekirse diye mevcut imaj sürümünü kaydedin:

   sudo docker inspect --format='{{.Config.Image}}' {{DOCUMENT_SERVER_ID}}

ONLYOFFICE Docs'u kapatma

Çalışma özelliği gereği ONLYOFFICE Docs, bir belgeyi yalnızca o belgeyi düzenleyen tüm kullanıcılar belgeyi kapattıktan sonra kaydeder. Veri kaybını önlemek için, uygulamayı güncellemek amacıyla ONLYOFFICE Docs'u durdurmanız gerektiğinde ONLYOFFICE Docs kullanıcılarının bağlantısını zorla kesmeniz gerekir. Bunun için aşağıdaki betiği yürütün:

sudo docker exec {{DOCUMENT_SERVER_ID}} documentserver-prepare4shutdown.sh

burada {{DOCUMENT_SERVER_ID}}, ONLYOFFICE Docs kapsayıcısının adını veya kimliğini ifade eder.

Mevcut ONLYOFFICE Docs kapsayıcısının adını veya kimliğini, var olan tüm kapsayıcıları listeleyen Docker komutuyla kolayca öğrenebilirsiniz:

sudo docker ps -a

not

Betiğin çalışması uzun sürebilir (5 dakikaya kadar).

not

Kullanıcıların bağlantısının kesilmesi uzun sürebilir (5 dakikaya kadar).

ONLYOFFICE Docs'u Docker için güncelleme

Betik kullanarak güncelleme

ONLYOFFICE Docs sürümünüz aşağıdaki betik kullanılarak kurulduysa şu komutu yürütün:

bash docs-install.sh -u true

ONLYOFFICE Docs'u Docker kullanarak güncellemek için Y yazın ve Enter tuşuna basın.

not

ONLYOFFICE Docs Community Edition Docker sürümü, betikle yalnızca kurulum daha önce bu betik kullanılarak yapılmışsa güncellenir.

Elle güncelleme

1. Adım: Tüm harici veri depolama klasörlerinin bağlı olup olmadığını kontrol edin

ONLYOFFICE Docs verilerini saklamak için kullanılan tüm kapsayıcı birimlerinin bağlı olduğundan aşağıdaki komutla emin olun:

sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{DOCUMENT_SERVER_ID}}

2. Adım: Mevcut ONLYOFFICE Docs Docker kapsayıcısını durdurun.

sudo docker stop {{DOCUMENT_SERVER_ID}}

3. Adım: En son ONLYOFFICE Docs imajını indirin

En son ONLYOFFICE Docs imajını latest etiketini belirterek indirin:

docker pull onlyoffice/documentserver:latest

4. Adım: Yeni imajı aynı eşleme yollarıyla çalıştırın

sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /host_folder:/volume \
    -v /host_folder:/volume -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Yeni imajı, klasör yollarını önceki sürümde bağlandıkları şekliyle tamamen aynı eşleyerek çalıştırdığınızdan emin olun. Aksi halde bu klasörlerde saklanan veriler otomatik olarak alınmaz. Bunun için -v seçeneğinin bağımsız değişkenlerinde /host_folder:/volume değerlerini 1. Adım'da gösterilen gerçek yollarla değiştirin.

Önceki sürümü farklı bir bağlantı noktası veya HTTPS kullanarak kurduysanız ve yeni sürümü de aynı şekilde kurmak istiyorsanız, gerekli komutları bulmak için aşağıdaki kurulum yönergelerine bakın.

Kurulum işlemi bittikten sonra ONLYOFFICE Docs'u çalıştırın ve doğru çalışıp çalışmadığını kontrol edin.

5. Adım (İsteğe bağlı): Eski ONLYOFFICE Docs kapsayıcısını ve imajını kaldırın

Yeni sürümü iyice test edip doğru çalıştığını doğruladıktan sonra eski ONLYOFFICE Docs kapsayıcısını kaldırabilirsiniz. Geri almanız gerekmeyeceğinden emin olana kadar eski kapsayıcıyı kaldırmayın. Kaldırıldıktan sonra önceki sürümü geri yüklemenin tek yolu yedektir.

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

burada {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}, ESKİ ONLYOFFICE Docs kapsayıcısının adını veya kimliğini ifade eder.

Yer açmak isterseniz eski bir imajı da kaldırabilirsiniz. Tüm Docker imajlarını görüntüleyin:

sudo docker images -a

İmaj listesinde gereksiz imajın kimliğini bulun ve imajı kaldırın:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}

Önceki sürüme geri dönme

Güncellenen sürüm doğru çalışmıyorsa ve eski kapsayıcıyı ile imajı henüz kaldırmadıysanız (5. Adım'a bakın), geri dönebilirsiniz:

1. Yeni kapsayıcıyı durdurun:

   sudo docker stop {{NEW_DOCUMENT_SERVER_ID}}

2. Eski kapsayıcıyı başlatın:

   sudo docker start {{OLD_DOCUMENT_SERVER_ID}}

3. Eski sürümün doğru çalıştığını doğrulayın.

Önemli

Geri dönmek yalnızca eski kapsayıcıyı sakladıysanız (yani üzerinde docker rm çalıştırmadıysanız) mümkündür. 5. Adım bu nedenle isteğe bağlı olarak işaretlenmiştir. Yeni sürümün çalıştığından emin olana kadar eski kapsayıcıyı kaldırmayın.

not

Veritabanı şeması v6.3 sürümünde değiştirilmiştir. v6.3 sürümüne güncellerken (ONLYOFFICE Docs'un Docker sürümünü harici bir veritabanıyla kullanıyorsanız), parola koruması özelliğini kullanabilmek için veritabanı şemasını da yükseltmeniz gerekebilir.

1. Veritabanı şemasını yükseltme betiğini ONLYOFFICE Docs kapsayıcısında bulun.

   • PostgreSQL için: /var/www/onlyoffice/documentserver/server/schema/postgresql/upgrade/upgradev630.sql
   • MySQL için: /var/www/onlyoffice/documentserver/server/schema/mysql/upgrade/upgradev630.sql

2. Betiği komut satırını kullanarak yürütün.

   • PostgreSQL için: psql -U onlyoffice -W onlyoffice < {path-to-upgradev630.sql}
   • MySQL için: mysql -u root -p onlyoffice < {path-to-upgradev630.sql}

   Veritabanı oluşturulurken kullanılan parolayı (onlyoffice) belirtin.