ONLYOFFICE Docs'u Kubernetes'te kurma
Giriş
Bu kılavuz yalnızca ücretli küme lisansı çözümü için geçerlidir.
- Kurulu bir Kubernetes veya OpenShift kümeniz olmalıdır:
- Kubernetes'i kurmak için bu kaynağa bakın.
- OpenShift'i kurmak için bu kaynağa bakın.
- Ayrıca yapılandırılmış yerel bir
kubectlkopyanız olmalıdır.kubectl'i kurmak ve yapılandırmak için bu kılavuza bakın. - Helm v3.7 veya üzerini kurmalısınız. Kurmak için buradaki yönergeleri izleyin.
- OpenShift kullanıyorsanız dağıtımı yönetmek için hem
ochem dekubectlkullanabilirsiniz. - 'Docs' dışındaki bileşenler bir OpenShift kümesinde Helm Chart ile kuruluyorsa, erişim haklarıyla ilgili olası sorunları önlemek için bunları
cluster-adminrolüne sahip bir kullanıcıyla kurmanız önerilir. Kullanıcıya gerekli rolleri eklemek için bu kılavuza bakın.
Ön koşulları dağıtma
OpenShift kümesine kurulum yaparken, ID = 1001 olan bir kullanıcıdan kapsayıcı çalıştırma izni ekleyen SecurityContextConstraints ilkesini uygulamanız gerekebilir.
Bunun için aşağıdaki komutları çalıştırın:
$ oc apply -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/scc/helm-components.yaml
$ oc adm policy add-scc-to-group scc-helm-components system:authenticated
Alternatif olarak, RabbitMQ, Redis, PostgreSQL gibi bağımlılıkları kurarken runAsUser ve fsGroup parametrelerine bakarak hedef namespace'ten izin verilen kullanıcı ve grup aralığını belirtebilirsiniz.
1. Helm depolarını ekleme
$ helm repo add bitnami https://charts.bitnami.com/bitnami
$ helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
$ helm repo add nfs-server-provisioner https://kubernetes-sigs.github.io/nfs-ganesha-server-and-external-provisioner
$ helm repo add onlyoffice https://download.onlyoffice.com/charts/stable
$ helm repo update
2. Kalıcı depolamayı kurma
Amazon S3'ü önbellek olarak kullanmak istiyorsanız bu adımı atlayın.
NFS Server Provisioner'ı kurma
NFS Server Provisioner kurulurken NFS Storage Class oluşturulur. Bir OpenShift kümesine kurulum yaparken kullanıcının kümede Storage Class oluşturmaya izin veren bir role sahip olması gerekir. Daha fazla bilgi için buraya bakın.
$ helm install nfs-server nfs-server-provisioner/nfs-server-provisioner \
--set persistence.enabled=true \
--set persistence.storageClass=PERSISTENT_STORAGE_CLASS \
--set persistence.size=PERSISTENT_SIZE
-
PERSISTENT_STORAGE_CLASS, Kubernetes kümenizde kullanılabilen bir Persistent Storage Class'tır.Farklı sağlayıcılar için Persistent Storage Class'lar:
- Amazon EKS:
gp2 - Digital Ocean:
do-block-storage - IBM Cloud: Varsayılan
ibmc-file-bronze. Diğer storage class'lar - Yandex Cloud:
yc-network-hddveyayc-network-ssd. Daha fazla bilgi - minikube:
standard
- Amazon EKS:
-
PERSISTENT_SIZE, nfs Persistent Storage Class için tüm Persistent Storage'ların toplam boyutudur. Boyutu düz bir tam sayı olarak veya şu soneklerden biriyle belirtebilirsiniz:T,G,M,Ti,Gi,Mi. Örneğin:9Gi.
NFS Server Provisioner'ı Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
Persistent Volume Claim yapılandırma
Varsayılan nfs Persistent Volume Claim 8Gi'dir. Bunu values.yaml dosyasındaki persistence.storageClass ve persistence.size bölümünde değiştirebilirsiniz. Değer, PERSISTENT_SIZE değerinden en az yaklaşık %5 küçük olmalıdır. ONLYOFFICE Docs'un her 100 etkin kullanıcısı için kalıcı depolamada 8Gi veya daha fazlasını kullanmanız önerilir.
PVC yerleşimi için kullanılacak PersistentVolume türü ReadWriteMany Access Mode'unu desteklemelidir. Ayrıca PersistentVolume'un sahibi, ONLYOFFICE Docs'un başlatılacağı kullanıcı olmalıdır. Varsayılan olarak bu kullanıcı ds (101:101) olur.
WOPI'yi etkinleştirmek istiyorsanız wopi.enabled=true parametresini ayarlayın. Bu durumda Persistent Storage, istemciler için bağlanan dizinin önbellekleme öznitelikleri devre dışı bırakılarak küme düğümlerine bağlanmalıdır. NFS Server Provisioner için bu, storageClass.mountOptions parametresine noac seçeneği eklenerek sağlanabilir. Daha fazla bilgi için buraya bakın.
3. RabbitMQ'yu dağıtma
RabbitMQ'yu kümenize kurmak için aşağıdaki komutu çalıştırın:
$ helm install rabbitmq --version 16.0.14 bitnami/rabbitmq \
--set persistence.storageClass=PERSISTENT_STORAGE_CLASS \
--set resourcesPreset=none \
--set image.repository=bitnamilegacy/rabbitmq \
--set image.tag=4.1.3-debian-12-r1 \
--set global.security.allowInsecureImages=true \
--set metrics.enabled=false
RabbitMQ metriklerinin Prometheus tarafından toplanabilmesi için metrics.enabled=true ayarlayın.
RabbitMQ'yu Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
4. Redis'i dağıtma
Redis'i kümenize kurmak için aşağıdaki komutu çalıştırın:
$ helm install redis --version 22.0.7 bitnami/redis \
--set architecture=standalone \
--set master.persistence.storageClass=PERSISTENT_STORAGE_CLASS \
--set master.resourcesPreset=none \
--set global.security.allowInsecureImages=true \
--set image.repository=bitnamilegacy/redis \
--set image.tag=8.2.1-debian-12-r0 \
--set metrics.enabled=false
Redis metriklerinin Prometheus tarafından toplanabilmesi için metrics.enabled=true ayarlayın. Ayrıca şu parametreleri ekleyin: metrics.image.repository=bitnamilegacy/redis-exporter ve metrics.image.tag=1.76.0-debian-12-r0.
Redis'i Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
5. Veritabanını dağıtma
Veritabanı sunucusu olarak PostgreSQL, MySQL veya MariaDB kullanabilirsiniz.
- PostgreSQL
- MySQL
PostgreSQL'i kümenize kurmak için aşağıdaki komutu çalıştırın:
$ helm install postgresql --version 16.7.27 bitnami/postgresql \
--set auth.database=postgres \
--set primary.persistence.storageClass=PERSISTENT_STORAGE_CLASS \
--set primary.persistence.size=PERSISTENT_SIZE \
--set primary.resourcesPreset=none \
--set image.repository=bitnamilegacy/postgresql \
--set global.security.allowInsecureImages=true \
--set image.tag=17.6.0-debian-12-r2 \
--set metrics.enabled=false
Veritabanı metriklerinin Prometheus tarafından toplanabilmesi için metrics.enabled=true ayarlayın. Ayrıca şu parametreleri ekleyin: metrics.image.repository=bitnamilegacy/postgres-exporter ve metrics.image.tag=0.17.1-debian-12-r16.
PostgreSQL'i Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
MySQL'i kümenize kurmak için aşağıdaki komutu çalıştırın:
$ helm install mysql --version 14.0.3 bitnami/mysql \
--set auth.database=onlyoffice \
--set auth.username=onlyoffice \
--set primary.persistence.storageClass=PERSISTENT_STORAGE_CLASS \
--set primary.persistence.size=PERSISTENT_SIZE \
--set primary.resourcesPreset=none \
--set image.repository=bitnamilegacy/mysql \
--set global.security.allowInsecureImages=true \
--set image.tag=9.4.0-debian-12-r1 \
--set metrics.enabled=false
MySQL'i Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
Burada PERSISTENT_SIZE, Veritabanı kalıcı birimi için boyuttur. Örneğin: 8Gi.
ONLYOFFICE Docs'un her 100 etkin kullanıcısı için kalıcı depolamada en az 2Gi kullanmanız önerilir.
Veritabanı metriklerinin Prometheus tarafından toplanabilmesi için metrics.enabled=true ayarlayın. Ayrıca şu parametreleri ekleyin: metrics.image.repository=bitnamilegacy/mysqld-exporter ve metrics.image.tag=0.17.2-debian-12-r16.
6. StatsD exporter'ı dağıtma
Bu adım isteğe bağlıdır. StatsD exporter'ı çalıştırmak istemiyorsanız tamamen atlayabilirsiniz.
-
Helm depolarını ekleme
$ helm repo add prometheus-community https://prometheus-community.github.io/helm-charts$ helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics$ helm repo update -
Prometheus'u kurma
Prometheus'u kümenize kurmak için aşağıdaki komutu çalıştırın:
$ helm install prometheus -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/extraScrapeConfigs.yaml prometheus-community/prometheus \--set server.global.scrape_interval=1mKazıma (scrape) aralığını değiştirmek için
server.global.scrape_intervalparametresini belirtin.Prometheus'u Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
-
StatsD exporter'ı kurma
StatsD exporter'ı kümenize kurmak için aşağıdaki komutu çalıştırın:
$ helm install statsd-exporter prometheus-community/prometheus-statsd-exporter \--set statsd.udpPort=8125 \--set statsd.tcpPort=8126 \--set statsd.eventFlushInterval=30000msPrometheus StatsD exporter'ı Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
ONLYOFFICE Docs'ta StatsD metriklerine izin vermek için bu adımı izleyin.
7. Node-config yapılandırma dosyalarında değişiklik yapma
Bu adım isteğe bağlıdır. Yapılandırma dosyalarında değişiklik yapmanız gerekmiyorsa tamamen atlayabilirsiniz.
-
json dosyası içeren bir ConfigMap oluşturma
local.jsonyapısını içeren bir dosyadan ConfigMap oluşturmak için aşağıdaki komutu çalıştırmanız gerekir:$ kubectl create configmap local-config \--from-file=./local.jsonnotlocal-configyerine herhangi bir ad kullanılabilir. -
ONLYOFFICE Docs kurulurken parametreleri belirtme
ONLYOFFICE Docs kurulurken
extraConf.configMap=local-configveextraConf.filename=local.jsonparametrelerini belirtin.notONLYOFFICE Docs kurulduktan sonra bir yapılandırma dosyası eklemeniz gerekirse önce 7.1. adımı uygulayın, ardından şu komutu çalıştırın:
helm upgrade documentserver onlyoffice/docs --set extraConf.configMap=local-config --set extraConf.filename=local.json --no-hooksParametreler
values.yamldosyasında belirtilmişse şu komutu çalıştırın:helm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hooks
8. Özel yazı tipleri ekleme
Bu adım isteğe bağlıdır. Kendi yazı tiplerinizi eklemeniz gerekmiyorsa tamamen atlayabilirsiniz.
İmajlara yazı tipi eklemek için imajları yeniden oluşturmanız gerekir. İlgili adımlar için bu kılavuza bakın. Ardından ONLYOFFICE Docs'u kurarken kendi imajlarınızı belirtin.
9. Eklenti ekleme
Bu adım isteğe bağlıdır. Eklenti eklemeniz gerekmiyorsa tamamen atlayabilirsiniz.
İmajlara eklenti eklemek için imajları yeniden oluşturmanız gerekir. İlgili adımlar için bu kılavuza bakın. Ardından ONLYOFFICE Docs'u kurarken kendi imajlarınızı belirtin.
10. Özel sözlükler ekleme
Bu adım isteğe bağlıdır. Kendi sözlüklerinizi eklemeniz gerekmiyorsa tamamen atlayabilirsiniz.
İmajlara özel sözlüklerinizi eklemek için imajları yeniden oluşturmanız gerekir. İlgili adımlar için bu kılavuza bakın. Ardından ONLYOFFICE Docs'u kurarken kendi imajlarınızı belirtin.
11. Arayüz temalarını değiştirme
Bu adım isteğe bağlıdır. Arayüz temalarını değiştirmeniz gerekmiyorsa tamamen atlayabilirsiniz.
-
json dosyası içeren bir ConfigMap oluşturma
Arayüz temalarını içeren bir json dosyasıyla ConfigMap oluşturmak için aşağıdaki komutu çalıştırmanız gerekir:
$ kubectl create configmap custom-themes \--from-file=./custom-themes.jsonnotcustom-themesvecustom-themes.jsonyerine başka adlar kullanabilirsiniz. -
ONLYOFFICE Docs kurulurken parametreleri belirtme
ONLYOFFICE Docs kurulurken
extraThemes.configMap=custom-themesveextraThemes.filename=custom-themes.jsonparametrelerini belirtin.notONLYOFFICE Docs kurulduktan sonra arayüz temaları eklemeniz gerekirse önce 11.1. adımı uygulayın, ardından
helm upgrade documentserver onlyoffice/docs --set extraThemes.configMap=custom-themes --set extraThemes.filename=custom-themes.json --no-hookskomutunu çalıştırın. Parametrelervalues.yamldosyasında belirtilmişsehelm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hookskomutunu çalıştırın.
12. Amazon S3 bucket'ını ONLYOFFICE Helm Docs'a önbellek olarak bağlama
Bu adım isteğe bağlıdır. Amazon S3'ü önbellek deposu olarak kullanmak istemiyorsanız tamamen atlayabilirsiniz.
Amazon S3 bucket'ını önbellek olarak bağlamak için bu kılavuza uygun bir yapılandırma dosyası oluşturun veya mevcut dosyayı düzenleyin ve persistence.storageS3 parametresinin değerini true olarak değiştirin.
ONLYOFFICE Docs'u dağıtma
OpenShift kümesine kurulum yaparken, ID = 101 olan bir kullanıcıdan kapsayıcı çalıştırma izni ekleyen SecurityContextConstraints ilkesini uygulamanız gerekebilir.
Bunun için aşağıdaki komutları çalıştırın:
$ oc apply -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/scc/docs-components.yaml
$ oc adm policy add-scc-to-group scc-docs-components system:authenticated
Alternatif olarak, podTemplate'i tanımlayan tüm kaynaklar için commonAnnotations veya annotations içinde nonroot-v2 SecurityContextConstraints (SCC) ilkesini uygulayabilirsiniz. Hem kullanıcının hem de service account'un bu SCC'yi kullanmak için gerekli izinlere sahip olduğundan emin olun. nonroot-v2 kullanma iznine kimin sahip olduğunu denetlemek için aşağıdaki komutu çalıştırın:
oc adm policy who-can use scc nonroot-v2
helm install documentserver onlyoffice/docs --set commonAnnotations."openshift\.io/required-scc"="nonroot-v2"
Gerekirse podSecurityContext.enabled ve <resources>.containerSecurityContext.enabled değerlerini true olarak ayarlayın.
1. ONLYOFFICE Docs lisansını dağıtma
-
Secret oluşturma
Geçerli bir ONLYOFFICE Docs lisansınız varsa dosyadan
licenseadlı bir secret oluşturun:$ kubectl create secret generic [SECRET_LICENSE_NAME] --from-file=path/to/license.licBurada
SECRET_LICENSE_NAME, lisansı içerecek secret'ın adıdır.notKaynak lisans dosyasının adı 'license.lic' olmalıdır; çünkü bu ad, oluşturulan secret'ta bir alan olarak kullanılır.
notKurulum, mevcut lisans dosyasıyla bir secret oluşturulmadan yapılırsa boş bir
licensesecret'ı otomatik olarak oluşturulur. Mevcut bir secret'ı lisansla güncelleme hakkında bilgi için buraya bakın. -
ONLYOFFICE Docs kurulurken parametreleri belirtme
ONLYOFFICE Docs kurulurken
license.existingSecret=[SECRET_LICENSE_NAME]parametresini belirtin.$ helm install documentserver onlyoffice/docs --set license.existingSecret=[SECRET_LICENSE_NAME]notONLYOFFICE Docs kurulduktan sonra lisans eklemeniz gerekirse önce 1.1. adımı uygulayın, ardından
helm upgrade documentserver onlyoffice/docs --set license.existingSecret=[SECRET_LICENSE_NAME] --no-hookskomutunu çalıştırın. Parametrelervalues.yamldosyasında belirtilmişsehelm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hookskomutunu çalıştırın.
2. ONLYOFFICE Docs'u dağıtma
ONLYOFFICE Docs'u documentserver sürüm adıyla dağıtmak için:
$ helm install documentserver onlyoffice/docs
Komut, ONLYOFFICE Docs'u Kubernetes kümesine varsayılan yapılandırmayla dağıtır. Parametreler bölümünde kurulum sırasında yapılandırılabilen parametreler listelenir.
ONLYOFFICE Docs'u bir Web proxy arkasındaki veya internet erişimi olmayan özel bir k8s kümesine kurarken aşağıdaki notlara bakın.
3. ONLYOFFICE Docs'u kaldırma
documentserver dağıtımını kaldırmak/silmek için:
$ helm delete documentserver
helm delete komutu çalıştırıldığında, ONLYOFFICE Docs tamamen silinmeden önce bazı hazırlık işlemlerini yapan kancalar (hooks) başlatılır. Bu işlemler sunucuyu durdurmayı, kullanılan PVC'yi ve veritabanı tablolarını temizlemeyi içerir. Varsayılan kanca çalışma süresi 300 saniyedir. Çalışma süresi --timeout [time] ile değiştirilebilir, örneğin:
$ helm delete documentserver --timeout 25m
ONLYOFFICE Docs'u bir Web proxy arkasındaki veya internet erişimi olmayan özel bir k8s kümesinden silerken aşağıdaki notlara bakın.
ONLYOFFICE Docs'u hazırlık işlemleri yapmadan silmek istiyorsanız aşağıdaki komutu çalıştırın:
$ helm delete documentserver --no-hooks
helm delete komutu, chart ile ilişkili tüm Kubernetes bileşenlerini kaldırır ve sürümü siler.
4. Parametreler
Her parametreyi helm install komutuna --set key=value[,key=value] bağımsız değişkeniyle belirtin. Örneğin:
$ helm install documentserver onlyoffice/docs --set ingress.enabled=true,ingress.ssl.enabled=true,ingress.host=example.com
Bu komut ONLYOFFICE Docs'u HTTPS üzerinden dış erişime açar.
Alternatif olarak, chart kurulurken parametrelerin değerlerini belirten bir YAML dosyası da sağlanabilir:
$ helm install documentserver -f values.yaml onlyoffice/docs
Varsayılan values.yaml dosyasını kullanabilirsiniz.
Tüm parametreleri göster
| Parametre | Açıklama | Varsayılan |
|---|---|---|
connections.dbType | Veritabanı türü. Olası değerler: postgres, mariadb, mysql, oracle, mssql veya dameng | postgres |
connections.dbHost | Veritabanı ana bilgisayarının IP adresi veya adı | postgresql |
connections.dbUser | Veritabanı kullanıcısı | postgres |
connections.dbPort | Veritabanı sunucusu bağlantı noktası numarası | 5432 |
connections.dbName | Uygulamanın bağlanacağı veritabanının adı | postgres |
connections.dbPassword | Veritabanı kullanıcısının parolası. Ayarlanırsa connections.dbExistingSecret değerine göre önceliklidir | "" |
connections.dbSecretKeyName | Veritabanı kullanıcısının parolasını içeren anahtarın adı | postgres-password |
connections.dbExistingSecret | Veritabanı parolaları için kullanılacak mevcut secret'ın adı. connections.dbSecretKeyName içinde belirtilen anahtarı içermelidir | postgresql |
connections.redisConnectorName | Redis'e bağlanmak için hangi bağlayıcının kullanılacağını belirler. Redis Sentinel'e bağlanmanız gerekiyorsa değeri ioredis olarak ayarlayın | redis |
connections.redisHost | Redis ana bilgisayarının IP adresi veya adı. Değerler connections.redisClusterNodes ve connections.redisSentinelNodes içinde ayarlanmışsa kullanılmaz | redis-master |
connections.redisPort | Redis sunucusu bağlantı noktası numarası. Değerler connections.redisClusterNodes ve connections.redisSentinelNodes içinde ayarlanmışsa kullanılmaz | 6379 |
connections.redisUser | Redis kullanıcı adı. Özel yapılandırma dosyası eklerseniz bu parametredeki değer, local.json içindeki options nesnesinde ayarlanan değerin yerine geçer | default |
connections.redisDBNum | Seçilecek Redis mantıksal veritabanının numarası. Özel yapılandırma dosyası eklerseniz bu parametredeki değer, local.json içindeki options nesnesinde ayarlanan değerin yerine geçer | 0 |
connections.redisClusterNodes | Redis kümesindeki düğümlerin listesi. Kümedeki her düğümü belirtmeniz gerekmez, 3 düğüm yeterlidir. Birden fazla değer belirtebilirsiniz. host:port biçiminde belirtilmelidir | [] |
connections.redisPassword | Redis hesabı için ayarlanan parola. Ayarlanırsa connections.redisExistingSecret değerine göre önceliklidir. Özel yapılandırma dosyası eklerseniz bu parametredeki değer, local.json içindeki options nesnesinde ayarlanan değerin yerine geçer | "" |
connections.redisSecretKeyName | Redis kullanıcısının parolasını içeren anahtarın adı | redis-password |
connections.redisExistingSecret | Redis parolaları için kullanılacak mevcut secret'ın adı. connections.redisSecretKeyName içinde belirtilen anahtarı içermelidir. Bu secret'taki parola, local.json içindeki options nesnesinde ayarlanan parolanın yerine geçer | redis |
connections.redisNoPass | Redis kimlik doğrulamasının parolasız kullanılıp kullanılmayacağını belirler. Redis sunucusuna bağlantı parola gerektirmiyorsa değeri true olarak ayarlayın | false |
connections.redisSentinelNodes | Redis Sentinel düğümlerinin listesi. Her düğümü belirtmeniz gerekmez, 3 düğüm yeterlidir. Birden fazla değer belirtebilirsiniz. host:port biçiminde belirtilmelidir. connections.redisConnectorName değeri ioredis olarak ayarlanmışsa kullanılır | [] |
connections.redisSentinelGroupName | Bir master ve bir veya daha fazla slave'den oluşan Redis örnekleri grubunun adı. connections.redisConnectorName değeri ioredis olarak ayarlanmışsa kullanılır | mymaster |
connections.redisSentinelExistingSecret | Redis Sentinel parolası için kullanılacak mevcut secret'ın adı. connections.redisSentinelSecretKeyName içinde belirtilen anahtarı içermelidir. Bu secret'taki parola, local.json içindeki iooptions nesnesinde ayarlanan parolanın yerine geçer | "" |
connections.redisSentinelSecretKeyName | Redis Sentinel kullanıcısının parolasını içeren anahtarın adı. redisSentinelPassword içinde bir parola ayarlarsanız otomatik olarak bir secret oluşturulur ve bu secret'ın anahtar adı burada ayarlanan değer olur | sentinel-password |
connections.redisSentinelPassword | Redis Sentinel hesabı için ayarlanan parola. Ayarlanırsa connections.redisSentinelExistingSecret değerine göre önceliklidir. Bu parametredeki değer, local.json içindeki iooptions nesnesinde ayarlanan değerin yerine geçer | "" |
connections.redisSentinelNoPass | Redis Sentinel kimlik doğrulamasının parolasız kullanılıp kullanılmayacağını belirler. Redis Sentinel'e bağlantı parola gerektirmiyorsa değeri true olarak ayarlayın | true |
connections.amqpType | AMQP sunucusu türünü belirler. Olası değerler: rabbitmq veya activemq | rabbitmq |
connections.amqpHost | AMQP sunucusunun IP adresi veya adı | rabbitmq |
connections.amqpPort | AMQP sunucusuna bağlantı için bağlantı noktası | 5672 |
connections.amqpVhost | AMQP sunucusuna bağlantı için sanal ana bilgisayar (virtual host) | / |
connections.amqpUser | AMQP sunucusu hesabının kullanıcı adı | user |
connections.amqpProto | AMQP sunucusuna bağlantı için protokol | amqp |
connections.amqpPassword | AMQP sunucusu kullanıcısının parolası. Ayarlanırsa connections.amqpExistingSecret değerine göre önceliklidir | "" |
connections.amqpSecretKeyName | AMQP sunucusu kullanıcısının parolasını içeren anahtarın adı | rabbitmq-password |
connections.amqpExistingSecret | AMQP sunucusu parolaları için kullanılacak mevcut secret'ın adı. connections.amqpSecretKeyName içinde belirtilen anahtarı içermelidir | rabbitmq |
persistence.existingClaim | Kullanılacak mevcut PVC'nin adı. Belirtilmezse "ds-files" adlı bir PVC oluşturulur | "" |
persistence.annotations | "ds-files" PVC'sine ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
persistence.storageClass | Onlyoffice Docs verileri ve çalışma zamanı yapılandırma birimleri için PVC Storage Class | nfs |
persistence.size | ONLYOFFICE Docs birimi için PVC Storage Request | 8Gi |
persistence.storageS3 | S3'ün önbellek deposu olarak kullanılıp kullanılmayacağını belirler. S3'ü önbellek deposu olarak kullanacaksanız true olarak ayarlayın | false |
persistence.runtimeConfig.enabled | PVC'nin kullanılıp kullanılmayacağını ve kapsayıcılara bağlanıp bağlanmayacağını belirler | true |
persistence.runtimeConfig.existingClaim | Çalışma zamanı yapılandırmasını depolamak için kullanılan mevcut PVC'nin adı. Belirtilmezse "ds-runtime-config" adlı bir PVC oluşturulur | "" |
persistence.runtimeConfig.annotations | "ds-runtime-config" PVC'sine ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
persistence.runtimeConfig.size | Çalışma zamanı yapılandırma birimi için PVC Storage Request | 1Gi |
commonNameSuffix | Oluşturulan tüm kaynakların adına sonek olarak eklenecek ad | "" |
namespaceOverride | Onlyoffice Docs'un dağıtılacağı namespace'in adı. Ayarlanmazsa ad .Release.Namespace değerinden alınır | "" |
commonLabels | Dağıtılan tüm kaynaklara ek olarak eklenecek etiketleri tanımlar. Anahtarın değeri olarak tpl de kullanabilirsiniz | {} |
commonAnnotations | Dağıtılan tüm kaynaklara ek olarak eklenecek annotation'ları tanımlar. Anahtarın değeri olarak tpl de kullanabilirsiniz. Bazı kaynaklar burada belirtilen değerleri kendi değerleriyle geçersiz kılabilir | {} |
serviceAccount.create | ServiceAccount oluşturmayı etkinleştirir | false |
serviceAccount.name | Kullanılacak ServiceAccount'ın adı. Ayarlanmazsa ve serviceAccount.create değeri true ise ad .Release.Name değerinden alınır; serviceAccount.create değeri false ise ad "default" olur | "" |
serviceAccount.annotations | ServiceAccount için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
serviceAccount.automountServiceAccountToken | Oluşturulan serviceAccount üzerinde ServiceAccountToken'ın otomatik bağlanmasını etkinleştirir. Yalnızca serviceAccount.create değeri true ise kullanılır | true |
license.existingSecret | Lisansı içeren mevcut secret'ın adı. license.lic anahtarını içermelidir | "" |
license.existingClaim | Lisansın depolandığı mevcut PVC'nin adı. license.lic dosyasını içermelidir | "" |
log.level | Günlüğe kaydedilen olayın türünü ve önem derecesini belirler. Olası değerler: ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, MARK, OFF | WARN |
log.type | Günlüğe kaydedilen olayın biçimini belirler. Olası değerler: pattern, json, basic, coloured, messagePassThrough, dummy | pattern |
log.pattern | log.type=pattern ise günlük desenini belirler | [%d] [%p] %c - %.10000m |
wopi.enabled | WOPI'nin etkin olup olmadığını belirler. Parametre etkinse bağlanan dizin (PVC) için önbellekleme öznitelikleri istemcide devre dışı bırakılmalıdır | false |
wopi.keys.generation | API anahtarlarının oluşturulup oluşturulmayacağını belirler. wopi.enabled değerini true olarak ayarlarsanız kullanılır | true |
wopi.keys.newKeysExistingSecret | WOPI anahtarlarını içeren mevcut secret'ın adı. WOPI_PRIVATE_KEY, WOPI_PUBLIC_KEY, WOPI_MODULUS_KEY ve WOPI_EXPONENT_KEY anahtarlarını içermelidir. Ayarlanmazsa yeni anahtarlar oluşturulur ve bunlardan bir secret oluşturulur | "" |
wopi.keys.oldKeysExistingSecret | Eski WOPI anahtarlarını içeren mevcut secret'ın adı. WOPI_PRIVATE_KEY_OLD, WOPI_PUBLIC_KEY_OLD, WOPI_MODULUS_KEY_OLD ve WOPI_EXPONENT_KEY_OLD anahtarlarını içermelidir. Ayarlanmazsa yeni anahtarlar oluşturulur ve bunlardan bir secret oluşturulur | "" |
metrics.enabled | ONLYOFFICE Docs için StatsD'nin etkin olup olmadığını belirtir | false |
metrics.host | StatsD dinleme ana bilgisayarını belirler | statsd-exporter-prometheus-statsd-exporter |
metrics.port | StatsD dinleme bağlantı noktasını belirler | 8125 |
metrics.prefix | Arka uç hizmetleri için StatsD metrik önekini belirler | ds. |
extraConf.configMap | Varsayılan değerlerin yerine geçen json dosyasını içeren ConfigMap'in adı | "" |
extraConf.filename | Özel değerleri içeren json dosyasının adı. extraConf.ConfigMap içindeki key adıyla aynı olmalıdır | local.json |
extraThemes.configMap | Arayüz temalarını içeren json dosyasını barındıran ConfigMap'in adı | "" |
extraThemes.filename | Özel arayüz temalarını içeren json dosyasının adı. extraThemes.configMap içindeki key adıyla aynı olmalıdır | custom-themes.json |
podAntiAffinity.type | Pod antiaffinity türleri. İzin verilen değerler: soft veya hard | soft |
podAntiAffinity.topologyKey | Eşleştirilecek düğüm etiketi anahtarı | kubernetes.io/hostname |
podAntiAffinity.weight | Düğüm seçilirken öncelik. 1 ile 100 arasında bir değerdir | 100 |
nodeSelector | Pod'ların atanması için düğüm etiketleri. Her ONLYOFFICE Docs hizmeti burada belirtilen değerleri kendi değerleriyle geçersiz kılabilir | {} |
tolerations | Pod'ların atanması için toleration'lar. Her ONLYOFFICE Docs hizmeti burada belirtilen değerleri kendi değerleriyle geçersiz kılabilir | [] |
imagePullSecrets | Kapsayıcı imajı kayıt defteri secret'ının adı | "" |
requestFilteringAgent.allowPrivateIPAddress | Özel IP adresine bağlanmaya izin verilip verilmediğini belirler. JWT devre dışıysa (jwt.enabled=false) requestFilteringAgent parametreleri kullanılır | false |
requestFilteringAgent.allowMetaIPAddress | Meta adrese bağlanmaya izin verilip verilmediğini belirler | false |
requestFilteringAgent.allowIPAddressList | Bağlanmasına izin verilen IP adreslerinin listesini belirler. Bu değerler requestFilteringAgent.denyIPAddressList değerlerine göre önceliklidir | [] |
requestFilteringAgent.denyIPAddressList | Bağlanmasına izin verilmeyen IP adreslerinin listesini belirler | [] |
docservice.annotations | Docservice Deployment için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
docservice.podAnnotations | Docservice deployment Pod'ları için eklenecek annotation eşlemesi | rollme: "{{ randAlphaNum 5 | quote }}" |
docservice.replicas | Docservice çoğaltma (replica) sayısı. docservice.autoscaling.enabled parametresi etkinse yok sayılır | 2 |
docservice.updateStrategy.type | Docservice deployment güncelleme stratejisi türü | Recreate |
docservice.customPodAntiAffinity | Docservice Pods için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
docservice.podAffinity | Docservice Pods için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
docservice.nodeAffinity | Docservice Pods için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
docservice.nodeSelector | Docservice Pods atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
docservice.tolerations | Docservice Pods atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
docservice.terminationGracePeriodSeconds | Docservice Pod için Terminating durumunda kalacağı düzgün sonlandırma süresi | 30 |
docservice.hostAliases | Docservice ve Proxy kapsayıcılarındaki hosts dosyasına ek girdiler ekler | [] |
docservice.initContainers | Docservice deployment Pod'unda docservice ve proxy kapsayıcılarından önce çalışan kapsayıcıları tanımlar. Örneğin PersistentVolume'un sahibini değiştiren bir kapsayıcı | [] |
docservice.image.repository | Docservice kapsayıcı imajı deposu* | onlyoffice/docs-docservice-de |
docservice.image.tag | Docservice kapsayıcı imajı etiketi | 9.0.4-1 |
docservice.image.pullPolicy | Docservice kapsayıcı imajı çekme ilkesi | IfNotPresent |
docservice.containerSecurityContext.enabled | Docservice kapsayıcısı için security context'i etkinleştirir | false |
docservice.lifecycleHooks | Docservice kapsayıcı yaşam döngüsü kancalarını (lifecycle hooks) tanımlar. Kapsayıcının yaşam döngüsünün belirli noktalarında çalışacak olayları tetiklemek için kullanılır | {} |
docservice.resources.requests | Docservice kapsayıcısı için istenen kaynaklar | {} |
docservice.resources.limits | Docservice kapsayıcısı için kaynak sınırları | {} |
docservice.extraEnvVars | Docservice kapsayıcısı için ek ortam değişkenleri dizisi | [] |
docservice.extraVolumes | Docservice Pod'u için ek birimler (volumes) dizisi | [] |
docservice.extraVolumeMounts | Docservice kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi | [] |
docservice.readinessProbe.enabled | Docservice kapsayıcısı için readinessProbe'u etkinleştirir | true |
docservice.livenessProbe.enabled | Docservice kapsayıcısı için livenessProbe'u etkinleştirir | true |
docservice.startupProbe.enabled | Docservice kapsayıcısı için startupProbe'u etkinleştirir | true |
docservice.autoscaling.enabled | Docservice deployment için otomatik ölçeklemeyi etkinleştirir | false |
docservice.autoscaling.annotations | Docservice deployment HPA için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
docservice.autoscaling.minReplicas | Docservice deployment otomatik ölçeklemesi için en az çoğaltma sayısı | 2 |
docservice.autoscaling.maxReplicas | Docservice deployment otomatik ölçeklemesi için en çok çoğaltma sayısı | 4 |
docservice.autoscaling.targetCPU.enabled | Docservice deployment için CPU kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirir | true |
docservice.autoscaling.targetCPU.utilizationPercentage | Docservice deployment otomatik ölçeklemesi için hedef CPU yüzdesi | 70 |
docservice.autoscaling.targetMemory.enabled | Docservice deployment için bellek kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirir | false |
docservice.autoscaling.targetMemory.utilizationPercentage | Docservice deployment otomatik ölçeklemesi için hedef bellek yüzdesi | 70 |
docservice.autoscaling.customMetricsType | Docservice deployment için özel, ek veya harici otomatik ölçekleme metrikleri | [] |
docservice.autoscaling.behavior | scaleDown ve scaleUp alanları için Docservice deployment ölçekleme davranışı ilkelerini yapılandırır | {} |
proxy.accessLog | nginx yapılandırmasındaki access_log biçim yönergesini belirler | off |
proxy.logFormat | Günlük girdilerinin biçimini metin ve çeşitli değişkenler kullanarak belirler | '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"' |
proxy.gzipProxied | nginx yapılandırmasındaki gzip_proxied yönergesini belirler | off |
proxy.clientMaxBodySize | nginx yapılandırmasındaki client_max_body_size yönergesini belirler | 100m |
proxy.workerConnections | nginx yapılandırmasındaki worker_connections yönergesini belirler | 4096 |
proxy.secureLinkSecret | nginx yapılandırma yönergesi secure_link_md5 için gizli anahtarı belirler. Değer boşsa rastgele bir değer oluşturulur ve bu değer sonraki güncellemelerde kullanılır. Değer ayarlanırsa o değer kullanılır | "" |
proxy.secureLinkExistingSecret | secure_link için kullanılacak mevcut secret'ın adı. Ayarlanırsa proxy.secureLinkSecret değerine göre önceliklidir | "" |
proxy.infoAllowedIP | Bilgi sayfasına erişim için IP adreslerini belirler | [] |
proxy.infoAllowedUser | Bilgi sayfasına erişim için kullanıcı adını belirler. Ayarlanmazsa bilgi sayfasına erişimde Nginx Basic Authentication uygulanmaz. Daha fazla bilgi için buraya bakın | "" |
proxy.infoAllowedPassword | Bilgi sayfasına erişim için kullanıcı parolasını belirler. proxy.infoAllowedUser ayarlanmışsa kullanılır. Değer boşsa rastgele bir değer oluşturulur ve bu değer sonraki güncellemelerde kullanılır. Değer ayarlanırsa o değer kullanılır | "" |
proxy.infoAllowedSecretKeyName | Bilgi sayfası kimlik doğrulama kullanıcısının parolasını içeren anahtarın adı. proxy.infoAllowedUser ayarlanmışsa kullanılır | info-auth-password |
proxy.infoAllowedExistingSecret | Bilgi sayfası kimlik doğrulama parolası için kullanılacak mevcut secret'ın adı. proxy.infoAllowedUser ayarlanmışsa kullanılır. proxy.infoAllowedSecretKeyName içinde belirtilen anahtarı içermelidir. Ayarlanırsa proxy.infoAllowedPassword değerine göre önceliklidir | "" |
proxy.welcomePage.enabled | Karşılama sayfasının görüntülenip görüntülenmeyeceğini belirler | true |
proxy.image.repository | Docservice Proxy kapsayıcı imajı deposu* | onlyoffice/docs-proxy-de |
proxy.image.tag | Docservice Proxy kapsayıcı imajı etiketi | 9.0.4-1 |
proxy.image.pullPolicy | Docservice Proxy kapsayıcı imajı çekme ilkesi | IfNotPresent |
proxy.containerSecurityContext.enabled | Proxy kapsayıcısı için security context'i etkinleştirir | false |
proxy.lifecycleHooks | Proxy kapsayıcı yaşam döngüsü kancalarını (lifecycle hooks) tanımlar. Kapsayıcının yaşam döngüsünün belirli noktalarında çalışacak olayları tetiklemek için kullanılır | {} |
proxy.resources.requests | Proxy kapsayıcısı için istenen kaynaklar | {} |
proxy.resources.limits | Proxy kapsayıcısı için kaynak sınırları | {} |
proxy.extraEnvVars | Proxy kapsayıcısı için ek ortam değişkenleri dizisi | [] |
proxy.extraVolumeMounts | Proxy kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi | [] |
proxy.readinessProbe.enabled | Proxy kapsayıcısı için readinessProbe'u etkinleştirir | true |
proxy.livenessProbe.enabled | Proxy kapsayıcısı için livenessProbe'u etkinleştirir | true |
proxy.startupProbe.enabled | Proxy kapsayıcısı için startupProbe'u etkinleştirir | true |
converter.annotations | Converter Deployment için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
converter.podAnnotations | Converter deployment Pod'ları için eklenecek annotation eşlemesi | rollme: "{{ randAlphaNum 5 | quote }}" |
converter.replicas | Converter çoğaltma (replica) sayısı. converter.autoscaling.enabled parametresi etkinse yok sayılır | 2 |
converter.updateStrategy.type | Converter deployment güncelleme stratejisi türü | Recreate |
converter.customPodAntiAffinity | Converter Pods için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
converter.podAffinity | Converter Pods için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
converter.nodeAffinity | Converter Pods için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
converter.nodeSelector | Converter Pods atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
converter.tolerations | Converter Pods atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
converter.terminationGracePeriodSeconds | Converter Pod için Terminating durumunda kalacağı düzgün sonlandırma süresi | 30 |
converter.hostAliases | Converter kapsayıcısındaki hosts dosyasına ek girdiler ekler | [] |
converter.initContainers | Converter deployment Pod'unda Converter kapsayıcısından önce çalışan kapsayıcıları tanımlar. Örneğin PersistentVolume'un sahibini değiştiren bir kapsayıcı | [] |
converter.image.repository | Converter kapsayıcı imajı deposu* | onlyoffice/docs-converter-de |
converter.image.tag | Converter kapsayıcı imajı etiketi | 9.0.4-1 |
converter.image.pullPolicy | Converter kapsayıcı imajı çekme ilkesi | IfNotPresent |
converter.containerSecurityContext.enabled | Converter kapsayıcısı için security context'i etkinleştirir | false |
converter.lifecycleHooks | Converter kapsayıcı yaşam döngüsü kancalarını (lifecycle hooks) tanımlar. Kapsayıcının yaşam döngüsünün belirli noktalarında çalışacak olayları tetiklemek için kullanılır | {} |
converter.resources.requests | Converter kapsayıcısı için istenen kaynaklar | {} |
converter.resources.limits | Converter kapsayıcısı için kaynak sınırları | {} |
converter.extraEnvVars | Converter kapsayıcısı için ek ortam değişkenleri dizisi | [] |
converter.extraVolumes | Converter Pod'u için ek birimler (volumes) dizisi | [] |
converter.extraVolumeMounts | Converter kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi | [] |
converter.autoscaling.enabled | Converter deployment için otomatik ölçeklemeyi etkinleştirir | false |
converter.autoscaling.annotations | Converter deployment HPA için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
converter.autoscaling.minReplicas | Converter deployment otomatik ölçeklemesi için en az çoğaltma sayısı | 2 |
converter.autoscaling.maxReplicas | Converter deployment otomatik ölçeklemesi için en çok çoğaltma sayısı | 16 |
converter.autoscaling.targetCPU.enabled | converter deployment için CPU kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirir | true |
converter.autoscaling.targetCPU.utilizationPercentage | Converter deployment otomatik ölçeklemesi için hedef CPU yüzdesi | 70 |
converter.autoscaling.targetMemory.enabled | Converter deployment için bellek kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirir | false |
converter.autoscaling.targetMemory.utilizationPercentage | Converter deployment otomatik ölçeklemesi için hedef bellek yüzdesi | 70 |
converter.autoscaling.customMetricsType | Converter deployment için özel, ek veya harici otomatik ölçekleme metrikleri | [] |
converter.autoscaling.behavior | scaleDown ve scaleUp alanları için Converter deployment ölçekleme davranışı ilkelerini yapılandırır | {} |
example.enabled | Example'ın kurulumunu etkinleştirir | false |
example.annotations | Example StatefulSet için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
example.podAnnotations | Example Pod için eklenecek annotation eşlemesi | rollme: "{{ randAlphaNum 5 | quote }}" |
example.updateStrategy.type | Example StatefulSet güncelleme stratejisi türü | RollingUpdate |
example.customPodAntiAffinity | Example Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
example.podAffinity | Example Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
example.nodeAffinity | Example Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
example.nodeSelector | Example Pods atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
example.tolerations | Example Pods atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
example.terminationGracePeriodSeconds | Example Pod için Terminating durumunda kalacağı düzgün sonlandırma süresi | 30 |
example.hostAliases | Example kapsayıcısındaki hosts dosyasına ek girdiler ekler | [] |
example.initContainers | Pod içinde Example kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
example.image.repository | Example kapsayıcı imajı adı | onlyoffice/docs-example |
example.image.tag | Example kapsayıcı imajı etiketi | 9.0.4-1 |
example.image.pullPolicy | Example kapsayıcı imajı çekme ilkesi | IfNotPresent |
example.containerSecurityContext.enabled | Example kapsayıcısı için security context'i etkinleştirir | false |
example.dsUrl | ONLYOFFICE Docs harici adresi. Yalnızca Example'da dönüştürme işleminin çalışmasını denetlemek gerekirse değiştirilmelidir (örneğin http://<documentserver-address>/) | / |
example.resources.requests | Example kapsayıcısı için istenen kaynaklar | {} |
example.resources.limits | Example kapsayıcısı için kaynak sınırları | {} |
example.extraEnvVars | Example kapsayıcısı için ek ortam değişkenleri dizisi | [] |
example.extraConf.configMap | Varsayılan değerlerin yerine geçen json dosyasını içeren ConfigMap'in adı. Oluşturma örneği için buraya bakın | "" |
example.extraConf.filename | Özel değerleri içeren json dosyasının adı. example.extraConf.ConfigMap içindeki key adıyla aynı olmalıdır | local.json |
example.extraVolumes | Example Pod'u için ek birimler (volumes) dizisi | [] |
example.extraVolumeMounts | Example kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi | [] |
jwt.enabled | ONLYOFFICE Docs tarafından JSON Web Token doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Gelen (inbox) ve giden (outbox) istekler için ortaktır | true |
jwt.secret | ONLYOFFICE Docs'a gönderilen istekteki JSON Web Token'ı doğrulamak için gizli anahtarı belirler. Gelen (inbox) ve giden (outbox) istekler için ortaktır. Değer boşsa rastgele bir değer oluşturulur ve bu değer sonraki güncellemelerde kullanılır. Değer ayarlanırsa o değer kullanılır | "" |
jwt.header | JSON Web Token'ı göndermek için kullanılacak http başlığını belirler. Gelen (inbox) ve giden (outbox) istekler için ortaktır | Authorization |
jwt.inBody | ONLYOFFICE Docs'a gönderilen isteğin gövdesinde belirteç doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirtir | false |
jwt.inbox | Yalnızca gelen (inbox) istekler için JSON Web Token doğrulama parametreleri. Belirtilmezse ortak jwt parametrelerinin değerleri kullanılır | {} |
jwt.outbox | Yalnızca giden (outbox) istekler için JSON Web Token doğrulama parametreleri. Belirtilmezse ortak jwt parametrelerinin değerleri kullanılır | {} |
jwt.existingSecret | jwt değişkenlerini içeren mevcut secret'ın adı. Belirtilmezse jwt adlı bir secret oluşturulur | "" |
service.existing | ONLYOFFICE Docs için mevcut bir servisin adı. Belirtilmezse documentserver adlı bir servis oluşturulur | "" |
service.annotations | ONLYOFFICE Docs service için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
service.type | ONLYOFFICE Docs servis türü | ClusterIP |
service.port | ONLYOFFICE Docs servis bağlantı noktası | 8888 |
service.sessionAffinity | ONLYOFFICE Docs servisi için Session Affinity. Ayarlanmazsa varsayılan değer olarak None kullanılır | "" |
service.sessionAffinityConfig | ONLYOFFICE Docs servisi Session Affinity için yapılandırma. service.sessionAffinity ayarlanmışsa kullanılır | {} |
ingress.enabled | ONLYOFFICE Docs için ingress oluşturmayı etkinleştirir | false |
ingress.annotations | Ingress için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir | nginx.ingress.kubernetes.io/proxy-body-size: 100m |
ingress.ingressClassName | Bu Ingress'i uygulamak için kullanılacak IngressClass'a başvurmak için kullanılır | nginx |
ingress.controllerName | Aynı IngressClassName değerine sahip ancak farklı sağlayıcılardan gelen denetleyicileri ayırt etmek için kullanılır | ingress-nginx |
ingress.host | ONLYOFFICE Docs ingress için Ingress ana bilgisayar adı | "" |
ingress.tenants | Birden fazla ad kullanmanız gerekiyorsa Ingress ana bilgisayar adları (örneğin çoklu kiracılık için). Ayarlanırsa ingress.host değerine göre önceliklidir. ingress.ssl.enabled değeri true ise belirtilen tüm alan adları için sertifikanın ingress.ssl.secret tarafından gizli tutulduğu varsayılır | [] |
ingress.ssl.enabled | ONLYOFFICE Docs ingress için ssl'yi etkinleştirir | false |
ingress.ssl.secret | Ingress'e bağlanacak ssl için secret adı | tls |
ingress.path | ONLYOFFICE Docs'a erişilecek yolu belirtir | / |
ingress.pathType | ONLYOFFICE Docs ingress kaynağı için yol türünü belirtir. İzin verilen değerler: Exact, Prefix veya ImplementationSpecific | ImplementationSpecific |
ingress.letsencrypt.enabled | Let's Encrypt'te sertifika isteği oluşturmayı etkinleştirir. ingress.enabled değeri true ise kullanılır | false |
ingress.letsencrypt.clusterIssuerName | ClusterIssuer adı | letsencrypt-prod |
ingress.letsencrypt.email | ACME kaydı için kullanılan e-posta adresiniz | "" |
ingress.letsencrypt.server | Sertifika isteklerinin gönderileceği Let's Encrypt sunucusunun adresi | https://acme-v02.api.letsencrypt.org/directory |
ingress.letsencrypt.secretName | ACME hesabının özel anahtarını depolamak için kullanılan secret'ın adı | letsencrypt-prod-private-key |
openshift.route.enabled | ONLYOFFICE Docs için OpenShift Route oluşturmayı etkinleştirir | false |
openshift.route.annotations | OpenShift Route için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
openshift.route.host | ONLYOFFICE Docs route için OpenShift Route ana bilgisayar adı | "" |
openshift.route.path | ONLYOFFICE Docs'a erişilecek yolu belirtir | / |
openshift.route.wildcardPolicy | OpenShift Route'ta joker karakterli alt alan adlarının işlenme ilkesi. İzin verilen değerler: None, Subdomain | None |
grafana.enabled | Grafana'da metriklerin görselleştirilmesi için gereken kaynakların kurulumunu etkinleştirir | false |
grafana.namespace | RBAC bileşenlerinin ve Grafana kaynaklarının dağıtılacağı namespace'in adı. Ayarlanmazsa ad, ayarlıysa namespaceOverride değerinden, değilse .Release.Namespace değerinden alınır | "" |
grafana.ingress.enabled | Grafana için ingress oluşturmayı etkinleştirir. grafana.enabled değerini true olarak ayarlarsanız ve Grafana'ya erişmek için Nginx Ingress kullanmak isterseniz kullanılır | false |
grafana.ingress.annotations | Grafana Ingress için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir | nginx.ingress.kubernetes.io/proxy-body-size: 100m |
grafana.dashboard.enabled | Hazır Grafana panolarının kurulumunu etkinleştirir. grafana.enabled değerini true olarak ayarlarsanız kullanılır | false |
podSecurityContext.enabled | Pod'lar için security context'i etkinleştirir | false |
podSecurityContext.converter.fsGroup | Converter Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler | 101 |
podSecurityContext.docservice.fsGroup | Docservice Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler | 101 |
podSecurityContext.jobs.fsGroup | Job'lar tarafından oluşturulan Pod'lara bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler | 101 |
podSecurityContext.example.fsGroup | Example Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler | 1001 |
podSecurityContext.tests.fsGroup | Test Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler | 101 |
webProxy.enabled | Ağınızda k8s kümesinin Pod'larının İnternet'e erişmesi için bir Web proxy kullanılıp kullanılmadığını belirtir | false |
webProxy.http | HTTP trafiği için Web Proxy adresi | http://proxy.example.com |
webProxy.https | HTTPS trafiği için Web Proxy adresi | https://proxy.example.com |
webProxy.noProxy | Web Proxy kullanmaması gereken IP adresleri, k8s servis adları veya alan adları için desenler | localhost,127.0.0.1,docservice |
upgrade.job.enabled | ONLYOFFICE Docs güncellenmeden önce pre-upgrade job'unun çalıştırılmasını etkinleştirir | true |
upgrade.job.annotations | pre-upgrade Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
upgrade.job.podAnnotations | pre-upgrade Pod için eklenecek annotation eşlemesi | {} |
upgrade.job.customPodAntiAffinity | pre-upgrade Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
upgrade.job.podAffinity | pre-upgrade Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
upgrade.job.nodeAffinity | pre-upgrade Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
upgrade.job.nodeSelector | pre-upgrade Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
upgrade.job.tolerations | pre-upgrade Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
upgrade.job.initContainers | Pod içinde pre-upgrade kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
upgrade.job.image.repository | upgrade için Job imajı deposu | onlyoffice/docs-utils |
upgrade.job.image.tag | upgrade için Job imajı etiketi | 9.0.4-1 |
upgrade.job.image.pullPolicy | upgrade için Job imajı çekme ilkesi | IfNotPresent |
upgrade.job.containerSecurityContext.enabled | pre-upgrade kapsayıcısı için security context'i etkinleştirir | false |
upgrade.job.resources.requests | job pre-upgrade kapsayıcısı için istenen kaynaklar | {} |
upgrade.job.resources.limits | job pre-upgrade kapsayıcısı için kaynak sınırları | {} |
upgrade.existingConfigmap.tblRemove.name | Veritabanındaki tabloları silmeye yönelik sql dosyasını içeren mevcut ConfigMap'in adı | remove-db-scripts |
upgrade.existingConfigmap.tblRemove.keyName | Veritabanındaki tabloları silme yönergelerini içeren sql dosyasının adı. upgrade.existingConfigmap.tblRemove.name içindeki key adıyla aynı olmalıdır | removetbl.sql |
upgrade.existingConfigmap.tblCreate.name | Veritabanında tabloları oluşturmaya yönelik sql dosyasını içeren mevcut ConfigMap'in adı | init-db-scripts |
upgrade.existingConfigmap.tblCreate.keyName | Veritabanında tabloları oluşturma yönergelerini içeren sql dosyasının adı. upgrade.existingConfigmap.tblCreate.name içindeki key adıyla aynı olmalıdır | createdb.sql |
upgrade.existingConfigmap.dsStop | ONLYOFFICE Docs güncelleme betiğini içeren mevcut ConfigMap'in adı. Ayarlanırsa önceki dört parametre yok sayılır. stop.sh anahtarını içermelidir | "" |
rollback.job.enabled | ONLYOFFICE Docs geri alınmadan önce pre-rollback job'unun çalıştırılmasını etkinleştirir | true |
rollback.job.annotations | pre-rollback Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
rollback.job.podAnnotations | pre-rollback Pod için eklenecek annotation eşlemesi | {} |
rollback.job.customPodAntiAffinity | pre-rollback Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
rollback.job.podAffinity | pre-rollback Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
rollback.job.nodeAffinity | pre-rollback Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
rollback.job.nodeSelector | pre-rollback Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
rollback.job.tolerations | pre-rollback Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
rollback.job.initContainers | Pod içinde pre-rollback kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
rollback.job.image.repository | rollback için Job imajı deposu | onlyoffice/docs-utils |
rollback.job.image.tag | rollback için Job imajı etiketi | 9.0.4-1 |
rollback.job.image.pullPolicy | rollback için Job imajı çekme ilkesi | IfNotPresent |
rollback.job.containerSecurityContext.enabled | pre-rollback kapsayıcısı için security context'i etkinleştirir | false |
rollback.job.resources.requests | job rollback kapsayıcısı için istenen kaynaklar | {} |
rollback.job.resources.limits | job rollback kapsayıcısı için kaynak sınırları | {} |
rollback.existingConfigmap.tblRemove.name | Veritabanındaki tabloları silmeye yönelik sql dosyasını içeren mevcut ConfigMap'in adı | remove-db-scripts |
rollback.existingConfigmap.tblRemove.keyName | Veritabanındaki tabloları silme yönergelerini içeren sql dosyasının adı. rollback.existingConfigmap.tblRemove.name içindeki key adıyla aynı olmalıdır | removetbl.sql |
rollback.existingConfigmap.tblCreate.name | Veritabanında tabloları oluşturmaya yönelik sql dosyasını içeren mevcut ConfigMap'in adı | init-db-scripts |
rollback.existingConfigmap.tblCreate.keyName | Veritabanında tabloları oluşturma yönergelerini içeren sql dosyasının adı. rollback.existingConfigmap.tblCreate.name içindeki key adıyla aynı olmalıdır | createdb.sql |
rollback.existingConfigmap.dsStop | ONLYOFFICE Docs geri alma betiğini içeren mevcut ConfigMap'in adı. Ayarlanırsa önceki dört parametre yok sayılır. stop.sh anahtarını içermelidir | "" |
delete.job.enabled | ONLYOFFICE Docs silinmeden önce pre-delete job'unun çalıştırılmasını etkinleştirir | true |
delete.job.annotations | pre-delete Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
delete.job.podAnnotations | pre-delete Pod için eklenecek annotation eşlemesi | {} |
delete.job.customPodAntiAffinity | pre-delete Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
delete.job.podAffinity | pre-delete Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
delete.job.nodeAffinity | pre-delete Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
delete.job.nodeSelector | pre-delete Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
delete.job.tolerations | pre-delete Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
delete.job.initContainers | Pod içinde pre-delete kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
delete.job.image.repository | delete için Job imajı deposu | onlyoffice/docs-utils |
delete.job.image.tag | delete için Job imajı etiketi | 9.0.4-1 |
delete.job.image.pullPolicy | delete için Job imajı çekme ilkesi | IfNotPresent |
delete.job.containerSecurityContext.enabled | pre-delete kapsayıcısı için security context'i etkinleştirir | false |
delete.job.resources.requests | job delete kapsayıcısı için istenen kaynaklar | {} |
delete.job.resources.limits | job delete kapsayıcısı için kaynak sınırları | {} |
delete.existingConfigmap.tblRemove.name | Veritabanındaki tabloları silmeye yönelik sql dosyasını içeren mevcut ConfigMap'in adı | remove-db-scripts |
delete.existingConfigmap.tblRemove.keyName | Veritabanındaki tabloları silme yönergelerini içeren sql dosyasının adı. delete.existingConfigmap.tblRemove.name içindeki key adıyla aynı olmalıdır | removetbl.sql |
delete.existingConfigmap.dsStop | ONLYOFFICE Docs silme betiğini içeren mevcut ConfigMap'in adı. Ayarlanırsa önceki iki parametre yok sayılır. stop.sh anahtarını içermelidir | "" |
install.job.enabled | ONLYOFFICE Docs kurulmadan önce pre-install job'unun çalıştırılmasını etkinleştirir | true |
install.job.annotations | pre-install Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
install.job.podAnnotations | pre-install Pod için eklenecek annotation eşlemesi | {} |
install.job.customPodAntiAffinity | pre-install Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
install.job.podAffinity | pre-install Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
install.job.nodeAffinity | pre-install Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
install.job.nodeSelector | pre-install Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
install.job.tolerations | pre-install Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
install.job.initContainers | Pod içinde pre-install kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
install.job.image.repository | pre-install ONLYOFFICE Docs için Job imajı deposu | onlyoffice/docs-utils |
install.job.image.tag | pre-install ONLYOFFICE Docs için Job imajı etiketi | 9.0.4-1 |
install.job.image.pullPolicy | pre-install ONLYOFFICE Docs için Job imajı çekme ilkesi | IfNotPresent |
install.job.containerSecurityContext.enabled | pre-install kapsayıcısı için security context'i etkinleştirir | false |
install.job.resources.requests | job pre-install kapsayıcısı için istenen kaynaklar | {} |
install.job.resources.limits | job pre-install kapsayıcısı için kaynak sınırları | {} |
install.existingConfigmap.tblCreate.name | Veritabanında tabloları oluşturmaya yönelik sql dosyasını içeren mevcut ConfigMap'in adı | init-db-scripts |
install.existingConfigmap.tblCreate.keyName | Veritabanında tabloları oluşturma yönergelerini içeren sql dosyasının adı. install.existingConfigmap.tblCreate.name içindeki key adıyla aynı olmalıdır | createdb.sql |
install.existingConfigmap.initdb | initdb betiğini içeren mevcut ConfigMap'in adı. Ayarlanırsa önceki iki parametre yok sayılır. initdb.sh anahtarını içermelidir | "" |
clearCache.job.enabled | ONLYOFFICE Docs güncellendikten sonra Clear Cache job'unun çalıştırılmasını etkinleştirir. Clear Cache job'unun, Kubernetes'te tüm kaynaklar güncellendikten sonra çalışan bir post-upgrade kancası (hook) vardır. Bu job Cache dizinini temizler | true |
clearCache.job.annotations | Clear Cache Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
clearCache.job.podAnnotations | Clear Cache Pod için eklenecek annotation eşlemesi | {} |
clearCache.job.customPodAntiAffinity | Clear Cache Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
clearCache.job.podAffinity | Clear Cache Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
clearCache.job.nodeAffinity | Clear Cache Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
clearCache.job.nodeSelector | Clear Cache Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
clearCache.job.tolerations | Clear Cache Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
clearCache.job.initContainers | Pod içinde Clear Cache kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
clearCache.job.image.repository | Clear Cache ONLYOFFICE Docs için Job imajı deposu | onlyoffice/docs-utils |
clearCache.job.image.tag | Clear Cache ONLYOFFICE Docs için Job imajı etiketi | 9.0.4-1 |
clearCache.job.image.pullPolicy | Clear Cache ONLYOFFICE Docs için Job imajı çekme ilkesi | IfNotPresent |
clearCache.job.containerSecurityContext.enabled | Clear Cache kapsayıcısı için security context'i etkinleştirir | false |
clearCache.job.resources.requests | job Clear Cache kapsayıcısı için istenen kaynaklar | {} |
clearCache.job.resources.limits | job Clear Cache kapsayıcısı için kaynak sınırları | {} |
clearCache.existingConfigmap.name | Cache dizinini temizleyen özel betiği içeren mevcut ConfigMap'in adı. Ayarlanırsa varsayılan configmap oluşturulmaz | "" |
clearCache.existingConfigmap.keyName | Cache dizinini temizleme yönergelerini içeren betiğin adı. Özel bir betik kullanılıyorsa clearCache.existingConfigmap.name içindeki key adıyla aynı olmalıdır | clearCache.sh |
grafanaDashboard.job.annotations | Grafana Dashboard Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
grafanaDashboard.job.podAnnotations | Grafana Dashboard Pod için eklenecek annotation eşlemesi | {} |
grafanaDashboard.job.customPodAntiAffinity | Grafana Dashboard Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
grafanaDashboard.job.podAffinity | Grafana Dashboard Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
grafanaDashboard.job.nodeAffinity | Grafana Dashboard Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
grafanaDashboard.job.nodeSelector | Grafana Dashboard Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
grafanaDashboard.job.tolerations | Grafana Dashboard Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
grafanaDashboard.job.initContainers | Pod içinde Grafana Dashboard kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
grafanaDashboard.job.image.repository | Grafana Dashboard ONLYOFFICE Docs için Job imajı deposu | onlyoffice/docs-utils |
grafanaDashboard.job.image.tag | Grafana Dashboard ONLYOFFICE Docs için Job imajı etiketi | 9.0.4-1 |
grafanaDashboard.job.image.pullPolicy | Grafana Dashboard ONLYOFFICE Docs için Job imajı çekme ilkesi | IfNotPresent |
grafanaDashboard.job.containerSecurityContext.enabled | Grafana Dashboard kapsayıcısı için security context'i etkinleştirir | false |
grafanaDashboard.job.resources.requests | job Grafana Dashboard kapsayıcısı için istenen kaynaklar | {} |
grafanaDashboard.job.resources.limits | job Grafana Dashboard kapsayıcısı için kaynak sınırları | {} |
wopiKeysGeneration.job.annotations | Wopi Keys Generation Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
wopiKeysGeneration.job.podAnnotations | Wopi Keys Generation Pod için eklenecek annotation eşlemesi | {} |
wopiKeysGeneration.job.customPodAntiAffinity | Wopi Keys Generation Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
wopiKeysGeneration.job.podAffinity | Wopi Keys Generation Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
wopiKeysGeneration.job.nodeAffinity | Wopi Keys Generation Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
wopiKeysGeneration.job.nodeSelector | Wopi Keys Generation Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
wopiKeysGeneration.job.tolerations | Wopi Keys Generation Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
wopiKeysGeneration.job.initContainers | Pod içinde Wopi Keys Generation kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
wopiKeysGeneration.job.image.repository | Wopi Keys Generation ONLYOFFICE Docs için Job imajı deposu | onlyoffice/docs-utils |
wopiKeysGeneration.job.image.tag | Wopi Keys Generation ONLYOFFICE Docs için Job imajı etiketi | 9.0.4-1 |
wopiKeysGeneration.job.image.pullPolicy | Wopi Keys Generation ONLYOFFICE Docs için Job imajı çekme ilkesi | IfNotPresent |
wopiKeysGeneration.job.containerSecurityContext.enabled | Wopi Keys Generation kapsayıcısı için security context'i etkinleştirir | false |
wopiKeysGeneration.job.resources.requests | job Wopi Keys Generation kapsayıcısı için istenen kaynaklar | {} |
wopiKeysGeneration.job.resources.limits | job Wopi Keys Generation kapsayıcısı için kaynak sınırları | {} |
wopiKeysDeletion.job.enabled | ONLYOFFICE Docs silinmeden önce Wopi Keys Deletion job'unun çalıştırılmasını etkinleştirir. Bu job, otomatik olarak oluşturulan WOPI secret'larını kaldırır. wopi.enabled, wopi.keys.generation ve wopiKeysDeletion.job.enabled değerleri true ise çalıştırılır | true |
wopiKeysDeletion.job.annotations | Wopi Keys Deletion Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
wopiKeysDeletion.job.podAnnotations | Wopi Keys Deletion Pod için eklenecek annotation eşlemesi | {} |
wopiKeysDeletion.job.customPodAntiAffinity | Wopi Keys Deletion Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
wopiKeysDeletion.job.podAffinity | Wopi Keys Deletion Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
wopiKeysDeletion.job.nodeAffinity | Wopi Keys Deletion Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
wopiKeysDeletion.job.nodeSelector | Wopi Keys Deletion Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
wopiKeysDeletion.job.tolerations | Wopi Keys Deletion Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
wopiKeysDeletion.job.initContainers | Pod içinde Wopi Keys Deletion kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
wopiKeysDeletion.job.image.repository | Wopi Keys Deletion ONLYOFFICE Docs için Job imajı deposu | onlyoffice/docs-utils |
wopiKeysDeletion.job.image.tag | Wopi Keys Deletion ONLYOFFICE Docs için Job imajı etiketi | 9.0.4-1 |
wopiKeysDeletion.job.image.pullPolicy | Wopi Keys Deletion ONLYOFFICE Docs için Job imajı çekme ilkesi | IfNotPresent |
wopiKeysDeletion.job.containerSecurityContext.enabled | Wopi Keys Deletion kapsayıcısı için security context'i etkinleştirir | false |
wopiKeysDeletion.job.resources.requests | job Wopi Keys Deletion kapsayıcısı için istenen kaynaklar | {} |
wopiKeysDeletion.job.resources.limits | job Wopi Keys Deletion kapsayıcısı için kaynak sınırları | {} |
tests.enabled | ONLYOFFICE Docs başlatma testi ve bağlı bağımlılıkların kullanılabilirlik testi için gereken kaynakların oluşturulmasını etkinleştirir. Bu kaynaklar helm test komutu çalıştırıldığında kullanılır | true |
tests.annotations | Test Pod için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir | {} |
tests.customPodAntiAffinity | Test Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar | {} |
tests.podAffinity | Test Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar | {} |
tests.nodeAffinity | Test Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar | {} |
tests.nodeSelector | Test Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir | {} |
tests.tolerations | Test Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir | [] |
tests.initContainers | Pod içinde Test kapsayıcısından önce çalışan kapsayıcıları tanımlar | [] |
tests.image.repository | Test kapsayıcı imajı adı | onlyoffice/docs-utils |
tests.image.tag | Test kapsayıcı imajı etiketi | 9.0.4-1 |
tests.image.pullPolicy | Test kapsayıcı imajı çekme ilkesi | IfNotPresent |
tests.containerSecurityContext.enabled | Test kapsayıcısı için security context'i etkinleştirir | false |
tests.resources.requests | test kapsayıcısı için istenen kaynaklar | {} |
tests.resources.limits | test kapsayıcısı için kaynak sınırları | {} |
-
*Not: İmaj deposunun değerinde çözüm türünü belirten -de öneki belirtilmiştir. Olası seçenekler:
-de. Ticari Developer Edition için-ee. Ticari Enterprise Edition için
Bu parametrenin varsayılan değeri ONLYOFFICE Document Server Developer Edition'a karşılık gelir. Bu sürüm hakkında daha fazla bilgi edinmek ve diğer sürümlerle karşılaştırmak için bu sayfadaki karşılaştırma tablosuna bakın.
5. Yapılandırma ve kurulum ayrıntıları
-
Example dağıtımı (isteğe bağlı)
ÖnemliBu adım isteğe bağlıdır. Example'ı dağıtmanız gerekmiyorsa tamamen atlayabilirsiniz.
Example'ı dağıtmak için
example.enabledparametresini true olarak ayarlayın:$ helm install documentserver onlyoffice/docs --set example.enabled=true -
Metrik dağıtımı (isteğe bağlı)
ÖnemliBu adım isteğe bağlıdır. Metrikleri dağıtmanız gerekmiyorsa tamamen atlayabilirsiniz.
Metrikleri dağıtmak için
metrics.enableddeğerini true olarak ayarlayın:$ helm install documentserver onlyoffice/docs --set metrics.enabled=trueMetrikleri görselleştirmek için Grafana kullanmak istiyorsanız
grafana.enableddeğerinitrueolarak ayarlayın. Grafana'ya erişmek için Nginx Ingress kullanmak istiyorsanızgrafana.ingress.enableddeğerinitrueolarak ayarlayın:$ helm install documentserver onlyoffice/docs --set grafana.enabled=true --set grafana.ingress.enabled=true -
ONLYOFFICE Docs'u dış erişime açma
-
ONLYOFFICE Docs'u Service ile dış erişime açma (yalnızca HTTP)
notONLYOFFICE Docs'u HTTPS üzerinden dış erişime açacaksanız bu adımı atlayın.
Bu erişim türü, ONLYOFFICE Docs'a erişmek için bir yük dengeleyici oluşturur. Harici TLS sonlandırma kullanıyorsanız ve k8s kümesinde başka bir web uygulamanız yoksa bu türü kullanın.
ONLYOFFICE Docs'u service ile dış erişime açmak için
service.typeparametresini LoadBalancer olarak ayarlayın:$ helm install documentserver onlyoffice/docs --set service.type=LoadBalancer,service.port=80documentserverservisinin IP adresini almak için aşağıdaki komutu çalıştırın:$ kubectl get service documentserver -o jsonpath="{.status.loadBalancer.ingress[*].ip}"Bundan sonra ONLYOFFICE Docs
http://DOCUMENTSERVER-SERVICE-IP/adresinden erişilebilir olur.Servis IP adresi boşsa
documentserverservisinin ana bilgisayar adını almayı deneyin:$ kubectl get service documentserver -o jsonpath="{.status.loadBalancer.ingress[*].hostname}"Bu durumda ONLYOFFICE Docs
http://DOCUMENTSERVER-SERVICE-HOSTNAME/adresinden erişilebilir olur. -
ONLYOFFICE Docs'u Ingress ile dış erişime açma
Önce Kubernetes Nginx Ingress Controller'ı kurun:
$ helm install nginx-ingress ingress-nginx/ingress-nginx --set controller.publishService.enabled=true,controller.replicaCount=2notingress-nginx metriklerinin Prometheus'a sunulmasını etkinleştirmek için şunu çalıştırın:
$ helm install nginx-ingress -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/ingress_values.yaml ingress-nginx/ingress-nginxNginx Ingress'i Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
Ardından erişim yönteminizi seçin:
-
HTTP ile
notONLYOFFICE Docs'u HTTPS üzerinden dış erişime açacaksanız bunu atlayın.
$ helm install documentserver onlyoffice/docs --set ingress.enabled=trueIngress IP adresini alın:
$ kubectl get ingress documentserver -o jsonpath="{.status.loadBalancer.ingress[*].ip}"ONLYOFFICE Docs
http://DOCUMENTSERVER-INGRESS-IP/adresinden erişilebilir olur (IP boşsa ana bilgisayar adını kullanın). -
HTTPS ile (TLS sonlandırma)
SSL sertifikanızla
tlssecret'ını oluşturun:$ kubectl create secret generic tls \--from-file=./tls.crt \--from-file=./tls.key$ helm install documentserver onlyoffice/docs --set ingress.enabled=true,ingress.ssl.enabled=true,ingress.host=example.comDNS sağlayıcınız aracılığıyla ingress IP adresini veya ana bilgisayar adını alan adınızla ilişkilendirin. Bundan sonra ONLYOFFICE Docs
https://your-domain-name/adresinden erişilebilir olur. -
Let's Encrypt kullanarak HTTPS ile
$ helm repo add jetstack https://charts.jetstack.io$ helm repo update$ helm install cert-manager --version v1.17.4 jetstack/cert-manager \--namespace cert-manager \--create-namespace \--set crds.enabled=true \--set crds.keep=falseArdından
ingress.enabled,ingress.ssl.enabled,ingress.letsencrypt.enableddeğerlerinitrueolarak ayarlayarak veingress.letsencrypt.emailileingress.host(birden fazla alan adı içiningress.tenants) değerlerini belirterek ONLYOFFICE Docs'u kurun veya güncelleyin. -
Sanal yol ile
ingress.enabled,ingress.hostveingress.pathparametrelerini ayarlayın:$ helm install documentserver onlyoffice/docs --set ingress.enabled=true,ingress.host=your-domain-name,ingress.path=/docsDesteklenen ingress denetleyicileri: Ingress NGINX by Kubernetes, NGINX Ingress by NGINX, HAProxy Ingress by HAProxy.
Ingress NGINX by Kubernetes için
ingress.pathdeğerine(/|$)(.*)desenini ekleyin, örneğin/docs(/|$)(.*).
-
-
ONLYOFFICE Docs'u OpenShift'te route ile dış erişime açma
$ helm install documentserver onlyoffice/docs --set openshift.route.enabled=true,openshift.route.host=your-domain-name,openshift.route.path=/docsTLS sonlandırma için sertifikaları OpenShift web konsolu üzerinden route'a elle ekleyin.
-
6. ONLYOFFICE Docs'u ölçeklendirme
Bu adım isteğe bağlıdır. Varsayılan dağıtım ayarlarını kullanmak istiyorsanız tamamen atlayabilirsiniz.
-
Yatay Pod otomatik ölçekleme (Horizontal Pod Autoscaling)
docserviceveconverterdeployment'larının çoğaltma sayısının metriklerin değerlerine ve türüne göre otomatik olarak hesaplanması için otomatik ölçeklemeyi etkinleştirebilirsiniz.Kaynak metrikleri için
metrics.k8s.ioAPI'sinin kayıtlı olması gerekir; bunu genellikle metrics-server sağlar. Küme eklentisi olarak başlatılabilir.docservicedeployment'ı için HPA'yı etkinleştirmek üzeredocservice.autoscaling.enabled=trueparametresini belirtin. Benzer şekildeconverterdeployment'ı için HPA'yı etkinleştirmek üzereconverter.autoscaling.enabled=truebelirtin. Her iki durumda da ilgilireplicasparametresi yok sayılır ve çoğaltma sayısı HPA tarafından denetlenir.Horizontal Pod Autoscaling hakkında daha fazla bilgi için buraya bakın. Yapılandırılabilen diğer otomatik ölçekleme parametreleri için Parametreler tablosuna bakın.
-
Elle ölçeklendirme
docserviceveconverterdeployment'ları varsayılan olarak ikişer Pod'dan oluşur.docservicedeployment'ını ölçeklendirmek için:$ kubectl scale -n default deployment docservice --replicas=POD_COUNTconverterdeployment'ını ölçeklendirmek için:$ kubectl scale -n default deployment converter --replicas=POD_COUNT
7. ONLYOFFICE Docs'u güncelleme
Güncellemek için yükseltme parametrelerini ayarlayın. Örneğin:
$ helm upgrade documentserver onlyoffice/docs \
--set docservice.image.tag=[version]
Kurulum sırasında belirtilen parametreleri de belirtmeniz gerekir.
Ya da values.yaml dosyasını değiştirin ve şunu çalıştırın:
$ helm upgrade documentserver -f values.yaml onlyoffice/docs
helm upgrade komutu, ONLYOFFICE Docs'u kapatan ve veritabanını temizleyen bir kanca (hook) çalıştırır. Varsayılan kanca çalışma süresi 300 saniyedir. Değiştirmek için:
$ helm upgrade documentserver -f values.yaml onlyoffice/docs --timeout 15m
Bir Web proxy arkasındaki veya internet erişimi olmayan özel bir k8s kümesinde yükseltme yaparken aşağıdaki notlara bakın.
ONLYOFFICE Docs sürümü dışındaki herhangi bir parametreyi güncellemek için helm upgrade komutunu kancalar olmadan çalıştırın:
$ helm upgrade documentserver onlyoffice/docs --set jwt.enabled=false --no-hooks
Güncellemeleri geri almak için:
$ helm rollback documentserver
Özel bir k8s kümesinde geri alma yaparken aşağıdaki notlara bakın.
8. ONLYOFFICE Docs'u kapatma
Bu adım isteğe bağlıdır.
Kapatma işlemini gerçekleştirmek için aşağıdaki komutu çalıştırın:
$ kubectl apply -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/shutdown-ds.yaml -n <NAMESPACE>
Burada <NAMESPACE>, ONLYOFFICE Docs'un kurulu olduğu namespace'tir. Belirtilmezse varsayılan olarak default kullanılır. Örneğin:
$ kubectl apply -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/shutdown-ds.yaml -n onlyoffice
shutdown-ds Pod'u başarıyla çalıştıktan sonra Job'u silin:
$ kubectl delete job shutdown-ds -n <NAMESPACE>
Kapatmadan sonra ONLYOFFICE Docs'u yeniden başlatmak için docservice ve converter Pod'larını yeniden başlatın:
$ kubectl delete pod converter-*** docservice-*** -n <NAMESPACE>
9. ONLYOFFICE Docs lisansını güncelleme
Bu adım isteğe bağlıdır.
v5.1.1 sürümünden itibaren lisansı, Pod'ları yeniden başlatmadan secret'ı yeniden oluşturarak güncelleyebilirsiniz. Lisansı güncellemek için:
-
Yeni
license.licdosyasını bir dizine yerleştirin. -
Aşağıdaki komutları çalıştırın:
$ kubectl delete secret [SECRET_LICENSE_NAME] -n <NAMESPACE>$ kubectl create secret generic [SECRET_LICENSE_NAME] --from-file=path/to/license.lic -n <NAMESPACE>Burada SECRET_LICENSE_NAME, lisansı içeren mevcut secret'ın adıdır.
documentserver yeni lisansı otomatik olarak yeniden okur.
docservice ve converter Pod'larını yeniden başlatın:
$ kubectl delete pod converter-*** docservice-*** -n <NAMESPACE>
10. ONLYOFFICE Docs kurulum testi
Bu adım isteğe bağlıdır.
ONLYOFFICE Docs'un kullanılabilirliğini ve bağlı bağımlılıklara erişimi test edin:
$ helm test documentserver -n <NAMESPACE>
Çıktı şunu içermelidir:
Phase: Succeeded
Test günlüğünü görüntülemek için:
$ kubectl logs -f test-ds -n <NAMESPACE>
Testten sonra test-ds Pod'unu silin:
$ kubectl delete pod test-ds -n <NAMESPACE>
Bu test yalnızca bilgi amaçlıdır ve %100 kullanılabilirliği garanti edemez. Ayrıntılı bilgi için uygulama günlüklerini kontrol edin.
11. Özel bir k8s kümesinde Job'ları çalıştırma
Bu adım isteğe bağlıdır. Kümenizin internet erişimi kısıtlı değilse tamamen atlayabilirsiniz.
Helm chart 6.1.0 sürümünden itibaren veritabanı başlatma için gereken SQL betikleri docs-utils imajına dahil edilmiştir. Bu nedenle Job'ların bunları indirmek için internet erişimine ihtiyacı yoktur.
İnternet erişimi gerektiren özel bir betiği install.existingConfigmap.initdb veya upgrade|rollback|delete.existingConfigmap.dsStop parametresinde belirtilen configmap'e eşlerseniz ve ağınızda bir Web proxy varsa Pod'ların kapsayıcılarının internete erişebilmesi için webProxy.enabled=true ve uygun Web proxy parametrelerini ayarlayın.
12. Bilgi sayfasına erişim
Bu adım isteğe bağlıdır.
/info sayfasına erişim varsayılan olarak kısıtlıdır. Erişime izin vermek için proxy.infoAllowedIP parametresiyle IP adreslerini veya alt ağları belirtin. Kubernetes ağının özellikleri nedeniyle gerçek istemcilerin genellikle asıl kullanıcı IP adresi değil, Pod, Node veya Load Balancer adresleri olduğunu unutmayın.
proxy.infoAllowedUser parametresini ve proxy.infoAllowedPassword ile bir parola ayarlayarak erişimi Nginx Basic Authentication ile daha da kısıtlayabilirsiniz. Alternatif olarak proxy.infoAllowedExistingSecret ayarlayarak mevcut bir secret kullanın.
Metrikleri görselleştirmek için Grafana kullanma
Bu bölüm isteğe bağlıdır. Grafana kurmak istemiyorsanız tamamen atlayabilirsiniz.
1. Grafana'yı dağıtma
6.2. adımın (Prometheus'u kurma) tamamlandığı varsayılır.
-
Grafana'yı hazır panolar olmadan dağıtma
notGrafana'yı hazır panolarla dağıtmak istiyorsanız bu adımı atlayın.
$ helm install grafana --version 12.1.8 bitnami/grafana \--set service.ports.grafana=80 \--set config.useGrafanaIniFile=true \--set config.grafanaIniConfigMap=grafana-ini \--set datasources.secretName=grafana-datasource \--set resourcesPreset=none \--set image.repository=bitnamilegacy/grafana \--set image.tag=12.1.1-debian-12-r1 \--set global.security.allowInsecureImages=true -
Grafana'yı hazır panolarla dağıtma
-
Hazır Grafana panolarını kurma
grafana.enabledvegrafana.dashboard.enabledparametrelerinitrueolarak ayarlayın. ONLYOFFICE Docs zaten kuruluysa şunu çalıştırın:helm upgrade documentserver onlyoffice/docs --set grafana.enabled=true --set grafana.dashboard.enabled=trueBu işlem, hazır panoları JSON biçiminde Grafana web sitesinden indirir, gerekli düzenlemeleri uygular ve bunlardan bir configmap oluşturur. ONLYOFFICE Docs metrikleri için bir pano da eklenir (6. adımın (StatsD exporter'ı dağıtma) tamamlandığı varsayılır).
-
Grafana'yı kurma
$ helm install grafana --version 12.1.8 bitnami/grafana \--set service.ports.grafana=80 \--set config.useGrafanaIniFile=true \--set config.grafanaIniConfigMap=grafana-ini \--set datasources.secretName=grafana-datasource \--set resourcesPreset=none \--set image.repository=bitnamilegacy/grafana \--set image.tag=12.1.1-debian-12-r1 \--set global.security.allowInsecureImages=true \--set dashboardsProvider.enabled=true \--set dashboardsConfigMaps[0].configMapName=dashboard-node-exporter \--set dashboardsConfigMaps[0].fileName=dashboard-node-exporter.json \--set dashboardsConfigMaps[1].configMapName=dashboard-deployment \--set dashboardsConfigMaps[1].fileName=dashboard-deployment.json \--set dashboardsConfigMaps[2].configMapName=dashboard-redis \--set dashboardsConfigMaps[2].fileName=dashboard-redis.json \--set dashboardsConfigMaps[3].configMapName=dashboard-rabbitmq \--set dashboardsConfigMaps[3].fileName=dashboard-rabbitmq.json \--set dashboardsConfigMaps[4].configMapName=dashboard-postgresql \--set dashboardsConfigMaps[4].fileName=dashboard-postgresql.json \--set dashboardsConfigMaps[5].configMapName=dashboard-nginx-ingress \--set dashboardsConfigMaps[5].fileName=dashboard-nginx-ingress.json \--set dashboardsConfigMaps[6].configMapName=dashboard-documentserver \--set dashboardsConfigMaps[6].fileName=dashboard-documentserver.json \--set dashboardsConfigMaps[7].configMapName=dashboard-cluster-resourses \--set dashboardsConfigMaps[7].fileName=dashboard-cluster-resourses.jsonGrafana'ya şu panolar aktarılır: Node Exporter, Deployment Statefulset Daemonset, Redis Dashboard for Prometheus Redis Exporter, RabbitMQ-Overview, PostgreSQL Database, NGINX Ingress controller, ONLYOFFICE Docs ve Resource usage by Pods and Containers.
notGrafana'da görselleştirilen ONLYOFFICE Docs metriklerinin açıklamasını buradan görebilirsiniz.
Grafana'yı Helm ile kurma hakkında daha fazla bilgi için buraya bakın.
-
2. Grafana'ya Ingress ile erişim
Kubernetes Nginx Ingress denetleyicisini kurma adımının tamamlandığı varsayılır.
ONLYOFFICE Docs grafana.ingress.enabled parametresiyle kurulduysa (Metrik dağıtımı) Grafana şu adresten erişilebilir olur: http://INGRESS-ADDRESS/grafana/
Ingress güvenli bağlantıyla kurulduysa (ONLYOFFICE Docs'u HTTPS ile dış erişime açma) Grafana şu adresten erişilebilir olur: https://your-domain-name/grafana/
3. Toplanan metrikleri Grafana'da görüntüleme
http(s)://your-domain-name/grafana/ adresine gidin ve şu bilgilerle oturum açın:
Login - admin
Parolayı almak için şunu çalıştırın:
$ kubectl get secret grafana-admin --namespace default -o jsonpath="{.data.GF_SECURITY_ADMIN_PASSWORD}" | base64 --decode
Pano bölümünde, Prometheus'tan alınan metrikleri gösteren eklenen panoları göreceksiniz.