ONLYOFFICE Docs za Kubernetes

1. Dodajte Helm repozitorijume

$ 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. Instalirajte trajnu memoriju

Instalirajte NFS Server Provisioner

$ 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 je klasa trajne memorije dostupna u vašem Kubernetes klasteru.

  Klase trajne memorije za različite provajdere:

  • Amazon EKS: gp2
  • Digital Ocean: do-block-storage
  • IBM Cloud: Podrazumevano ibmc-file-bronze. Više klasa memorije
  • Yandex Cloud: yc-network-hdd ili yc-network-ssd. Više detalja
  • minikube: standard
• PERSISTENT_SIZE je ukupna veličina svih trajnih memorija za nfs klasu trajne memorije. Veličinu možete izraziti kao običan ceo broj sa jednim od ovih sufiksa: T, G, M, Ti, Gi, Mi. Na primer: 9Gi.

Više detalja o instalaciji NFS Server Provisioner-a putem Helm-a pogledajte ovde.

Konfigurišite trajni zahtev za memorijom

Podrazumevani nfs trajni zahtev za memorijom je 8Gi. Možete ga promeniti u values.yaml datoteci u sekciji persistence.storageClass i persistence.size. Trebalo bi da bude manji od PERSISTENT_SIZE za najmanje oko 5%. Preporučuje se korišćenje 8Gi ili više za trajnu memoriju za svakih 100 aktivnih korisnika ONLYOFFICE Docs.

Ako želite da omogućite WOPI, molimo postavite parametar wopi.enabled=true. U tom slučaju, trajna memorija mora biti povezana sa čvorovima klastera sa onemogućenim keš atributima za montirani direktorijum za klijente. Za NFS Server Provisioner to se može postići dodavanjem opcije noac parametru storageClass.mountOptions. Više informacija potražite ovde.

3. Implementirajte RabbitMQ

Da biste instalirali RabbitMQ u vaš klaster, pokrenite sledeću komandu:

$ 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

Više detalja o instalaciji RabbitMQ putem Helm-a pogledajte ovde.

4. Implementirajte Redis

Da biste instalirali Redis u vaš klaster, pokrenite sledeću komandu:

$ 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

Više detalja o instalaciji Redis-a putem Helm-a pogledajte ovde.

5. Implementirajte bazu podataka

Kao server baze podataka, možete koristiti PostgreSQL, MySQL ili MariaDB.

$ 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

$ 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

6. Postavljanje StatsD izvoznika

1. Dodajte Helm repozitorijume

   $ 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. Instaliranje Prometheus-a

   Da biste instalirali Prometheus na vaš klaster, pokrenite sledeću komandu:

   $ helm install prometheus -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/extraScrapeConfigs.yaml prometheus-community/prometheus \
     --set server.global.scrape_interval=1m

   Da biste promenili interval prikupljanja, navedite parametar server.global.scrape_interval.

   Više detalja o instaliranju Prometheus-a putem Helm-a pogledajte ovde.

3. Instaliranje StatsD izvoznika

   Da biste instalirali StatsD izvoznika na vaš klaster, pokrenite sledeću komandu:

   $ helm install statsd-exporter prometheus-community/prometheus-statsd-exporter \
     --set statsd.udpPort=8125 \
     --set statsd.tcpPort=8126 \
     --set statsd.eventFlushInterval=30000ms

   Više detalja o instaliranju Prometheus StatsD izvoznika putem Helm-a pogledajte ovde.

   Da biste omogućili StatsD metrike u ONLYOFFICE Docs, pratite ovaj korak.

7. Izmenite Node-config konfiguracione fajlove

1. Kreirajte ConfigMap koji sadrži json fajl

   Da biste kreirali ConfigMap iz fajla koji sadrži strukturu local.json, potrebno je da pokrenete sledeću komandu:

   $ kubectl create configmap local-config \
     --from-file=./local.json

   Umesto local-config može se koristiti bilo koje drugo ime.
