Betik parametreleriyle ONLYOFFICE Apps Developer kurulumu

Giriş

ONLYOFFICE Apps Developer, kullanıcıları ve belgeleri tek bir yerde buluşturarak iş birliğini güçlendiren belge merkezinin ücretli sürümüdür.

ONLYOFFICE Apps Developer, Docker kurulu Linux işletim sistemleri için otomatik bir kurulum betiği olarak sunulur. Betik, ONLYOFFICE Apps Developer'ın doğru çalışması için gereken tüm bileşenleri içeren Docker kapsayıcılarını kurar; çalıştırılması, yönetilmesi ve güncellenmesi kolaydır.

ONLYOFFICE Apps Developer 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-developer-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-developer-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 hangi yöntemle 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

Parametre	Açıklama
-reg, --registry	docker registry URL'si (örneğin https://myregistry.com:5000)
-un, --username	docker registry kullanıcı adı
-p, --password	docker registry parolası

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

Örnek

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

Kurulum türü

Parametre	Açıklama	Değerler	Varsayılan
-it, --installationtype	kurulum türü	community|developer|enterprise	developer

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

Örnek

bash apps-developer-install.sh -it community

Bu komut ONLYOFFICE Apps Community çözümünü kurar.

Donanım denetimi

Parametre	Açıklama	Değerler	Varsayılan
-skiphc, --skiphardwarecheck	donanım denetimini atlamak için kullanın	true|false	false

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

Örnek

bash apps-developer-install.sh -skiphc true

Bu komut donanım denetimini atlar.

Bileşen güncelleme

Parametre	Açıklama	Değerler	Varsayılan
-u, --update	mevcut bileşenleri güncellemek için kullanın	true|false	false

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

Örnek

bash apps-developer-install.sh -u true

Bu komut, güncellenmesi gereken kapsayıcıları sırayla durdurur, kaldırır ve ardından ilgili ONLYOFFICE Apps Developer bileşenlerinin en son sürümlerini çalıştırır. Mevcut bileşen sürümü en son kullanılabilir sürümle aynıysa, o kapsayıcı etkilenmez. Önceki kurulumda bazı bileşenleri atladıysanız, bunlar da atlanır. ONLYOFFICE Apps verileri otomatik olarak devralını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-developer-install.sh -u true -docsi onlyoffice/documentserver-de -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-developer-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false

Bileşen kurulumu

Parametre	Açıklama	Değerler	Varsayılan
-ia, --installapps	ONLYOFFICE Apps'i kur	true|false	true
-idocs, --installdocs	ONLYOFFICE Docs'u kur	true|false	true
-irbt, --installrabbitmq	RabbitMQ'yu kur	true|false	true
-irds, --installredis	Redis'i kur	true|false	true
-imysql, --installmysql	MySQL'i kur	true|false	true

Bu parametreler, belirli bir bileşeni kurmak isteyip istemediğinizi 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-developer-install.sh -idocs false

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

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

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

Bileşen sürümü

Parametre	Açıklama
-asv, --appsversion	ONLYOFFICE Apps sürümü
-docsv, --docsversion	ONLYOFFICE 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 depoda kullanılabilen tüm etiketleri görmek için Tags sekmesine gidin. Kurmak istediğiniz sürümü belirtin:

bash apps-developer-install.sh -docsv 7.2.1.34

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

ONLYOFFICE Docs imaj adı

Parametre	Açıklama
-docsi, --docsimage	ONLYOFFICE Docs imaj adı

Bu parametre, bir kapsayıcının hangi ONLYOFFICE Docs imajından başlatılacağını belirten bir ad vermek için kullanılabilir. Belirtilen imaj, Docker Hub üzerindeki resmi herkese açık deposunda saklanmalıdır.

Örnek

bash apps-developer-install.sh -docsi onlyoffice/documentserver-de

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

Ana makine ayarı

Parametre	Açıklama
-ash, --appshost	ONLYOFFICE Apps ana makinesi
-esh, --elastichost	OpenSearch ana makineleri

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

Örnek

