Ana içeriğe geç

ONLYOFFICE Docs'u Kubernetes'te kurma

Giriş​

Önemli

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:
  • Ayrıca yapılandırılmış yerel bir kubectl kopyanı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 oc hem de kubectl kullanabilirsiniz.
  • '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-admin rolü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​

not

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​

Önemli

Amazon S3'ü önbellek olarak kullanmak istiyorsanız bu adımı atlayın.

NFS Server Provisioner'ı kurma

not

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-hdd veya yc-network-ssd. Daha fazla bilgi
    • minikube: standard
  • 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.

Önemli

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
not

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
not

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'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
not

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.

6. StatsD exporter'ı dağıtma​

Önemli

Bu adım isteğe bağlıdır. StatsD exporter'ı çalıştırmak istemiyorsanız tamamen atlayabilirsiniz.

  1. 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
  2. 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=1m

    Kazıma (scrape) aralığını değiştirmek için server.global.scrape_interval parametresini belirtin.

    Prometheus'u Helm ile kurma hakkında daha fazla bilgi için buraya bakın.

  3. 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=30000ms

    Prometheus 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​

Önemli

Bu adım isteğe bağlıdır. Yapılandırma dosyalarında değişiklik yapmanız gerekmiyorsa tamamen atlayabilirsiniz.

  1. json dosyası içeren bir ConfigMap oluşturma

    local.json yapı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.json
    not

    local-config yerine herhangi bir ad kullanılabilir.

  2. ONLYOFFICE Docs kurulurken parametreleri belirtme

    ONLYOFFICE Docs kurulurken extraConf.configMap=local-config ve extraConf.filename=local.json parametrelerini belirtin.

    not

    ONLYOFFICE 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-hooks

    Parametreler values.yaml dosyasında belirtilmişse şu komutu çalıştırın:

    helm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hooks

8. Özel yazı tipleri ekleme​

Önemli

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​

Önemli

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​

Önemli

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​

Önemli

Bu adım isteğe bağlıdır. Arayüz temalarını değiştirmeniz gerekmiyorsa tamamen atlayabilirsiniz.

  1. 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.json
    not

    custom-themes ve custom-themes.json yerine başka adlar kullanabilirsiniz.

  2. ONLYOFFICE Docs kurulurken parametreleri belirtme

    ONLYOFFICE Docs kurulurken extraThemes.configMap=custom-themes ve extraThemes.filename=custom-themes.json parametrelerini belirtin.

    not

    ONLYOFFICE 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-hooks komutunu çalıştırın. Parametreler values.yaml dosyasında belirtilmişse helm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hooks komutunu çalıştırın.

12. Amazon S3 bucket'ını ONLYOFFICE Helm Docs'a önbellek olarak bağlama​

Önemli

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​

not

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​

  1. Secret oluşturma

    Geçerli bir ONLYOFFICE Docs lisansınız varsa dosyadan license adlı bir secret oluşturun:

    $ kubectl create secret generic [SECRET_LICENSE_NAME] --from-file=path/to/license.lic

    Burada SECRET_LICENSE_NAME, lisansı içerecek secret'ın adıdır.

    not

    Kaynak lisans dosyasının adı 'license.lic' olmalıdır; çünkü bu ad, oluşturulan secret'ta bir alan olarak kullanılır.

    not

    Kurulum, mevcut lisans dosyasıyla bir secret oluşturulmadan yapılırsa boş bir license secret'ı otomatik olarak oluşturulur. Mevcut bir secret'ı lisansla güncelleme hakkında bilgi için buraya bakın.

  2. 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]
    not

    ONLYOFFICE 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-hooks komutunu çalıştırın. Parametreler values.yaml dosyasında belirtilmişse helm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hooks komutunu ç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.

not

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
not

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
not

Varsayılan values.yaml dosyasını kullanabilirsiniz.