2. Odredite parametre prilikom instalacije ONLYOFFICE Docs

   Prilikom instalacije ONLYOFFICE Docs, navedite parametre extraConf.configMap=local-config i extraConf.filename=local.json.

   Ako je potrebno dodati konfiguracioni fajl nakon što je ONLYOFFICE Docs već instaliran, potrebno je izvršiti korak 7.1 i zatim pokrenuti

   helm upgrade documentserver onlyoffice/docs --set extraConf.configMap=local-config --set extraConf.filename=local.json --no-hooks

   komandu ili

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

   ako su parametri navedeni u fajlu values.yaml.

8. Dodajte prilagođene fontove

Da biste dodali fontove u slike, potrebno je da ponovo izgradite slike. Pogledajte relevantne korake u ovom priručniku. Zatim navedite vaše slike prilikom instalacije ONLYOFFICE Docs.

9. Dodajte dodatke

Da biste dodali dodatke u slike, potrebno je da ponovo izgradite slike. Pogledajte relevantne korake u ovom priručniku. Zatim navedite vaše slike prilikom instalacije ONLYOFFICE Docs.

10. Dodajte prilagođene rečnike

Da biste dodali vaše prilagođene rečnike u slike, potrebno je da ponovo izgradite slike. Pogledajte relevantne korake u ovom priručniku. Zatim navedite vaše slike prilikom instalacije ONLYOFFICE Docs.

11. Promenite teme interfejsa

1. Kreirajte ConfigMap koji sadrži json fajl

   Da biste kreirali ConfigMap sa json fajlom koji sadrži teme interfejsa, potrebno je da pokrenete sledeću komandu:

   $ kubectl create configmap custom-themes \
     --from-file=./custom-themes.json

   Umesto custom-themes i custom-themes.json možete koristiti bilo koja druga imena.
2. Odredite parametre prilikom instalacije ONLYOFFICE Docs

   Prilikom instalacije ONLYOFFICE Docs, navedite parametre extraThemes.configMap=custom-themes i extraThemes.filename=custom-themes.json.

   Ako je potrebno dodati teme interfejsa nakon što je ONLYOFFICE Docs već instaliran, potrebno je izvršiti korak 11.1 i zatim pokrenuti helm upgrade documentserver onlyoffice/docs --set extraThemes.configMap=custom-themes --set extraThemes.filename=custom-themes.json --no-hooks komandu ili helm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hooks ako su parametri navedeni u fajlu values.yaml.

12. Povezivanje Amazon S3 korpe kao keša sa ONLYOFFICE Helm Docs

Da biste povezali Amazon S3 korpu kao keš, potrebno je da kreirate konfiguracioni fajl ili izmenite postojeći u skladu sa ovim vodičem i promenite vrednost parametra persistence.storageS3 na true.

1. Postavljanje ONLYOFFICE Docs licence

1. Kreirajte tajnu

   Ako imate važeću ONLYOFFICE Docs licencu, kreirajte tajnu license iz fajla:

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

   Gde je SECRET_LICENSE_NAME naziv buduće tajne sa licencom.

   Naziv izvornog licencnog fajla treba da bude 'license.lic' jer će se ovo ime koristiti kao polje u kreiranoj tajni.

   Ako se instalacija izvrši bez kreiranja tajne sa postojećom licencnom datotekom, automatski će se kreirati prazna tajna license. Za informacije o tome kako ažurirati postojeću tajnu sa licencom, pogledajte ovde.
2. Navesti parametre prilikom instalacije ONLYOFFICE Docs

   Prilikom instalacije ONLYOFFICE Docs, navedite parametar license.existingSecret=[SECRET_LICENSE_NAME].

   $ helm install documentserver onlyoffice/docs --set license.existingSecret=[SECRET_LICENSE_NAME]

   Ako je potrebno dodati licencu nakon što je ONLYOFFICE Docs već instaliran, potrebno je izvršiti korak 1.1 i zatim pokrenuti komandu helm upgrade documentserver onlyoffice/docs --set license.existingSecret=[SECRET_LICENSE_NAME] --no-hooks ili helm upgrade documentserver -f ./values.yaml onlyoffice/docs --no-hooks ako su parametri navedeni u datoteci values.yaml.

