Helm Chart

Helm Chart pre D2000 zjednodušuje nasadenie D2000 aplikácie do prostredia Kubernetes tak, že konfiguračné YAML súbory zabaľuje do jedného celku šablón, ktorých konfigurácia je redukovaná na súbor premenných values.yaml. K tomuto súboru sa doplnia už len súbory s heslami a licenciou D2000 (LicenceRun.code).

Konfigurácia

Konfiguračný súbor values.yaml je rozdelený do viacerých sekcií. Prvá sekcia obsahuje základné premenné ako napríklad názov a popis aplikácie, definíciu časového pásmu zo zoznamu časových pásiem, adresu repozitára pre image a ich predvolený tag. Niektoré z týchto premenných sú kontajnerov odovzdávné ako premenné prostredia. Taktiež sa tu definuje adresa databázového servera a perzistenté úložisko podľa špecifikácie PersistentVolumeClaimSpec. Taktiež je tu možné definovať ďalšie, pre všetky kontajnery spoločné, premenné prostredia. Toto je vhodné miesto pre definovanie premenných prostredia napríklad pre zber dát cez OpenTelemetry.

d2App: d2000_helm                           # Názov D2000 aplikácie. Prenesie sa do runtime ako premenná prostredia D2APP.
d2AppDesc: "K8s testovacia aplikácia"       # Popis D2000 aplikácie. Prenesie sa do runtime ako premenná prostredia D2APPDESC.
d2PersistentVolumeClaimSpec:                # Špecifikácia PVC pre uloženie D2000 konfigurácie (PersistentVolumeClaimSpec).
  accessModes: [ ReadWriteMany ]
  resources:
    requests:
      storage: 1Gi
  storageClassName: rook-ceph-filesystem
dbHost: 192.168.1.100                       # Adresara databázového servera.
imageRegistry: registry.ipesoft.com         # Globálne nastavenie repozitára image-ov.
imageTag: v26.00.082                        # Globálne nastavenie tagu image-ov.
timeZone: Europe/Bratislava                 # Názov časoveho pásma. Prenesie sa do runtime ako premenná prostredia TZ.

# Dodatočné spoločné premenné prostredia:
env:
  OTEL_EXPORTER_OTLP_ENDPOINT: http://otelcolt-opentelemetry-collector.monitoring.svc.cluster.local:4318/
  OTEL_EXPORTER_OTLP_PROTOCOL: http/protobuf

V ďalšej časti súboru values.yaml sa definuje typ aplikácie z hľadiska využitia alebo nevyužitia redundancie D2000 serverov a to definovaním premennej d2Kernel, ak nebude využitá redundancia, alebo premennej d2RedundantKernels, ak bude využitá redundancia.

d2RedundantKernels:
  - imageName: ipesoft/d2/kernel_odbc
    d2Name: a
    d2KernelAntiAffinity: true
    d2KernelPriority: 2
    d2ExternalIP: 192.168.253.1
  - imageName: ipesoft/d2/kernel_odbc
    d2Name: b
    d2KernelAntiAffinity: true
    d2KernelPriority: 1
    d2ExternalIP: 192.168.253.2

Pri pripájaní ďalšieho procesu D2000 Server do redundancie je automaticky spúšťaná utilita D2000 CfgSynchroAuto na synchronizáciu konfiguračných databáz.

Následne sa definujú procesy staticky pripojené ku D2000 serveru (v premennej d2StaticKernelProcesses). Ide o pripojenie procesu ku kernelu pomocou štartovacieho parametra /S. Pre tieto procesy je v prípade redundancie D2000 serverov automaticky vytvorená inštancia pre každý z redundantných kernelov a ich Pod-y predvolene bežia na rovnakom Node ako kernel, ku ktorému sú pripájené. Tieto Pod-y zároveň zdieľajú rovnakú cestu perzistentného úložiska so svojim D2000 serverom.

d2StaticKernelProcesses:
  - imageName: ipesoft/d2/alarm               # SELF.ALA
  - imageName: ipesoft/d2/calc                # SELF.CLC
  - imageName: ipesoft/d2/dbmanager_odbc      # SELF.DBM
    argsAdd: [ "/DBSH" ]
  - imageName: ipesoft/d2/event_java_edathin  # SELF.EVH
  - imageName: ipesoft/d2/kom                 # SELF.KOM
    securityContext:
      capabilities:
        add: [ "NET_RAW", "NET_BIND_SERVICE", "DAC_OVERRIDE", "SYS_RAWIO" ]
    argsAdd: [ "/DBSH" ]

Premennou d2ActiveKernelProcesses sa definujú procesy, ktoré sú pripojené vždy len k aktívnemu D2000 serveru v redundancii. Tu ide o pripojenie procesu do redundantnej skupiny pomocou štartovacieho parametra /RF. V prípade, že je aj pre Pod-y týchto procesov žiadané, aby sa držali na rovnakom Node ako niektorý z redundantných kernelov a zdieľali s nimi aj cestu perzistentného úložiska, je možné takéto správanie vynútiť atribútom d2KernelAffinity, v ktorom sa definuje meno redundantného kernela, ktorého sa majú držať.

d2ActiveKernelProcesses:
  - imageName: ipesoft/d2/archiv_odbc    # SELF.ARC
  - imageName: ipesoft/d2/edaserver_odbc # SELF.EDS

Nakoniec, premennou d2SmartWebDeployments sa definujú SmartWeb inštancie, ak majú byť použité.

d2SmartWebDeployments:
  - imageName: ipesoft/d2/smartweb-demo
    d2IngressHost: d2.app.k8s.ipstest.sk
    d2IngressPort: 80
    d2IngressTlsCertFile: certificate.crt
    d2IngressTlsKeyFile: private.key
    d2SmartWebConfig: |-
      smartweb:
        connections:
        - host: "d2-dcs-a-self"
          port: 3120
        - host: "d2-dcs-b-self"
          port: 3120
      server:
        port: 80

Ako atribúty D2000 servera a všetkých procesov vrátane SmartWeb-u je možné použiť atribúty Kubernetes objektu Container. Okrem týchto je možné použiť nasledovné atribúty:

Inštalácia, upgrade a rollback

Po konfigurácii súboru values.yaml a doplnení súborov s heslami a licenciou je nasadenie D2000 aplikácie do K8s realizované príkazom:

helm upgrade -i -f values.yaml my-d2deploy ./d2deploy

, kde my-d2deploy je názov nasadeného Helm Chartu (release). Ako názov release sa odporúča použiť názov aplikácie s prípadne zakomponovaným názvom prostredia (test / prod). Rovnakým príkazom sa aplikujú aj zmeny a vytvára sa nová revízia Helm Chartu. V prípade, že nasadenie zmien neprebehlo úspešne, je možné vykonať rollback na predchádzajúcu (alebo inú špecifikovanú) revíziu príkazom:

helm rollback my-d2deploy