Ana içeriğe geç

ONLYOFFICE Apps Community'yi betik parametreleriyle kurma

Giriş​

ONLYOFFICE Apps Community, işbirliğini güçlendirmek için kullanıcıları ve belgeleri tek bir yerde buluşturan belge merkezinin ücretsiz sürümüdür.

ONLYOFFICE Apps Community, Docker yüklü Linux işletim sistemleri için otomatik kurulum betiği olarak sunulur. Betik, ONLYOFFICE Apps Community'nin doğru çalışması için gereken tüm bileşenleri içeren Docker kapsayıcılarını kurar; çalıştırması, yönetmesi ve güncellemesi kolaydır.

ONLYOFFICE Apps Community kurulum betiğini indirdikten sonra, örneğin her bileşeni ayrı bir makineye kurmak istiyorsanız, betiği bazı ek parametreler belirterek çalıştırmanız gerekebilir.

Kullanılabilir tüm Docker betik parametrelerinin listesini görüntülemek için aşağıdaki komutu kullanın:

bash apps-install.sh docker -h

Kullanılabilir tüm DEB/RPM betik parametrelerinin listesini görüntülemek için aşağıdaki komutu kullanın:

bash apps-install.sh package -h

Bu parametrelerin kısa açıklamalarını ve bazı kullanım örneklerini aşağıda bulabilirsiniz.

Betiği parametrelerle çalıştırdığınızda, ONLYOFFICE Apps'i nasıl kurmak istediğinizi seçmeniz istenir. ONLYOFFICE Apps'i Docker ile kurmak için Y yazıp Enter tuşuna basın. ONLYOFFICE Apps'i DEB/RPM paketlerinden kurmak için N yazıp Enter tuşuna basın.

Kimlik bilgileri​

ParametreAçıklama
-reg, --registryDocker kayıt defteri URL'si (örn. https://myregistry.com:5000)
-un, --usernameDocker kayıt defteri kullanıcı adı
-p, --passwordDocker kayıt defteri parolası

Bu parametreler, size bir test deposuna erişim için kimlik bilgileri verildiğinde, içindeki imajlardan kapsayıcı çalıştırabilmeniz için kullanılır.

Örnek​

bash apps-install.sh -reg URL -un username -p password

Kurulum türü​

ParametreAçıklamaDeğerlerVarsayılan
-it, --installationtypekurulum türücommunity|developer|enterprisecommunity

Bu parametre, belirtilen çözümü kurmanızı sağlar: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer veya ONLYOFFICE Apps Enterprise.

Örnek​

bash apps-install.sh -it enterprise

Bu, ONLYOFFICE Apps Enterprise çözümünü kurar.

Donanım denetimi​

ParametreAçıklamaDeğerlerVarsayılan
-skiphc, --skiphardwarecheckdonanım denetimini atlamak için kullanıntrue|falsefalse

Bu parametre, sistemin minimum donanım gereksinimlerini karşılayıp karşılamadığının denetlenmesini atlamanızı sağlar.

Örnek​

bash apps-install.sh -skiphc true

Bu, donanım denetimini atlar.

Bileşen güncelleme​

ParametreAçıklamaDeğerlerVarsayılan
-u, --updatemevcut bileşenleri güncellemek için kullanıntrue|falsefalse

Bu parametre, makinenizde kurulu ilgili bileşenler eskiyse gerekli bileşenlerin en son sürümlerini kurmanızı sağlar.

Örnek​

bash apps-install.sh -u true

Bu, güncellenmesi gereken kapsayıcıları sırayla durdurur, kaldırır ve ardından ilgili ONLYOFFICE Apps Community bileşenlerinin en son sürümlerini çalıştırır. Mevcut bileşen sürümü en son sürümle aynıysa, bu kapsayıcı etkilenmez. Önceki kurulumda bazı bileşenleri atladıysanız, bunlar da atlanır. ONLYOFFICE Apps verileri otomatik olarak alınmalıdır.

Yalnızca Docs'u 7.2.1.34 sürümüne güncelleyin ve diğer tüm bileşenlerin güncellemesini atlayın:

bash apps-install.sh -u true -docsi onlyoffice/documentserver -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false

Yalnızca ONLYOFFICE Apps'i 1.2.0 sürümüne güncelleyin ve diğer tüm bileşenlerin güncellemesini atlayın:

bash apps-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false

Bileşen kurulumu​

ParametreAçıklamaDeğerlerVarsayılan
-ia, --installappsONLYOFFICE Apps'i kurtrue|falsetrue
-idocs, --installdocsONLYOFFICE Docs'u kurtrue|falsetrue
-irbt, --installrabbitmqRabbitMQ'yu kurtrue|falsetrue
-irds, --installredisRedis'i kurtrue|falsetrue
-imysql, --installmysqlMySQL'i kurtrue|falsetrue

Bu parametreler, belirli bir bileşenin kurulup kurulmayacağını belirtmenizi sağlar. Her bileşeni ayrı bir makineye kurmak istiyorsanız kullanılabilirler.

  • Bir bileşeni kurmak için true değerini kullanın.
  • Bir bileşenin kurulumunu atlamak için false değerini kullanın.