2. Postavljanje ONLYOFFICE Docs

Da biste postavili ONLYOFFICE Docs sa imenom izdanja documentserver:

$ helm install documentserver onlyoffice/docs

Komanda postavlja ONLYOFFICE Docs na Kubernetes klaster u podrazumevanoj konfiguraciji. U odeljku Parametri su navedeni parametri koji se mogu konfigurisati tokom instalacije.

3. Deinstalacija ONLYOFFICE Docs

Da biste deinstalirali/obrisali izdanje documentserver:

$ helm delete documentserver

Izvršavanje komande helm delete pokreće hook-ove, koji izvode neke pripremne radnje pre potpunog brisanja ONLYOFFICE Docs, uključujući zaustavljanje servera, čišćenje korišćenih PVC i tabela baze podataka. Podrazumevano vreme izvršavanja hook-ova je 300s. Vreme izvršavanja može se promeniti korišćenjem --timeout [time], na primer:

$ helm delete documentserver --timeout 25m

Ako želite da obrišete ONLYOFFICE Docs bez pripremnih radnji, pokrenite sledeću komandu:

$ helm delete documentserver --no-hooks

Komanda helm delete uklanja sve Kubernetes komponente povezane sa chart-om i briše izdanje.

4. Parametri

Svaki parametar navedite koristeći argument --set key=value[,key=value] za helm install. Na primer:

$ helm install documentserver onlyoffice/docs --set ingress.enabled=true,ingress.ssl.enabled=true,ingress.host=example.com

Ova komanda izlaže ONLYOFFICE Docs putem HTTPS-a.

Alternativno, YAML datoteka koja specificira vrednosti za parametre može se obezbediti tokom instalacije chart-a:

$ helm install documentserver -f values.yaml onlyoffice/docs

5. Detalji konfiguracije i instalacije

1. Primer implementacije (opciono)
   Važno Ovaj korak je opciono. Možete ga potpuno preskočiti ako ne morate da implementirate primer.

   Da biste implementirali primer, postavite parametar example.enabled na true:

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

2. Implementacija metrika (opciono)

   Važno Ovaj korak je opciono. Možete ga potpuno preskočiti ako ne morate da implementirate metrike.

   Da biste implementirali metrike, postavite metrics.enabled na true:

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

   Ako želite da koristite Grafana za vizualizaciju metrika, postavite grafana.enabled na true. Ako želite da koristite Nginx Ingress za pristup Grafani, postavite grafana.ingress.enabled na true:

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