Tüm parametreleri göster
ParametreAçıklamaVarsayılan
connections.dbTypeVeritabanı türü. Olası değerler: postgres, mariadb, mysql, oracle, mssql veya damengpostgres
connections.dbHostVeritabanı ana bilgisayarının IP adresi veya adıpostgresql
connections.dbUserVeritabanı kullanıcısıpostgres
connections.dbPortVeritabanı sunucusu bağlantı noktası numarası5432
connections.dbNameUygulamanın bağlanacağı veritabanının adıpostgres
connections.dbPasswordVeritabanı kullanıcısının parolası. Ayarlanırsa connections.dbExistingSecret değerine göre önceliklidir""
connections.dbSecretKeyNameVeritabanı kullanıcısının parolasını içeren anahtarın adıpostgres-password
connections.dbExistingSecretVeritabanı parolaları için kullanılacak mevcut secret'ın adı. connections.dbSecretKeyName içinde belirtilen anahtarı içermelidirpostgresql
connections.redisConnectorNameRedis'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ınredis
connections.redisHostRedis ana bilgisayarının IP adresi veya adı. Değerler connections.redisClusterNodes ve connections.redisSentinelNodes içinde ayarlanmışsa kullanılmazredis-master
connections.redisPortRedis sunucusu bağlantı noktası numarası. Değerler connections.redisClusterNodes ve connections.redisSentinelNodes içinde ayarlanmışsa kullanılmaz6379
connections.redisUserRedis kullanıcı adı. Özel yapılandırma dosyası eklerseniz bu parametredeki değer, local.json içindeki options nesnesinde ayarlanan değerin yerine geçerdefault
connections.redisDBNumSeç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çer0
connections.redisClusterNodesRedis 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.redisPasswordRedis 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.redisSecretKeyNameRedis kullanıcısının parolasını içeren anahtarın adıredis-password
connections.redisExistingSecretRedis 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çerredis
connections.redisNoPassRedis 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ınfalse
connections.redisSentinelNodesRedis 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.redisSentinelGroupNameBir master ve bir veya daha fazla slave'den oluşan Redis örnekleri grubunun adı. connections.redisConnectorName değeri ioredis olarak ayarlanmışsa kullanılırmymaster
connections.redisSentinelExistingSecretRedis 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.redisSentinelSecretKeyNameRedis 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 olursentinel-password
connections.redisSentinelPasswordRedis 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.redisSentinelNoPassRedis 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ıntrue
connections.amqpTypeAMQP sunucusu türünü belirler. Olası değerler: rabbitmq veya activemqrabbitmq
connections.amqpHostAMQP sunucusunun IP adresi veya adırabbitmq
connections.amqpPortAMQP sunucusuna bağlantı için bağlantı noktası5672
connections.amqpVhostAMQP sunucusuna bağlantı için sanal ana bilgisayar (virtual host)/
connections.amqpUserAMQP sunucusu hesabının kullanıcı adıuser
connections.amqpProtoAMQP sunucusuna bağlantı için protokolamqp
connections.amqpPasswordAMQP sunucusu kullanıcısının parolası. Ayarlanırsa connections.amqpExistingSecret değerine göre önceliklidir""
connections.amqpSecretKeyNameAMQP sunucusu kullanıcısının parolasını içeren anahtarın adırabbitmq-password
connections.amqpExistingSecretAMQP sunucusu parolaları için kullanılacak mevcut secret'ın adı. connections.amqpSecretKeyName içinde belirtilen anahtarı içermelidirrabbitmq
persistence.existingClaimKullanı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.storageClassOnlyoffice Docs verileri ve çalışma zamanı yapılandırma birimleri için PVC Storage Classnfs
persistence.sizeONLYOFFICE Docs birimi için PVC Storage Request8Gi
persistence.storageS3S3'ün önbellek deposu olarak kullanılıp kullanılmayacağını belirler. S3'ü önbellek deposu olarak kullanacaksanız true olarak ayarlayınfalse
persistence.runtimeConfig.enabledPVC'nin kullanılıp kullanılmayacağını ve kapsayıcılara bağlanıp bağlanmayacağını belirlertrue
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 Request1Gi
commonNameSuffixOluşturulan tüm kaynakların adına sonek olarak eklenecek ad""
namespaceOverrideOnlyoffice Docs'un dağıtılacağı namespace'in adı. Ayarlanmazsa ad .Release.Namespace değerinden alınır""
commonLabelsDağıtılan tüm kaynaklara ek olarak eklenecek etiketleri tanımlar. Anahtarın değeri olarak tpl de kullanabilirsiniz{}
commonAnnotationsDağı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.createServiceAccount oluşturmayı etkinleştirirfalse
serviceAccount.nameKullanı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.annotationsServiceAccount için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
serviceAccount.automountServiceAccountTokenOluşturulan serviceAccount üzerinde ServiceAccountToken'ın otomatik bağlanmasını etkinleştirir. Yalnızca serviceAccount.create değeri true ise kullanılırtrue
license.existingSecretLisansı içeren mevcut secret'ın adı. license.lic anahtarını içermelidir""
license.existingClaimLisansın depolandığı mevcut PVC'nin adı. license.lic dosyasını içermelidir""
log.levelGünlüğe kaydedilen olayın türünü ve önem derecesini belirler. Olası değerler: ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, MARK, OFFWARN
log.typeGünlüğe kaydedilen olayın biçimini belirler. Olası değerler: pattern, json, basic, coloured, messagePassThrough, dummypattern
log.patternlog.type=pattern ise günlük desenini belirler[%d] [%p] %c - %.10000m
wopi.enabledWOPI'nin etkin olup olmadığını belirler. Parametre etkinse bağlanan dizin (PVC) için önbellekleme öznitelikleri istemcide devre dışı bırakılmalıdırfalse
wopi.keys.generationAPI anahtarlarının oluşturulup oluşturulmayacağını belirler. wopi.enabled değerini true olarak ayarlarsanız kullanılırtrue
wopi.keys.newKeysExistingSecretWOPI 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.oldKeysExistingSecretEski 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.enabledONLYOFFICE Docs için StatsD'nin etkin olup olmadığını belirtirfalse
metrics.hostStatsD dinleme ana bilgisayarını belirlerstatsd-exporter-prometheus-statsd-exporter
metrics.portStatsD dinleme bağlantı noktasını belirler8125
metrics.prefixArka uç hizmetleri için StatsD metrik önekini belirlerds.
extraConf.configMapVarsayı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ırlocal.json
extraThemes.configMapArayü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ırcustom-themes.json
podAntiAffinity.typePod antiaffinity türleri. İzin verilen değerler: soft veya hardsoft
podAntiAffinity.topologyKeyEşleştirilecek düğüm etiketi anahtarıkubernetes.io/hostname
podAntiAffinity.weightDüğüm seçilirken öncelik. 1 ile 100 arasında bir değerdir100
nodeSelectorPod'ların atanması için düğüm etiketleri. Her ONLYOFFICE Docs hizmeti burada belirtilen değerleri kendi değerleriyle geçersiz kılabilir{}
tolerationsPod'ların atanması için toleration'lar. Her ONLYOFFICE Docs hizmeti burada belirtilen değerleri kendi değerleriyle geçersiz kılabilir[]
imagePullSecretsKapsayı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ırfalse
requestFilteringAgent.allowMetaIPAddressMeta adrese bağlanmaya izin verilip verilmediğini belirlerfalse
requestFilteringAgent.allowIPAddressListBağlanmasına izin verilen IP adreslerinin listesini belirler. Bu değerler requestFilteringAgent.denyIPAddressList değerlerine göre önceliklidir[]
requestFilteringAgent.denyIPAddressListBağlanmasına izin verilmeyen IP adreslerinin listesini belirler[]
docservice.annotationsDocservice Deployment için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
docservice.podAnnotationsDocservice deployment Pod'ları için eklenecek annotation eşlemesirollme: "{{ randAlphaNum 5 | quote }}"
docservice.replicasDocservice çoğaltma (replica) sayısı. docservice.autoscaling.enabled parametresi etkinse yok sayılır2
docservice.updateStrategy.typeDocservice deployment güncelleme stratejisi türüRecreate
docservice.customPodAntiAffinityDocservice Pods için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
docservice.podAffinityDocservice Pods için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
docservice.nodeAffinityDocservice Pods için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
docservice.nodeSelectorDocservice Pods atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
docservice.tolerationsDocservice Pods atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
docservice.terminationGracePeriodSecondsDocservice Pod için Terminating durumunda kalacağı düzgün sonlandırma süresi30
docservice.hostAliasesDocservice ve Proxy kapsayıcılarındaki hosts dosyasına ek girdiler ekler[]
docservice.initContainersDocservice 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.repositoryDocservice kapsayıcı imajı deposu*onlyoffice/docs-docservice-de
docservice.image.tagDocservice kapsayıcı imajı etiketi9.0.4-1
docservice.image.pullPolicyDocservice kapsayıcı imajı çekme ilkesiIfNotPresent
docservice.containerSecurityContext.enabledDocservice kapsayıcısı için security context'i etkinleştirirfalse
docservice.lifecycleHooksDocservice 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.requestsDocservice kapsayıcısı için istenen kaynaklar{}
docservice.resources.limitsDocservice kapsayıcısı için kaynak sınırları{}
docservice.extraEnvVarsDocservice kapsayıcısı için ek ortam değişkenleri dizisi[]
docservice.extraVolumesDocservice Pod'u için ek birimler (volumes) dizisi[]
docservice.extraVolumeMountsDocservice kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi[]
docservice.readinessProbe.enabledDocservice kapsayıcısı için readinessProbe'u etkinleştirirtrue
docservice.livenessProbe.enabledDocservice kapsayıcısı için livenessProbe'u etkinleştirirtrue
docservice.startupProbe.enabledDocservice kapsayıcısı için startupProbe'u etkinleştirirtrue
docservice.autoscaling.enabledDocservice deployment için otomatik ölçeklemeyi etkinleştirirfalse
docservice.autoscaling.annotationsDocservice deployment HPA için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
docservice.autoscaling.minReplicasDocservice deployment otomatik ölçeklemesi için en az çoğaltma sayısı2
docservice.autoscaling.maxReplicasDocservice deployment otomatik ölçeklemesi için en çok çoğaltma sayısı4
docservice.autoscaling.targetCPU.enabledDocservice deployment için CPU kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirirtrue
docservice.autoscaling.targetCPU.utilizationPercentageDocservice deployment otomatik ölçeklemesi için hedef CPU yüzdesi70
docservice.autoscaling.targetMemory.enabledDocservice deployment için bellek kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirirfalse
docservice.autoscaling.targetMemory.utilizationPercentageDocservice deployment otomatik ölçeklemesi için hedef bellek yüzdesi70
docservice.autoscaling.customMetricsTypeDocservice deployment için özel, ek veya harici otomatik ölçekleme metrikleri[]
docservice.autoscaling.behaviorscaleDown ve scaleUp alanları için Docservice deployment ölçekleme davranışı ilkelerini yapılandırır{}
proxy.accessLognginx yapılandırmasındaki access_log biçim yönergesini belirleroff
proxy.logFormatGü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.gzipProxiednginx yapılandırmasındaki gzip_proxied yönergesini belirleroff
proxy.clientMaxBodySizenginx yapılandırmasındaki client_max_body_size yönergesini belirler100m
proxy.workerConnectionsnginx yapılandırmasındaki worker_connections yönergesini belirler4096
proxy.secureLinkSecretnginx 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.secureLinkExistingSecretsecure_link için kullanılacak mevcut secret'ın adı. Ayarlanırsa proxy.secureLinkSecret değerine göre önceliklidir""
proxy.infoAllowedIPBilgi sayfasına erişim için IP adreslerini belirler[]
proxy.infoAllowedUserBilgi 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.infoAllowedPasswordBilgi 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.infoAllowedSecretKeyNameBilgi sayfası kimlik doğrulama kullanıcısının parolasını içeren anahtarın adı. proxy.infoAllowedUser ayarlanmışsa kullanılırinfo-auth-password
proxy.infoAllowedExistingSecretBilgi 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.enabledKarşılama sayfasının görüntülenip görüntülenmeyeceğini belirlertrue
proxy.image.repositoryDocservice Proxy kapsayıcı imajı deposu*onlyoffice/docs-proxy-de
proxy.image.tagDocservice Proxy kapsayıcı imajı etiketi9.0.4-1
proxy.image.pullPolicyDocservice Proxy kapsayıcı imajı çekme ilkesiIfNotPresent
proxy.containerSecurityContext.enabledProxy kapsayıcısı için security context'i etkinleştirirfalse
proxy.lifecycleHooksProxy 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.requestsProxy kapsayıcısı için istenen kaynaklar{}
proxy.resources.limitsProxy kapsayıcısı için kaynak sınırları{}
proxy.extraEnvVarsProxy kapsayıcısı için ek ortam değişkenleri dizisi[]
proxy.extraVolumeMountsProxy kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi[]
proxy.readinessProbe.enabledProxy kapsayıcısı için readinessProbe'u etkinleştirirtrue
proxy.livenessProbe.enabledProxy kapsayıcısı için livenessProbe'u etkinleştirirtrue
proxy.startupProbe.enabledProxy kapsayıcısı için startupProbe'u etkinleştirirtrue
converter.annotationsConverter Deployment için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
converter.podAnnotationsConverter deployment Pod'ları için eklenecek annotation eşlemesirollme: "{{ randAlphaNum 5 | quote }}"
converter.replicasConverter çoğaltma (replica) sayısı. converter.autoscaling.enabled parametresi etkinse yok sayılır2
converter.updateStrategy.typeConverter deployment güncelleme stratejisi türüRecreate
converter.customPodAntiAffinityConverter Pods için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
converter.podAffinityConverter Pods için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
converter.nodeAffinityConverter Pods için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
converter.nodeSelectorConverter Pods atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
converter.tolerationsConverter Pods atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
converter.terminationGracePeriodSecondsConverter Pod için Terminating durumunda kalacağı düzgün sonlandırma süresi30
converter.hostAliasesConverter kapsayıcısındaki hosts dosyasına ek girdiler ekler[]
converter.initContainersConverter 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.repositoryConverter kapsayıcı imajı deposu*onlyoffice/docs-converter-de
converter.image.tagConverter kapsayıcı imajı etiketi9.0.4-1
converter.image.pullPolicyConverter kapsayıcı imajı çekme ilkesiIfNotPresent
converter.containerSecurityContext.enabledConverter kapsayıcısı için security context'i etkinleştirirfalse
converter.lifecycleHooksConverter 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.requestsConverter kapsayıcısı için istenen kaynaklar{}
converter.resources.limitsConverter kapsayıcısı için kaynak sınırları{}
converter.extraEnvVarsConverter kapsayıcısı için ek ortam değişkenleri dizisi[]
converter.extraVolumesConverter Pod'u için ek birimler (volumes) dizisi[]
converter.extraVolumeMountsConverter kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi[]
converter.autoscaling.enabledConverter deployment için otomatik ölçeklemeyi etkinleştirirfalse
converter.autoscaling.annotationsConverter deployment HPA için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
converter.autoscaling.minReplicasConverter deployment otomatik ölçeklemesi için en az çoğaltma sayısı2
converter.autoscaling.maxReplicasConverter deployment otomatik ölçeklemesi için en çok çoğaltma sayısı16
converter.autoscaling.targetCPU.enabledconverter deployment için CPU kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirirtrue
converter.autoscaling.targetCPU.utilizationPercentageConverter deployment otomatik ölçeklemesi için hedef CPU yüzdesi70
converter.autoscaling.targetMemory.enabledConverter deployment için bellek kullanım yüzdesine göre otomatik ölçeklemeyi etkinleştirirfalse
converter.autoscaling.targetMemory.utilizationPercentageConverter deployment otomatik ölçeklemesi için hedef bellek yüzdesi70
converter.autoscaling.customMetricsTypeConverter deployment için özel, ek veya harici otomatik ölçekleme metrikleri[]
converter.autoscaling.behaviorscaleDown ve scaleUp alanları için Converter deployment ölçekleme davranışı ilkelerini yapılandırır{}
example.enabledExample'ın kurulumunu etkinleştirirfalse
example.annotationsExample StatefulSet için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
example.podAnnotationsExample Pod için eklenecek annotation eşlemesirollme: "{{ randAlphaNum 5 | quote }}"
example.updateStrategy.typeExample StatefulSet güncelleme stratejisi türüRollingUpdate
example.customPodAntiAffinityExample Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
example.podAffinityExample Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
example.nodeAffinityExample Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
example.nodeSelectorExample Pods atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
example.tolerationsExample Pods atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
example.terminationGracePeriodSecondsExample Pod için Terminating durumunda kalacağı düzgün sonlandırma süresi30
example.hostAliasesExample kapsayıcısındaki hosts dosyasına ek girdiler ekler[]
example.initContainersPod içinde Example kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
example.image.repositoryExample kapsayıcı imajı adıonlyoffice/docs-example
example.image.tagExample kapsayıcı imajı etiketi9.0.4-1
example.image.pullPolicyExample kapsayıcı imajı çekme ilkesiIfNotPresent
example.containerSecurityContext.enabledExample kapsayıcısı için security context'i etkinleştirirfalse
example.dsUrlONLYOFFICE 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.requestsExample kapsayıcısı için istenen kaynaklar{}
example.resources.limitsExample kapsayıcısı için kaynak sınırları{}
example.extraEnvVarsExample kapsayıcısı için ek ortam değişkenleri dizisi[]
example.extraConf.configMapVarsayı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ırlocal.json
example.extraVolumesExample Pod'u için ek birimler (volumes) dizisi[]
example.extraVolumeMountsExample kapsayıcısı için ek birim bağlama noktaları (volume mounts) dizisi[]
jwt.enabledONLYOFFICE 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ırtrue
jwt.secretONLYOFFICE 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.headerJSON Web Token'ı göndermek için kullanılacak http başlığını belirler. Gelen (inbox) ve giden (outbox) istekler için ortaktırAuthorization
jwt.inBodyONLYOFFICE Docs'a gönderilen isteğin gövdesinde belirteç doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirtirfalse
jwt.inboxYalnızca gelen (inbox) istekler için JSON Web Token doğrulama parametreleri. Belirtilmezse ortak jwt parametrelerinin değerleri kullanılır{}
jwt.outboxYalnızca giden (outbox) istekler için JSON Web Token doğrulama parametreleri. Belirtilmezse ortak jwt parametrelerinin değerleri kullanılır{}
jwt.existingSecretjwt değişkenlerini içeren mevcut secret'ın adı. Belirtilmezse jwt adlı bir secret oluşturulur""
service.existingONLYOFFICE Docs için mevcut bir servisin adı. Belirtilmezse documentserver adlı bir servis oluşturulur""
service.annotationsONLYOFFICE Docs service için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
service.typeONLYOFFICE Docs servis türüClusterIP
service.portONLYOFFICE Docs servis bağlantı noktası8888
service.sessionAffinityONLYOFFICE Docs servisi için Session Affinity. Ayarlanmazsa varsayılan değer olarak None kullanılır""
service.sessionAffinityConfigONLYOFFICE Docs servisi Session Affinity için yapılandırma. service.sessionAffinity ayarlanmışsa kullanılır{}
ingress.enabledONLYOFFICE Docs için ingress oluşturmayı etkinleştirirfalse
ingress.annotationsIngress için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidirnginx.ingress.kubernetes.io/proxy-body-size: 100m
ingress.ingressClassNameBu Ingress'i uygulamak için kullanılacak IngressClass'a başvurmak için kullanılırnginx
ingress.controllerNameAynı IngressClassName değerine sahip ancak farklı sağlayıcılardan gelen denetleyicileri ayırt etmek için kullanılıringress-nginx
ingress.hostONLYOFFICE Docs ingress için Ingress ana bilgisayar adı""
ingress.tenantsBirden 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.enabledONLYOFFICE Docs ingress için ssl'yi etkinleştirirfalse
ingress.ssl.secretIngress'e bağlanacak ssl için secret adıtls
ingress.pathONLYOFFICE Docs'a erişilecek yolu belirtir/
ingress.pathTypeONLYOFFICE Docs ingress kaynağı için yol türünü belirtir. İzin verilen değerler: Exact, Prefix veya ImplementationSpecificImplementationSpecific
ingress.letsencrypt.enabledLet's Encrypt'te sertifika isteği oluşturmayı etkinleştirir. ingress.enabled değeri true ise kullanılırfalse
ingress.letsencrypt.clusterIssuerNameClusterIssuer adıletsencrypt-prod
ingress.letsencrypt.emailACME kaydı için kullanılan e-posta adresiniz""
ingress.letsencrypt.serverSertifika isteklerinin gönderileceği Let's Encrypt sunucusunun adresihttps://acme-v02.api.letsencrypt.org/directory
ingress.letsencrypt.secretNameACME hesabının özel anahtarını depolamak için kullanılan secret'ın adıletsencrypt-prod-private-key
openshift.route.enabledONLYOFFICE Docs için OpenShift Route oluşturmayı etkinleştirirfalse
openshift.route.annotationsOpenShift Route için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
openshift.route.hostONLYOFFICE Docs route için OpenShift Route ana bilgisayar adı""
openshift.route.pathONLYOFFICE Docs'a erişilecek yolu belirtir/
openshift.route.wildcardPolicyOpenShift Route'ta joker karakterli alt alan adlarının işlenme ilkesi. İzin verilen değerler: None, SubdomainNone
grafana.enabledGrafana'da metriklerin görselleştirilmesi için gereken kaynakların kurulumunu etkinleştirirfalse
grafana.namespaceRBAC 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.enabledGrafana 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ırfalse
grafana.ingress.annotationsGrafana Ingress için eklenecek annotation eşlemesi. Ayarlanırsa commonAnnotations değerine göre önceliklidirnginx.ingress.kubernetes.io/proxy-body-size: 100m
grafana.dashboard.enabledHazır Grafana panolarının kurulumunu etkinleştirir. grafana.enabled değerini true olarak ayarlarsanız kullanılırfalse
podSecurityContext.enabledPod'lar için security context'i etkinleştirirfalse
podSecurityContext.converter.fsGroupConverter Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler101
podSecurityContext.docservice.fsGroupDocservice Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler101
podSecurityContext.jobs.fsGroupJob'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 belirler101
podSecurityContext.example.fsGroupExample Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler1001
podSecurityContext.tests.fsGroupTest Pod'una bağlandığında birimlerdeki tüm dosyaların sahibinin ve izinlerinin değiştirileceği Group ID'yi belirler101
webProxy.enabledAğınızda k8s kümesinin Pod'larının İnternet'e erişmesi için bir Web proxy kullanılıp kullanılmadığını belirtirfalse
webProxy.httpHTTP trafiği için Web Proxy adresihttp://proxy.example.com
webProxy.httpsHTTPS trafiği için Web Proxy adresihttps://proxy.example.com
webProxy.noProxyWeb Proxy kullanmaması gereken IP adresleri, k8s servis adları veya alan adları için desenlerlocalhost,127.0.0.1,docservice
upgrade.job.enabledONLYOFFICE Docs güncellenmeden önce pre-upgrade job'unun çalıştırılmasını etkinleştirirtrue
upgrade.job.annotationspre-upgrade Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
upgrade.job.podAnnotationspre-upgrade Pod için eklenecek annotation eşlemesi{}
upgrade.job.customPodAntiAffinitypre-upgrade Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
upgrade.job.podAffinitypre-upgrade Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
upgrade.job.nodeAffinitypre-upgrade Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
upgrade.job.nodeSelectorpre-upgrade Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
upgrade.job.tolerationspre-upgrade Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
upgrade.job.initContainersPod içinde pre-upgrade kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
upgrade.job.image.repositoryupgrade için Job imajı deposuonlyoffice/docs-utils
upgrade.job.image.tagupgrade için Job imajı etiketi9.0.4-1
upgrade.job.image.pullPolicyupgrade için Job imajı çekme ilkesiIfNotPresent
upgrade.job.containerSecurityContext.enabledpre-upgrade kapsayıcısı için security context'i etkinleştirirfalse
upgrade.job.resources.requestsjob pre-upgrade kapsayıcısı için istenen kaynaklar{}
upgrade.job.resources.limitsjob pre-upgrade kapsayıcısı için kaynak sınırları{}
upgrade.existingConfigmap.tblRemove.nameVeritabanındaki tabloları silmeye yönelik sql dosyasını içeren mevcut ConfigMap'in adıremove-db-scripts
upgrade.existingConfigmap.tblRemove.keyNameVeritabanındaki tabloları silme yönergelerini içeren sql dosyasının adı. upgrade.existingConfigmap.tblRemove.name içindeki key adıyla aynı olmalıdırremovetbl.sql
upgrade.existingConfigmap.tblCreate.nameVeritabanında tabloları oluşturmaya yönelik sql dosyasını içeren mevcut ConfigMap'in adıinit-db-scripts
upgrade.existingConfigmap.tblCreate.keyNameVeritabanı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ırcreatedb.sql
upgrade.existingConfigmap.dsStopONLYOFFICE 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.enabledONLYOFFICE Docs geri alınmadan önce pre-rollback job'unun çalıştırılmasını etkinleştirirtrue
rollback.job.annotationspre-rollback Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
rollback.job.podAnnotationspre-rollback Pod için eklenecek annotation eşlemesi{}
rollback.job.customPodAntiAffinitypre-rollback Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
rollback.job.podAffinitypre-rollback Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
rollback.job.nodeAffinitypre-rollback Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
rollback.job.nodeSelectorpre-rollback Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
rollback.job.tolerationspre-rollback Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
rollback.job.initContainersPod içinde pre-rollback kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
rollback.job.image.repositoryrollback için Job imajı deposuonlyoffice/docs-utils
rollback.job.image.tagrollback için Job imajı etiketi9.0.4-1
rollback.job.image.pullPolicyrollback için Job imajı çekme ilkesiIfNotPresent
rollback.job.containerSecurityContext.enabledpre-rollback kapsayıcısı için security context'i etkinleştirirfalse
rollback.job.resources.requestsjob rollback kapsayıcısı için istenen kaynaklar{}
rollback.job.resources.limitsjob rollback kapsayıcısı için kaynak sınırları{}
rollback.existingConfigmap.tblRemove.nameVeritabanındaki tabloları silmeye yönelik sql dosyasını içeren mevcut ConfigMap'in adıremove-db-scripts
rollback.existingConfigmap.tblRemove.keyNameVeritabanındaki tabloları silme yönergelerini içeren sql dosyasının adı. rollback.existingConfigmap.tblRemove.name içindeki key adıyla aynı olmalıdırremovetbl.sql
rollback.existingConfigmap.tblCreate.nameVeritabanında tabloları oluşturmaya yönelik sql dosyasını içeren mevcut ConfigMap'in adıinit-db-scripts
rollback.existingConfigmap.tblCreate.keyNameVeritabanı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ırcreatedb.sql
rollback.existingConfigmap.dsStopONLYOFFICE 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.enabledONLYOFFICE Docs silinmeden önce pre-delete job'unun çalıştırılmasını etkinleştirirtrue
delete.job.annotationspre-delete Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
delete.job.podAnnotationspre-delete Pod için eklenecek annotation eşlemesi{}
delete.job.customPodAntiAffinitypre-delete Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
delete.job.podAffinitypre-delete Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
delete.job.nodeAffinitypre-delete Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
delete.job.nodeSelectorpre-delete Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
delete.job.tolerationspre-delete Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
delete.job.initContainersPod içinde pre-delete kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
delete.job.image.repositorydelete için Job imajı deposuonlyoffice/docs-utils
delete.job.image.tagdelete için Job imajı etiketi9.0.4-1
delete.job.image.pullPolicydelete için Job imajı çekme ilkesiIfNotPresent
delete.job.containerSecurityContext.enabledpre-delete kapsayıcısı için security context'i etkinleştirirfalse
delete.job.resources.requestsjob delete kapsayıcısı için istenen kaynaklar{}
delete.job.resources.limitsjob delete kapsayıcısı için kaynak sınırları{}
delete.existingConfigmap.tblRemove.nameVeritabanındaki tabloları silmeye yönelik sql dosyasını içeren mevcut ConfigMap'in adıremove-db-scripts
delete.existingConfigmap.tblRemove.keyNameVeritabanındaki tabloları silme yönergelerini içeren sql dosyasının adı. delete.existingConfigmap.tblRemove.name içindeki key adıyla aynı olmalıdırremovetbl.sql
delete.existingConfigmap.dsStopONLYOFFICE 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.enabledONLYOFFICE Docs kurulmadan önce pre-install job'unun çalıştırılmasını etkinleştirirtrue
install.job.annotationspre-install Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
install.job.podAnnotationspre-install Pod için eklenecek annotation eşlemesi{}
install.job.customPodAntiAffinitypre-install Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
install.job.podAffinitypre-install Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
install.job.nodeAffinitypre-install Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
install.job.nodeSelectorpre-install Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
install.job.tolerationspre-install Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
install.job.initContainersPod içinde pre-install kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
install.job.image.repositorypre-install ONLYOFFICE Docs için Job imajı deposuonlyoffice/docs-utils
install.job.image.tagpre-install ONLYOFFICE Docs için Job imajı etiketi9.0.4-1
install.job.image.pullPolicypre-install ONLYOFFICE Docs için Job imajı çekme ilkesiIfNotPresent
install.job.containerSecurityContext.enabledpre-install kapsayıcısı için security context'i etkinleştirirfalse
install.job.resources.requestsjob pre-install kapsayıcısı için istenen kaynaklar{}
install.job.resources.limitsjob pre-install kapsayıcısı için kaynak sınırları{}
install.existingConfigmap.tblCreate.nameVeritabanında tabloları oluşturmaya yönelik sql dosyasını içeren mevcut ConfigMap'in adıinit-db-scripts
install.existingConfigmap.tblCreate.keyNameVeritabanı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ırcreatedb.sql
install.existingConfigmap.initdbinitdb 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.enabledONLYOFFICE 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 temizlertrue
clearCache.job.annotationsClear Cache Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
clearCache.job.podAnnotationsClear Cache Pod için eklenecek annotation eşlemesi{}
clearCache.job.customPodAntiAffinityClear Cache Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
clearCache.job.podAffinityClear Cache Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
clearCache.job.nodeAffinityClear Cache Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
clearCache.job.nodeSelectorClear Cache Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
clearCache.job.tolerationsClear Cache Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
clearCache.job.initContainersPod içinde Clear Cache kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
clearCache.job.image.repositoryClear Cache ONLYOFFICE Docs için Job imajı deposuonlyoffice/docs-utils
clearCache.job.image.tagClear Cache ONLYOFFICE Docs için Job imajı etiketi9.0.4-1
clearCache.job.image.pullPolicyClear Cache ONLYOFFICE Docs için Job imajı çekme ilkesiIfNotPresent
clearCache.job.containerSecurityContext.enabledClear Cache kapsayıcısı için security context'i etkinleştirirfalse
clearCache.job.resources.requestsjob Clear Cache kapsayıcısı için istenen kaynaklar{}
clearCache.job.resources.limitsjob Clear Cache kapsayıcısı için kaynak sınırları{}
clearCache.existingConfigmap.nameCache dizinini temizleyen özel betiği içeren mevcut ConfigMap'in adı. Ayarlanırsa varsayılan configmap oluşturulmaz""
clearCache.existingConfigmap.keyNameCache 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ırclearCache.sh
grafanaDashboard.job.annotationsGrafana Dashboard Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
grafanaDashboard.job.podAnnotationsGrafana Dashboard Pod için eklenecek annotation eşlemesi{}
grafanaDashboard.job.customPodAntiAffinityGrafana Dashboard Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
grafanaDashboard.job.podAffinityGrafana Dashboard Job Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
grafanaDashboard.job.nodeAffinityGrafana Dashboard Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
grafanaDashboard.job.nodeSelectorGrafana Dashboard Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
grafanaDashboard.job.tolerationsGrafana Dashboard Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
grafanaDashboard.job.initContainersPod içinde Grafana Dashboard kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
grafanaDashboard.job.image.repositoryGrafana Dashboard ONLYOFFICE Docs için Job imajı deposuonlyoffice/docs-utils
grafanaDashboard.job.image.tagGrafana Dashboard ONLYOFFICE Docs için Job imajı etiketi9.0.4-1
grafanaDashboard.job.image.pullPolicyGrafana Dashboard ONLYOFFICE Docs için Job imajı çekme ilkesiIfNotPresent
grafanaDashboard.job.containerSecurityContext.enabledGrafana Dashboard kapsayıcısı için security context'i etkinleştirirfalse
grafanaDashboard.job.resources.requestsjob Grafana Dashboard kapsayıcısı için istenen kaynaklar{}
grafanaDashboard.job.resources.limitsjob Grafana Dashboard kapsayıcısı için kaynak sınırları{}
wopiKeysGeneration.job.annotationsWopi Keys Generation Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
wopiKeysGeneration.job.podAnnotationsWopi Keys Generation Pod için eklenecek annotation eşlemesi{}
wopiKeysGeneration.job.customPodAntiAffinityWopi Keys Generation Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
wopiKeysGeneration.job.podAffinityWopi 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.nodeAffinityWopi Keys Generation Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
wopiKeysGeneration.job.nodeSelectorWopi Keys Generation Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
wopiKeysGeneration.job.tolerationsWopi Keys Generation Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
wopiKeysGeneration.job.initContainersPod içinde Wopi Keys Generation kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
wopiKeysGeneration.job.image.repositoryWopi Keys Generation ONLYOFFICE Docs için Job imajı deposuonlyoffice/docs-utils
wopiKeysGeneration.job.image.tagWopi Keys Generation ONLYOFFICE Docs için Job imajı etiketi9.0.4-1
wopiKeysGeneration.job.image.pullPolicyWopi Keys Generation ONLYOFFICE Docs için Job imajı çekme ilkesiIfNotPresent
wopiKeysGeneration.job.containerSecurityContext.enabledWopi Keys Generation kapsayıcısı için security context'i etkinleştirirfalse
wopiKeysGeneration.job.resources.requestsjob Wopi Keys Generation kapsayıcısı için istenen kaynaklar{}
wopiKeysGeneration.job.resources.limitsjob Wopi Keys Generation kapsayıcısı için kaynak sınırları{}
wopiKeysDeletion.job.enabledONLYOFFICE 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ırtrue
wopiKeysDeletion.job.annotationsWopi Keys Deletion Job için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
wopiKeysDeletion.job.podAnnotationsWopi Keys Deletion Pod için eklenecek annotation eşlemesi{}
wopiKeysDeletion.job.customPodAntiAffinityWopi Keys Deletion Job Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
wopiKeysDeletion.job.podAffinityWopi 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.nodeAffinityWopi Keys Deletion Job Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
wopiKeysDeletion.job.nodeSelectorWopi Keys Deletion Job Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
wopiKeysDeletion.job.tolerationsWopi Keys Deletion Job Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
wopiKeysDeletion.job.initContainersPod içinde Wopi Keys Deletion kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
wopiKeysDeletion.job.image.repositoryWopi Keys Deletion ONLYOFFICE Docs için Job imajı deposuonlyoffice/docs-utils
wopiKeysDeletion.job.image.tagWopi Keys Deletion ONLYOFFICE Docs için Job imajı etiketi9.0.4-1
wopiKeysDeletion.job.image.pullPolicyWopi Keys Deletion ONLYOFFICE Docs için Job imajı çekme ilkesiIfNotPresent
wopiKeysDeletion.job.containerSecurityContext.enabledWopi Keys Deletion kapsayıcısı için security context'i etkinleştirirfalse
wopiKeysDeletion.job.resources.requestsjob Wopi Keys Deletion kapsayıcısı için istenen kaynaklar{}
wopiKeysDeletion.job.resources.limitsjob Wopi Keys Deletion kapsayıcısı için kaynak sınırları{}
tests.enabledONLYOFFICE 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ırtrue
tests.annotationsTest Pod için ek olarak eklenecek annotation'ları tanımlar. Ayarlanırsa commonAnnotations değerine göre önceliklidir{}
tests.customPodAntiAffinityTest Pod için, belirtilen etiketleri içeren diğer Pod'larla aynı düğümde zamanlanmasını yasaklar{}
tests.podAffinityTest Pod için düğümlere göre zamanlamada diğer Pod'lara bağlı Pod affinity kurallarını tanımlar{}
tests.nodeAffinityTest Pod için düğümlere göre zamanlamada Node affinity kurallarını tanımlar{}
tests.nodeSelectorTest Pod atamasına yönelik düğüm etiketleri. Ayarlanırsa nodeSelector değerine göre önceliklidir{}
tests.tolerationsTest Pod atamasına yönelik toleration'lar. Ayarlanırsa tolerations değerine göre önceliklidir[]
tests.initContainersPod içinde Test kapsayıcısından önce çalışan kapsayıcıları tanımlar[]
tests.image.repositoryTest kapsayıcı imajı adıonlyoffice/docs-utils
tests.image.tagTest kapsayıcı imajı etiketi9.0.4-1
tests.image.pullPolicyTest kapsayıcı imajı çekme ilkesiIfNotPresent
tests.containerSecurityContext.enabledTest kapsayıcısı için security context'i etkinleştirirfalse
tests.resources.requeststest kapsayıcısı için istenen kaynaklar{}
tests.resources.limitstest 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ı​

  1. Example dağıtımı (isteğe bağlı)

    Önemli

    Bu adım isteğe bağlıdır. Example'ı dağıtmanız gerekmiyorsa tamamen atlayabilirsiniz.

    Example'ı dağıtmak için example.enabled parametresini true olarak ayarlayın:

    $ helm install documentserver onlyoffice/docs --set example.enabled=true
  2. Metrik dağıtımı (isteğe bağlı)

    Önemli

    Bu adım isteğe bağlıdır. Metrikleri dağıtmanız gerekmiyorsa tamamen atlayabilirsiniz.

    Metrikleri dağıtmak için metrics.enabled değerini true olarak ayarlayın:

    $ helm install documentserver onlyoffice/docs --set metrics.enabled=true

    Metrikleri görselleştirmek için Grafana kullanmak istiyorsanız grafana.enabled değerini true olarak ayarlayın. Grafana'ya erişmek için Nginx Ingress kullanmak istiyorsanız grafana.ingress.enabled değerini true olarak ayarlayın:

    $ helm install documentserver onlyoffice/docs --set grafana.enabled=true --set grafana.ingress.enabled=true
  3. ONLYOFFICE Docs'u dış erişime açma

    1. ONLYOFFICE Docs'u Service ile dış erişime açma (yalnızca HTTP)

      not

      ONLYOFFICE 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.type parametresini LoadBalancer olarak ayarlayın:

      $ helm install documentserver onlyoffice/docs --set service.type=LoadBalancer,service.port=80

      documentserver servisinin 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 documentserver servisinin 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.

    2. 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=2
      not

      ingress-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-nginx

      Nginx 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

        not

        ONLYOFFICE Docs'u HTTPS üzerinden dış erişime açacaksanız bunu atlayın.

        $ helm install documentserver onlyoffice/docs --set ingress.enabled=true

        Ingress 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 tls secret'ı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.com

        DNS 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=false

        Ardından ingress.enabled, ingress.ssl.enabled, ingress.letsencrypt.enabled değerlerini true olarak ayarlayarak ve ingress.letsencrypt.email ile ingress.host (birden fazla alan adı için ingress.tenants) değerlerini belirterek ONLYOFFICE Docs'u kurun veya güncelleyin.

      • Sanal yol ile

        ingress.enabled, ingress.host ve ingress.path parametrelerini ayarlayın:

        $ helm install documentserver onlyoffice/docs --set ingress.enabled=true,ingress.host=your-domain-name,ingress.path=/docs

        Desteklenen ingress denetleyicileri: Ingress NGINX by Kubernetes, NGINX Ingress by NGINX, HAProxy Ingress by HAProxy.

        Ingress NGINX by Kubernetes için ingress.path değerine (/|$)(.*) desenini ekleyin, örneğin /docs(/|$)(.*).

    3. 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=/docs

      TLS sonlandırma için sertifikaları OpenShift web konsolu üzerinden route'a elle ekleyin.