Örnek​

bash apps-install.sh -idocs false

Bu, ONLYOFFICE Docs hariç tüm ONLYOFFICE Apps Community bileşenlerini kurar.

bash apps-install.sh -ia false -idocs true -imysql false -irbt false -irds false

Bu, ONLYOFFICE Apps, MySQL, RabbitMQ ve Redis kurulumunu atlar ve yalnızca ONLYOFFICE Docs'u kurar.

Bileşen sürümü​

ParametreAçıklama
-asv, --appsversionONLYOFFICE Apps sürümü
-docsv, --docsversionONLYOFFICE Docs sürümü

Bu parametreler, bir nedenle depodaki en son sürümü kurmak istemiyorsanız belirli bir ONLYOFFICE Apps veya ONLYOFFICE Docs sürümünü kurmak için kullanılabilir. Varsayılan olarak bileşen kapsayıcısını çalıştırmak için latest etiketli imaj kullanılır.

Örnek​

Tarayıcınızda Docker Hub deposunu açın, ONLYOFFICE Docs'u seçin ve depodaki tüm etiketleri görmek için Tags sekmesine gidin. Kurmak istediğiniz sürümü belirtin:

bash apps-install.sh -docsv 7.2.1.34

Bu, ONLYOFFICE Apps'i ONLYOFFICE Docs 7.2.1.34 sürümüyle kurar.

ONLYOFFICE Docs imaj adı​

ParametreAçıklama
-docsi, --docsimageONLYOFFICE Docs imaj adı

Bu parametre, kapsayıcının başlatılacağı ONLYOFFICE Docs imajının adını belirtmek için kullanılabilir. Belirtilen imaj, Docker Hub üzerindeki resmi herkese açık depomuzda bulunmalıdır.

Örnek​

bash apps-install.sh -docsi onlyoffice/documentserver

Bu, depoda bulunan belirtilen ONLYOFFICE Docs imajından bir kapsayıcı çalıştırır.

Ana bilgisayar ayarı​

ParametreAçıklama
-ash, --appshostONLYOFFICE Apps ana bilgisayarı
-esh, --elastichostOpenSearch ana bilgisayarları

Bu parametreler, bileşenleri ayrı makinelere kuruyorsanız birbirine bağlamak için kullanılabilir.

Örnek​

bash apps-install.sh -esh 192.168.3.202

Bu, ONLYOFFICE Apps'i kurar ve 192.168.3.202 IP adresine sahip farklı bir makineye kurulu OpenSearch'e bağlar.

core.machinekey ayarı​

ParametreAçıklama
-mk, --machinekeycore.machinekey anahtarı ayarı

Bu parametre, ONLYOFFICE Apps Community'yi kurarken kendi machinekey anahtarınızı belirtmenizi sağlar.

not

Bu parametre /app/onlyoffice/config/appsettings.json yapılandırma dosyasına yazılır (yol, onlyoffice-studio kapsayıcısı içinde belirtilmiştir).

Örnek​

bash apps-install.sh -mk yourmachinekey

ONLYOFFICE Apps dış bağlantı noktası​

ParametreAçıklamaVarsayılan
-ep, --externalportONLYOFFICE Apps dış bağlantı noktası80

Bu parametre, ONLYOFFICE Apps'in çalışacağı bağlantı noktasını değiştirmenizi sağlar. Varsayılan olarak 80 numaralı bağlantı noktası kullanılır.

Örnek​

bash apps-install.sh -ep 8080

JWT üst bilgisi ve gizli anahtar ayarları​

ParametreAçıklama
-jh, --jwtheaderJWT üst bilgisi ayarı
-js, --jwtsecretJWT gizli anahtarı ayarı

Bu parametreler, ONLYOFFICE Apps Community'yi kurarken JWT üst bilgisini ve kendi JWT gizli anahtarınızı belirtmenizi sağlar. JWT üst bilgisi, JWT'yi göndermek için kullanılacak http üst bilgisini tanımlar. Gizli anahtar, JSON web belirtecini imzalamak ve ONLYOFFICE Docs'a yapılan istekte belirteci doğrulamak için kullanılır.

not

Bu parametreler aşağıdaki yapılandırma dosyalarına yazılır (yollar, onlyoffice-studio ve onlyoffice-document-server kapsayıcıları içinde belirtilmiştir):

  • ONLYOFFICE Apps için - /app/onlyoffice/config/appsettings.json
  • Document Server için - /etc/onlyoffice/documentserver/local.json

Örnek​

bash apps-install.sh -js yoursecret

MySQL sunucusu​

ParametreAçıklamaVarsayılan
-mysqlrp, --mysqlrootpasswordMySQL sunucusu root parolasıauto-generated
-mysqlh, --mysqlhostMySQL sunucusu ana bilgisayarılocalhost
-mysqlport, --mysqlportMySQL sunucusu bağlantı noktası numarası3306

Ana bilgisayarı ve bağlantı noktasını açıkça belirtmezseniz varsayılan değerler kullanılır. Root parolasını belirtmezseniz otomatik olarak oluşturulur.