3. Izložite ONLYOFFICE Docs
   1. Izložite ONLYOFFICE Docs putem Servisa (samo HTTP)
      Trebalo bi da preskočite ovaj korak ako planirate da izložite ONLYOFFICE Docs putem HTTPS-a.

      Ovaj tip izlaganja kreira loadbalancer za pristup ONLYOFFICE Docs. Koristite ovaj tip ako koristite eksterno TLS završavanje i nemate drugu web aplikaciju u k8s klasteru.

      Da biste izložili ONLYOFFICE Docs putem servisa, postavite parametar service.type na LoadBalancer:

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

      Pokrenite sledeću komandu da biste dobili IP adresu servisa documentserver:

      $ kubectl get service documentserver -o jsonpath="{.status.loadBalancer.ingress[*].ip}"

      Nakon toga, ONLYOFFICE Docs će biti dostupan na http://DOCUMENTSERVER-SERVICE-IP/.

      Ako je IP adresa servisa prazna, pokušajte da dobijete hostname servisa documentserver:

      $ kubectl get service documentserver -o jsonpath="{.status.loadBalancer.ingress[*].hostname}"

      U tom slučaju, ONLYOFFICE Docs će biti dostupan na http://DOCUMENTSERVER-SERVICE-HOSTNAME/.

   2. Izložite ONLYOFFICE Docs putem Ingress-a

      Prvo, instalirajte Kubernetes Nginx Ingress Controller:

      $ helm install nginx-ingress ingress-nginx/ingress-nginx --set controller.publishService.enabled=true,controller.replicaCount=2

      Da biste omogućili izlaganje metrika ingress-nginx za Prometheus, pokrenite:

      $ helm install nginx-ingress -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/ingress_values.yaml ingress-nginx/ingress-nginx

      Više detalja o instalaciji Nginx Ingress putem Helm-a možete pronaći ovde.

      Zatim izaberite metod izlaganja:

      • Putem HTTP-a

        Trebalo bi da preskočite ovo ako planirate da izložite ONLYOFFICE Docs putem HTTPS-a.

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

        Dobijte IP adresu ingress-a:

        $ kubectl get ingress documentserver -o jsonpath="{.status.loadBalancer.ingress[*].ip}"

        ONLYOFFICE Docs će biti dostupan na http://DOCUMENTSERVER-INGRESS-IP/ (ili koristite hostname ako je IP prazan).

      • Putem HTTPS-a (TLS završavanje)

        Kreirajte tls tajnu sa vašim SSL sertifikatom:

        $ 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

        Povežite IP adresu ili hostname ingress-a sa vašim domenom putem vašeg DNS provajdera. Nakon toga, ONLYOFFICE Docs će biti dostupan na https://your-domain-name/.

      • Putem HTTPS-a koristeći Let's Encrypt

        $ 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

        Zatim instalirajte ili unapredite ONLYOFFICE Docs postavljanjem ingress.enabled, ingress.ssl.enabled, ingress.letsencrypt.enabled na true, i specificiranjem vaših vrednosti za ingress.letsencrypt.email i ingress.host (ili ingress.tenants za više domena).

      • Putem virtuelne putanje

        Postavite parametre ingress.enabled, ingress.host i ingress.path:

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

        Podržani ingress kontroleri: Ingress NGINX od Kubernetes-a, NGINX Ingress od NGINX-a, HAProxy Ingress od HAProxy-a.

        Za Ingress NGINX od Kubernetes-a, dodajte obrazac (/|$)(.*) na ingress.path, npr. /docs(/|$)(.*).

   3. Izložite ONLYOFFICE Docs putem rute u OpenShift-u

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

      Za TLS završavanje, ručno dodajte sertifikate na rutu putem OpenShift web konzole.

6. Skaliranje ONLYOFFICE Docs

1. Horizontalno automatsko skaliranje Pod-a

   Možete omogućiti automatsko skaliranje tako da se broj replika docservice i converter implementacija automatski izračunava na osnovu vrednosti i tipa metrika.

   Za metrike resursa, API metrics.k8s.io mora biti registrovan, što je obično obezbeđeno od strane metrics-server. Može se pokrenuti kao dodatak za klaster.

   Da biste omogućili HPA za docservice deployment, navedite parametar docservice.autoscaling.enabled=true. Slično tome, da biste omogućili HPA za converter deployment, navedite converter.autoscaling.enabled=true. U oba slučaja, odgovarajući parametar replicas se ignoriše i broj replika kontroliše HPA.

   Za više informacija o Horizontal Pod Autoscaling-u, pogledajte ovde. Za ostale podesive parametre Autoscaling-a, pogledajte tabelu Parametri.

2. Ručna skaliranja

   Deployment-i docservice i converter se sastoje od po 2 pod-a po default-u.

   Da biste skalirali docservice deployment:

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

   Da biste skalirali converter deployment:

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

7. Ažuriranje ONLYOFFICE Docs

Za ažuriranje, postavite parametre za nadogradnju. Na primer:

