Configuration reference

Every property the library reads, what it defaults to, and how CNH wires it through Helm values and Octopus variables. Code declares safe defaults; YAML overrides them per environment without a rebuild.

The principle

• The connection is Spring's. The engine uses spring.data.redis.* as is — host/port, Sentinel, password, timeouts, Lettuce pool. There is no second Redis configuration.
• Region behaviour is declared in code, tuned in YAML. A binding or annotation declares kind, TTL, indexes. dac.cache.regions.<name>.* overrides the tunable subset — and only that subset; the contract (types, kind, indexes) is not tunable.
• Applications do not invent cache properties. A TTL lives under dac.cache.regions.<region>.l2-ttl, a toggle under dac.domains.<domain>.enabled. An application-level flag is justified only for a precondition the framework cannot know (app.cache.user-alerts.read-enabled).

dac.cache — the cache plane (engine)

dac.cache.regions.<region> — per-region tuning

Durations accept Spring's forms: 30s, 5m, 24h, or ISO-8601 PT5M. Region names are the exact names from the binding (userAlerts, eventConfig); the whole map is bound at once, so camel-case keys are fine.

dac:
  cache:
    refresh-cron: "0 */15 * * * *"
    regions:
      eventConfig:       { startup: reload-if-stale, max-snapshot-age: PT30M }
      userAlerts:        { l2-ttl: PT5M }
      idmUsers:          { l2-ttl: 30m }
      transactions:      { l2-ttl: ${TRANSACTION_CACHE_TTL:30s}, negative-ttl: 15s, l1-max-size: 1000 }

dac.cache.refresh-events — the refresh stream consumer

dac.cache.broadcast — the cluster broadcast

The consolidated health check is an actuator endpoint and follows the usual exposure rule — add dachealth to management.endpoints.web.exposure.include where you want it reachable. See Running it — cluster broadcast for what it returns and how to expose your own functions.

dac.domains.<domain> — domain flags

Domains CNH declares today: cast, ldap-user, user-preference, pas-user, idm-user, pao-authorized-portfolio, cra-relationship-manager — see the regions reference.

spring.data.redis — the connection

spring:
  data:
    redis:
      sentinel:
        master: indc-master
        nodes: valkey-sentinel.valkey.svc:26379
        password: ${VALKEY_PASSWORD}
      password: ${VALKEY_PASSWORD}
      timeout: 6000ms           # must exceed indc.priority.block-timeout where priority lanes are used
      lettuce:
        pool: { max-active: 20, max-idle: 10, min-idle: 5, max-wait: 2000ms }
        shutdown-timeout: 200ms

spring:
  data:
    redis:
      host: ${REDIS_HOST}
      port: 10000
      ssl: { enabled: true }
      password: ${REDIS_KEY}

Helm and Octopus wiring (CNH)

Each chart renders the dac block of configs/application.yaml from values that are Octopus variables, so an environment can tune TTLs, flags and schedules without a rebuild. The convention: CNH.<app>.dac.cache.… and CNH.<app>.dac.cast.enabled, mirroring the property path.

indc-core-chart

dac:
  cache:
    enabled: {{ .Values.configmapfile.configs.dac.cache.enabled }}
    refresh-cron: '{{ .Values.configmapfile.configs.dac.cache.refreshCron }}'
    regions:
      {{- range list "eventConfig" "eventTemplate" "eventGroup" "alerts" "alertChannelMapping" "bookingCentreMapping" "eventSegmentsMapping" }}
      {{ . }}: { startup: {{ $.Values…dac.cache.masterData.startup }}, max-snapshot-age: {{ $.Values…dac.cache.masterData.maxSnapshotAge }} }
      {{- end }}
      userAlerts: { l2-ttl: {{ .Values…dac.cache.regions.userAlerts.l2Ttl }} }
      ldapUsers: { l2-ttl: {{ .Values…dac.cache.ttlMinutes.default }}m }
      …
  domains:
    cast:        { enabled: {{ .Values…dac.domains.cast.enabled }} }
    idm-user:    { enabled: {{ include "app.cacheEnabled" (dict "cache" .Values…dac "key" "idmUser") }} }
    …

alert-be-app-chart

dac:
  cache:
    enabled: {{ .Values.configmapfile.configs.dac.cache.enabled }}
    regions:
      userDevices:
        l2-ttl: {{ .Values.configmapfile.configs.dac.cache.regions.userDevices.l2Ttl }}
  domains:
    cast:
      enabled: {{ .Values.configmapfile.configs.dac.domains.cast.enabled }}

Actuator