6. ONLYOFFICE Docs'u ölçeklendirme​

Önemli

Bu adım isteğe bağlıdır. Varsayılan dağıtım ayarlarını kullanmak istiyorsanız tamamen atlayabilirsiniz.

  1. Yatay Pod otomatik ölçekleme (Horizontal Pod Autoscaling)

    docservice ve converter deployment'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.io API'sinin kayıtlı olması gerekir; bunu genellikle metrics-server sağlar. Küme eklentisi olarak başlatılabilir.

    docservice deployment'ı için HPA'yı etkinleştirmek üzere docservice.autoscaling.enabled=true parametresini belirtin. Benzer şekilde converter deployment'ı için HPA'yı etkinleştirmek üzere converter.autoscaling.enabled=true belirtin. Her iki durumda da ilgili replicas parametresi 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.

  2. Elle ölçeklendirme

    docservice ve converter deployment'ları varsayılan olarak ikişer Pod'dan oluşur.

    docservice deployment'ını ölçeklendirmek için:

    $ kubectl scale -n default deployment docservice --replicas=POD_COUNT

    converter deployment'ı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]
not

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
not

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
not

Özel bir k8s kümesinde geri alma yaparken aşağıdaki notlara bakın.

8. ONLYOFFICE Docs'u kapatma​

Önemli

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​

Önemli

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.lic dosyası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.

DEPRECATED METHOD

docservice ve converter Pod'larını yeniden başlatın:

$ kubectl delete pod converter-*** docservice-*** -n <NAMESPACE>

10. ONLYOFFICE Docs kurulum testi​

Önemli

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>
not

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​

Önemli

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.

not

İ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​

Önemli

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​

Önemli

Bu bölüm isteğe bağlıdır. Grafana kurmak istemiyorsanız tamamen atlayabilirsiniz.

1. Grafana'yı dağıtma​

not

6.2. adımın (Prometheus'u kurma) tamamlandığı varsayılır.

  1. Grafana'yı hazır panolar olmadan dağıtma

    not

    Grafana'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
  2. Grafana'yı hazır panolarla dağıtma

    1. Hazır Grafana panolarını kurma

      grafana.enabled ve grafana.dashboard.enabled parametrelerini true olarak ayarlayın. ONLYOFFICE Docs zaten kuruluysa şunu çalıştırın:

      helm upgrade documentserver onlyoffice/docs --set grafana.enabled=true --set grafana.dashboard.enabled=true

      Bu 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).

    2. 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.json

      Grafana'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.

      not

      Grafana'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​

not

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.