$ helm upgrade documentserver onlyoffice/docs \
  --set docservice.image.tag=[version]

Ili izmenite datoteku values.yaml i pokrenite:

$ helm upgrade documentserver -f values.yaml onlyoffice/docs

Komanda helm upgrade pokreće hook koji isključuje ONLYOFFICE Docs i čisti bazu podataka. Podrazumevano vreme izvršenja hook-a je 300s. Da biste ga promenili:

$ helm upgrade documentserver -f values.yaml onlyoffice/docs --timeout 15m

Da biste ažurirali bilo koji parametar osim verzije ONLYOFFICE Docs, pokrenite helm upgrade bez hook-ova:

$ helm upgrade documentserver onlyoffice/docs --set jwt.enabled=false --no-hooks

Da biste vratili ažuriranja:

$ helm rollback documentserver

8. Isključivanje ONLYOFFICE Docs

Da biste izvršili isključivanje, pokrenite sledeću komandu:

$ kubectl apply -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/shutdown-ds.yaml -n <NAMESPACE>

Gde je <NAMESPACE> prostor imena gde je ONLYOFFICE Docs instaliran. Podrazumevano je default ako nije navedeno. Na primer:

$ kubectl apply -f https://raw.githubusercontent.com/ONLYOFFICE/Kubernetes-Docs/master/sources/shutdown-ds.yaml -n onlyoffice

Nakon što shutdown-ds Pod uspešno izvrši, obrišite Job:

$ kubectl delete job shutdown-ds -n <NAMESPACE>

Da biste ponovo pokrenuli ONLYOFFICE Docs nakon isključivanja, ponovo pokrenite docservice i converter pod-ove:

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

9. Ažuriranje licence za ONLYOFFICE Docs

Od verzije v5.1.1, možete ažurirati licencu ponovnim kreiranjem tajne bez ponovnog pokretanja pod-ova. Da biste ažurirali licencu:

• Postavite novu datoteku license.lic u direktorijum.
• Pokrenite sledeće komande:

  $ kubectl delete secret [SECRET_LICENSE_NAME] -n <NAMESPACE>
  $ kubectl create secret generic [SECRET_LICENSE_NAME] --from-file=path/to/license.lic -n <NAMESPACE>

  Gde je SECRET_LICENSE_NAME ime postojeće tajne sa licencom.

Documentserver će automatski ponovo učitati novu licencu.

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

10. Testiranje instalacije ONLYOFFICE Docs

Testirajte dostupnost ONLYOFFICE Docs i pristup povezanim zavisnostima:

$ helm test documentserver -n <NAMESPACE>

Izlaz bi trebao sadržati:

Phase: Succeeded

Da biste pregledali log testiranja:

$ kubectl logs -f test-ds -n <NAMESPACE>

Nakon testiranja, obrišite test-ds Pod:

$ kubectl delete pod test-ds -n <NAMESPACE>

11. Pokretanje Job-ova u privatnom k8s klasteru

Kada pokrećete Job za instalaciju, ažuriranje, vraćanje ili brisanje, kontejneru je potreban pristup internetu da bi preuzeo najnovije SQL skripte. Ako je pristup spoljašnjoj mreži ograničen u vašem klasteru, postavite privateCluster=true i ručno kreirajte ConfigMap sa potrebnim SQL skriptama.

Ako vaš klaster već ima remove-db-scripts i init-db-scripts configmap-ove, prvo ih obrišite:

$ kubectl delete cm remove-db-scripts init-db-scripts

Preuzmite skripte baze podataka. Za PostgreSQL:

$ wget -O removetbl.sql https://raw.githubusercontent.com/ONLYOFFICE/server/master/schema/postgresql/removetbl.sql
$ wget -O createdb.sql https://raw.githubusercontent.com/ONLYOFFICE/server/master/schema/postgresql/createdb.sql

Za MySQL:

$ wget -O removetbl.sql https://raw.githubusercontent.com/ONLYOFFICE/server/master/schema/mysql/removetbl.sql
$ wget -O createdb.sql https://raw.githubusercontent.com/ONLYOFFICE/server/master/schema/mysql/createdb.sql

Kreirajte configmap-ove od njih:

$ kubectl create configmap remove-db-scripts --from-file=./removetbl.sql
$ kubectl create configmap init-db-scripts --from-file=./createdb.sql

Ako ste koristili različita imena za ConfigMap ili datoteke, postavite odgovarajuće parametre za odgovarajuće job-ove: existingConfigmap.tblRemove.name / existingConfigmap.tblRemove.keyName za skripte čišćenja, i existingConfigmap.tblCreate.name / existingConfigmap.tblCreate.keyName za skripte kreiranja.

Zatim, kada pokrećete helm install|upgrade|rollback|delete, postavite parametar privateCluster=true.

12. Pristup info stranici

Pristup stranici /info je po default-u ograničen. Da biste omogućili pristup, navedite IP adrese ili subnet-ove koristeći parametar proxy.infoAllowedIP. Imajte na umu da zbog specifičnosti mreže u Kubernetes-u, stvarni klijenti su obično adrese Pod-a, Node-a ili Load Balancer-a, a ne originalni korisnički IP.

Možete dodatno ograničiti pristup koristeći Nginx Osnovnu Autentifikaciju postavljanjem parametra proxy.infoAllowedUser i lozinke putem proxy.infoAllowedPassword. Alternativno, koristite postojeću tajnu postavljanjem proxy.infoAllowedExistingSecret.

1. Implementacija Grafana

1. Implementacija Grafana bez gotovih kontrolnih tabli
   Preskočite ovaj korak ako želite da implementirate Grafana sa gotovim kontrolnim tablama.

   $ 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. Postavljanje Grafana sa unapred pripremljenim kontrolnim tablama
   1. Instalirajte unapred pripremljene Grafana kontrolne table

      Podesite parametre grafana.enabled i grafana.dashboard.enabled na true. Ako je ONLYOFFICE Docs već instaliran, pokrenite:

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

      Ovo preuzima unapred pripremljene kontrolne table u JSON formatu sa Grafana sajta, primenjuje potrebne izmene i kreira configmap od njih. Takođe se dodaje kontrolna tabla za metrike ONLYOFFICE Docs (pretpostavlja se da je korak 6 (Postavljanje StatsD eksportera) već završen).

   2. Instalirajte Grafana

      $ 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

      Sledeće kontrolne table će biti uvezene u Grafana: Node Exporter, Deployment Statefulset Daemonset, Redis Dashboard za Prometheus Redis Exporter, RabbitMQ-Overview, PostgreSQL Database, NGINX Ingress kontroler, ONLYOFFICE Docs, i Korišćenje resursa po Podovima i Kontejnerima.

      Opis metrika ONLYOFFICE Docs vizualizovanih u Grafana možete videti ovde.

      Više detalja o instalaciji Grafana putem Helm-a možete pronaći ovde.

2. Pristup Grafana putem Ingress

Ako je ONLYOFFICE Docs instaliran sa parametrom grafana.ingress.enabled (Postavljanje metrika), Grafana će biti dostupna na: http://INGRESS-ADDRESS/grafana/

Ako je Ingress instaliran sa sigurnom vezom (Izložite ONLYOFFICE Docs putem HTTPS), Grafana će biti dostupna na: https://your-domain-name/grafana/

3. Pregled prikupljenih metrika u Grafana

Idite na http(s)://your-domain-name/grafana/ i prijavite se sa:

Login - admin

Da biste dobili lozinku, pokrenite:

$ kubectl get secret grafana-admin --namespace default -o jsonpath="{.data.GF_SECURITY_ADMIN_PASSWORD}" | base64 --decode

U sekciji kontrolnih tabli, videćete dodate kontrolne table koje prikazuju metrike primljene od Prometheus-a.