Örnek​

bash apps-install.sh -mysqlrp new-secret-pw

Bu komut, ONLYOFFICE Apps Community kurulumu sırasında MySQL root hesabı için kendi parolanızı belirlemenizi sağlar.

ONLYOFFICE Apps veritabanı​

ParametreAçıklamaVarsayılan
-mysqld, --mysqldatabaseONLYOFFICE Apps veritabanı adıonlyoffice_apps
-mysqlu, --mysqluserONLYOFFICE Apps veritabanı kullanıcısı-
-mysqlp, --mysqlpasswordONLYOFFICE Apps veritabanı parolasıotomatik oluşturulur

Bu parametreler, ONLYOFFICE Apps veritabanını özel bir veritabanı adıyla ve oluşturulan veritabanında süper kullanıcı izinlerine sahip hesap için kullanıcı adı ve parolayla oluşturmanızı sağlar. Veritabanı adını açıkça belirtmezseniz varsayılan değer kullanılır. Parola belirtmezseniz otomatik olarak oluşturulur.

Örnek​

bash apps-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password

RabbitMQ sunucusu​

ParametreAçıklamaVarsayılan
--rabbitmqprotocolRabbitMQ bağlantı protokolüamqp
--rabbitmqhostRabbitMQ sunucusu ana bilgisayarılocalhost
--rabbitmqportRabbitMQ sunucusu bağlantı noktası numarası5672
--rabbitmqusernameRabbitMQ kullanıcı adı-
--rabbitmqpasswordRabbitMQ kullanıcı parolası-
--rabbitmqvirtualhostRabbitMQ sanal ana bilgisayarı/

Bu parametreleri, ONLYOFFICE Apps'i başka bir makinede zaten çalışan bir RabbitMQ sunucusuna bağlamak için kullanın. RabbitMQ kurulumunu -irbt false parametresiyle atlayın, ardından kendi sunucunuzun bağlantı parametrelerini belirtin. Protokolü, ana bilgisayarı, bağlantı noktasını veya sanal ana bilgisayarı açıkça belirtmezseniz varsayılan değerler kullanılır.

Örnek​

bash apps-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password

Bu, ONLYOFFICE Apps'i RabbitMQ olmadan kurar ve mq.example.com ana bilgisayarında çalışan RabbitMQ sunucusuna bağlar.

Redis sunucusu​

ParametreAçıklamaVarsayılan
--redishostRedis sunucusu ana bilgisayarılocalhost
--redisportRedis sunucusu bağlantı noktası numarası6379
--redisusernamesunucu yetkilendirme istiyorsa Redis kullanıcı adı-
--redispasswordsunucu yetkilendirme istiyorsa Redis kullanıcı parolası-

Bu parametreleri, ONLYOFFICE Apps'i başka bir makinede zaten çalışan bir Redis sunucusuna bağlamak için kullanın. Redis kurulumunu -irds false parametresiyle atlayın, ardından kendi sunucunuzun bağlantı parametrelerini belirtin. Kullanıcı adı ve parola yalnızca Redis sunucunuz yetkilendirme istiyorsa gereklidir.

Örnek​

bash apps-install.sh -irds false --redishost redis.example.com --redispassword password

Bu, ONLYOFFICE Apps'i Redis olmadan kurar ve redis.example.com ana bilgisayarında çalışan Redis sunucusuna bağlar.

OpenSearch sunucusu​

ParametreAçıklamaVarsayılan
--elasticprotocolOpenSearch bağlantı protokolühttp
--elasticportOpenSearch sunucusu bağlantı noktası numarası9200

Bu parametreleri, ONLYOFFICE Apps'i başka bir makinede çalışan bir OpenSearch sunucusuna bağlamak için yukarıdaki Ana bilgisayar ayarı bölümünde açıklanan -esh, --elastichost parametresiyle birlikte kullanın. Protokolü ve bağlantı noktasını açıkça belirtmezseniz varsayılan değerler kullanılır.

Örnek​

bash apps-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200

Bu, ONLYOFFICE Apps'i search.example.com ana bilgisayarında çalışan OpenSearch sunucusuna HTTPS üzerinden bağlar.

HTTPS'e geçiş​

ParametreAçıklama
-led, --letsencryptdomainLet's Encrypt sertifikası için alan adını tanımlar
-lem, --letsencryptmailLet's Encrypt sertifikası için alan adı yöneticisinin e-posta adresini tanımlar
-cf, --certfilealan adının sertifika dosyasının yolu
-ckf, --certkeyfilesertifikanın özel anahtar dosyasının yolu

Bu parametreler, çalışma alanını HTTPS'e geçirmenizi sağlar. Yalnızca Docker sürümü için kullanılabilirler.

Örnek​

bash apps-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com

Bu, letsencrypt.org CA imzalı sertifikasını otomatik olarak oluşturup sunucunuza kurar ve değişikliklerin etkili olması için NGINX hizmetini yeniden başlatır.

bash apps-install.sh docker --certfile path --certkeyfile path

Bu, kendi SSL sertifikanızı uygular.