bash apps-developer-install.sh -esh 192.168.3.202

Bu komut ONLYOFFICE Apps'i kurar ve 192.168.3.202 IP adresli farklı bir makineye kurulu OpenSearch ile bağlar.

core.machinekey ayarı

Parametre	Açıklama
-mk, --machinekey	core.machinekey anahtarı ayarı

Bu parametre, ONLYOFFICE Apps Developer'ı kurarken kendi machinekey değerinizi 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-developer-install.sh -mk yourmachinekey

ONLYOFFICE Apps harici bağlantı noktası

Parametre	Açıklama	Varsayılan
-ep, --externalport	ONLYOFFICE Apps harici 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-developer-install.sh -ep 8080

JWT üst bilgisi ve gizli anahtar ayarları

Parametre	Açıklama
-jh, --jwtheader	JWT üst bilgisi ayarı
-js, --jwtsecret	JWT gizli anahtarı ayarı

Bu parametreler, ONLYOFFICE Apps Developer'ı 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-developer-install.sh -js yoursecret

MySQL sunucusu

Parametre	Açıklama	Varsayılan
-mysqlrp, --mysqlrootpassword	MySQL sunucusu root parolası	otomatik oluşturulur
-mysqlh, --mysqlhost	MySQL sunucusu ana makinesi	localhost
-mysqlport, --mysqlport	MySQL sunucusu bağlantı noktası numarası	3306

Ana makineyi 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-developer-install.sh -mysqlrp new-secret-pw

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

ONLYOFFICE Apps veritabanı

Parametre	Açıklama	Varsayılan
-mysqld, --mysqldatabase	ONLYOFFICE Apps veritabanı adı	onlyoffice_apps
-mysqlu, --mysqluser	ONLYOFFICE Apps veritabanı kullanıcısı	-
-mysqlp, --mysqlpassword	ONLYOFFICE Apps veritabanı parolası	otomatik oluşturulur

Bu parametreler, özel bir veritabanı adı ile oluşturulan veritabanında süper kullanıcı izinlerine sahip bir hesabın kullanıcı adını ve parolasını belirterek ONLYOFFICE Apps veritabanını 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-developer-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password

RabbitMQ sunucusu

Parametre	Açıklama	Varsayılan
--rabbitmqprotocol	RabbitMQ bağlantı protokolü	amqp
--rabbitmqhost	RabbitMQ sunucusu ana makinesi	localhost
--rabbitmqport	RabbitMQ sunucusu bağlantı noktası numarası	5672
--rabbitmqusername	RabbitMQ kullanıcı adı	-
--rabbitmqpassword	RabbitMQ kullanıcı parolası	-
--rabbitmqvirtualhost	RabbitMQ sanal ana makinesi (virtual host)	/

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 makineyi, bağlantı noktasını veya sanal ana makineyi açıkça belirtmezseniz varsayılan değerler kullanılır.

Örnek

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

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

Redis sunucusu

Parametre	Açıklama	Varsayılan
--redishost	Redis sunucusu ana makinesi	localhost
--redisport	Redis sunucusu bağlantı noktası numarası	6379
--redisusername	Sunucu yetkilendirme gerektiriyorsa Redis kullanıcı adı	-
--redispassword	Sunucu yetkilendirme gerektiriyorsa 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 gerektiriyorsa gereklidir.

Örnek

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

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

OpenSearch sunucusu

Parametre	Açıklama	Varsayılan
--elasticprotocol	OpenSearch bağlantı protokolü	http
--elasticport	OpenSearch 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 makine 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-developer-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200

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

HTTPS'e geçiş

Parametre	Açıklama
-led, --letsencryptdomain	Let's Encrypt sertifikası için alan adını tanımlar
-lem, --letsencryptmail	Let's Encrypt sertifikası için alan adı yöneticisinin e-posta adresini tanımlar
-cf, --certfile	alan adı için sertifika dosyasının yolu
-ckf, --certkeyfile	sertifikanı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-developer-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com

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

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

Bu komut kendi SSL sertifikanızı uygular.