values.yaml 28.6 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# Used to generate top-level secrets (overridden by custom-values.yaml)
16

17
18
19
# Subcharts configuration

# Dynamo operator configuration
20
dynamo-operator:
21
  # -- Whether to enable the Dynamo Kubernetes operator deployment
22
  enabled: true
23
24

  # -- NATS server address for operator communication (leave empty to use the bundled NATS chart). Format: "nats://hostname:port"
25
  natsAddr: ""
26
27

  # -- etcd server address for operator state storage (leave empty to use the bundled etcd chart). Format: "http://hostname:port" or "https://hostname:port"
28
  etcdAddr: ""
29

30
31
32
  # -- URL for the Model Express server if not deployed by this helm chart. This is ignored if Model Express server is installed by this helm chart (global.model-express.enabled is true).
  modelExpressURL: ""
  # -- Namespace access controls for the operator
33
  namespaceRestriction:
34
35
    # -- Whether to restrict operator to specific namespaces. By default, the operator will run with cluster-wide permissions. Only 1 instance of the operator should be deployed in the cluster. If you want to deploy multiple operator instances, you can set this to true and specify the target namespace (by default, the target namespace is the helm release namespace).
    enabled: false
36
    # -- Target namespace for operator deployment (leave empty for current namespace)
37
    targetNamespace:
38
39
40
41
42
43
44
    # Namespace scope marker lease configuration (used to prevent conflicts when running both cluster-wide and namespace-restricted operators)
    lease:
      # Duration before the namespace scope marker lease expires if not renewed (namespace-restricted mode only). When a namespace-restricted operator is running, it creates a lease in its namespace. The cluster-wide operator detects this lease and excludes that namespace from processing. If the namespace operator stops renewing the lease (e.g., crashes), the lease expires and the cluster-wide operator automatically resumes processing that namespace.
      duration: 30s
      # Interval for renewing the namespace scope marker lease (namespace-restricted mode only). The namespace-restricted operator renews its lease at this interval to signal it's still running.
      renewInterval: 10s

45
46
  # -- The Dynamo discovery backend to use. By default, will rely on ETCD for discovery. Can be set to "kubernetes" to use Kubernetes API for service discovery. --
  discoveryBackend: ""
47
48

  # Controller manager configuration
49
  controllerManager:
50
    # -- Node tolerations for controller manager pods
51
    tolerations: []
52

53
54
55
    # -- Affinity for controller manager pods
    affinity: []

56
57
58
59
60
61
62
    # Leader election configuration for cluster-wide coordination
    leaderElection:
      # -- Leader election ID for cluster-wide coordination. WARNING: All cluster-wide operators must use the SAME ID to prevent split-brain. Different IDs would allow multiple leaders simultaneously.
      id: ""  # If empty, defaults to: dynamo.nvidia.com (shared across all cluster-wide operators)
      # -- Namespace for leader election leases (only used in cluster-wide mode). If empty, defaults to kube-system for cluster-wide coordination. All cluster-wide operators should use the SAME namespace for proper leader election.
      namespace: ""

63
    manager:
64
      # Container image configuration for the operator manager
65
      image:
66
        # -- Official NVIDIA Dynamo operator image repository
67
        repository: "nvcr.io/nvidia/ai-dynamo/kubernetes-operator"
68
        # -- Image tag (leave empty to use chart default)
69
        tag: ""
70
        # -- Image pull policy - when to pull the image
71
        pullPolicy: IfNotPresent
72
73

      # Command line arguments for the operator manager
74
      args:
75
        # -- Health probe endpoint for Kubernetes health checks
76
        - --health-probe-bind-address=:8081
77
        # -- Metrics endpoint for Prometheus scraping (localhost only for security)
78
        - --metrics-bind-address=127.0.0.1:8080
79
80

  # -- Secrets for pulling private container images
81
  imagePullSecrets: []
82
83

  # Core Dynamo platform configuration
84
  dynamo:
85
    # -- How long to wait before forcefully terminating Grove instances
86
    groveTerminationDelay: 4h
87
88

    # Internal utility images used by the platform
89
    internalImages:
90
      # -- Debugger image for troubleshooting deployments
91
      debugger: python:3.12-slim
92
93

    # -- Whether to enable restricted security contexts for enhanced security
94
    enableRestrictedSecurityContext: false
95
96

    # Docker registry configuration for private repositories
97
    dockerRegistry:
98
      # -- Whether to use Kubernetes secrets for registry authentication
99
      useKubernetesSecret: false
100
      # -- Docker registry server URL
101
      server:
102
      # -- Registry username
103
      username:
104
      # -- Registry password (consider using existingSecretName instead)
105
      password:
106
      # -- Name of existing Kubernetes secret containing registry credentials
107
      existingSecretName:
108
      # -- Whether the registry uses HTTPS
109
      secure: true
110
111

    # Ingress configuration for external access
112
    ingress:
113
      # -- Whether to create ingress resources
114
      enabled: false
115
      # -- Ingress class name (e.g., "nginx", "traefik")
116
      className:
117
      # -- Secret name containing TLS certificates
118
      tlsSecretName: my-tls-secret
119
120

    # Istio service mesh configuration
121
    istio:
122
      # -- Whether to enable Istio integration
123
      enabled: false
124
      # -- Istio gateway name for routing
125
      gateway:
126
127

    # -- Host suffix for generated ingress hostnames
128
    ingressHostSuffix: ""
129
130

    # -- Whether VirtualServices should support HTTPS routing
131
    virtualServiceSupportsHTTPS: false
132

133
134
135
136
137
    # Metrics configuration
    metrics:
      # -- Endpoint that services can use to retrieve metrics. If set, dynamo operator will automatically inject the PROMETHEUS_ENDPOINT environment variable into services it manages. Users can override the value of the PROMETHEUS_ENDPOINT environment variable by modifying the corresponding deployment's environment variables
      prometheusEndpoint: ""

138
139
140
141
142
143
144
145
146
    # MPI Run configuration
    mpiRun:
      # -- Name of the secret containing the SSH key for MPI Run
      secretName: "mpi-run-ssh-secret"
      # SSH key generation configuration
      sshKeygen:
        # -- Whether to enable SSH key generation for MPI Run
        enabled: true

147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
  # Webhook configuration for admission control and validation
  webhook:
    # -- Whether to enable admission webhooks for resource validation. When enabled, the operator will validate DynamoComponentDeployment and DynamoGraphDeployment resources before they are created or updated in the cluster. Enabled by default for production-ready validation and better error reporting.
    enabled: true

    # Certificate configuration for webhook TLS
    certificateSecret:
      # -- Name of the Kubernetes secret containing webhook TLS certificates. The secret must contain three keys: tls.crt (server certificate), tls.key (server private key), and ca.crt (Certificate Authority certificate).
      name: webhook-server-cert

      # -- Whether to manage the certificate secret externally. When false (default), certificates are automatically generated via Helm hooks during installation. When true, you must create the secret manually before installing the chart.
      external: false

    # -- Certificate validity duration in days for auto-generated certificates. Only used when certManager.enabled=false and certificateSecret.external=false. After this duration, certificates will expire and need to be regenerated.
    certificateValidity: 365

    # Container image for certificate generation and CA injection jobs
    # Only used when certManager.enabled=false and certificateSecret.external=false
    certGenerator:
      image:
        # -- Container image repository for certificate generation jobs. This image must contain both openssl and kubectl commands.
        repository: bitnami/kubectl
        # -- Container image tag for certificate generation jobs
        tag: latest
        # -- Image pull policy for certificate generation jobs
        pullPolicy: IfNotPresent

    # -- CA bundle (base64 encoded) for webhook validation. Only used when certificateSecret.external=true. For automatic certificate generation or cert-manager integration, leave this empty as it will be injected automatically.
    caBundle: ""

    # -- Webhook failure policy controls how Kubernetes handles requests when the webhook is unavailable. 'Fail' (recommended for production) rejects requests if the webhook cannot be reached, ensuring strict validation. 'Ignore' allows requests through if the webhook is unavailable, providing availability over validation guarantees.
    failurePolicy: Fail

    # -- Timeout in seconds for webhook validation calls. If the webhook doesn't respond within this time, the request will be handled according to the failurePolicy.
    timeoutSeconds: 10

    # Namespace selector for webhook scope control
    # -- Custom namespace selector for webhook validation. Use this to include or exclude specific namespaces from webhook validation. For CLUSTER-WIDE operators, you can exclude namespaces managed by namespace-restricted operators by using: matchExpressions: [{ key: "dynamo-operator", operator: "NotIn", values: ["namespace-restricted"] }]. For NAMESPACE-RESTRICTED operators, leave empty as it will be auto-configured to match only the operator's namespace.
    namespaceSelector: {}

    # cert-manager integration for automated certificate lifecycle management
    certManager:
      # -- Whether to use cert-manager for automatic certificate management. Requires cert-manager to be installed in the cluster. When enabled, cert-manager will automatically generate, renew, and rotate certificates, and the automatic certificate generation via Helm hooks will be disabled.
      enabled: false

      # Certificate configuration for cert-manager
      certificate:
        # -- Certificate duration for webhook certificates managed by cert-manager (e.g., "8760h" for 1 year). cert-manager will automatically renew the certificate before it expires.
        duration: "8760h"

        # -- Time before certificate expiration to trigger renewal (e.g., "360h" for 15 days). cert-manager will attempt to renew the certificate when this threshold is reached.
        renewBefore: "360h"

        # Root CA configuration for cert-manager
        rootCA:
          # -- Duration for the root CA certificate (e.g., "87600h" for 10 years). The root CA typically has a much longer lifetime than the leaf certificates it signs.
          duration: "87600h"

          # -- Time before root CA expiration to trigger renewal (e.g., "720h" for 30 days). Renewing a CA can be disruptive as all signed certificates must be reissued.
          renewBefore: "720h"

208
209
210
211
212
213
214
215
216
217
218
219

# Grove component - distributed inference orchestration
grove:
  # -- Whether to enable Grove for multi-node inference coordination, if enabled, the Grove operator will be deployed cluster-wide
  enabled: false

# Kai Scheduler component - advanced workload scheduling
kai-scheduler:
  # -- Whether to enable Kai Scheduler for intelligent resource allocation, if enabled, the Kai Scheduler operator will be deployed cluster-wide
  enabled: false

# etcd configuration - distributed key-value store for operator state
220
etcd:
221

222
  # -- Whether to enable etcd deployment, disable if you want to use an external etcd instance. For complete configuration options, see: https://github.com/bitnami/charts/tree/main/bitnami/etcd , all etcd settings should be prefixed with "etcd."
223
  enabled: true
224

225
  image:
226
    # -- following bitnami announcement for brownout - https://github.com/bitnami/charts/tree/main/bitnami/etcd#%EF%B8%8F-important-notice-upcoming-changes-to-the-bitnami-catalog, we need to use the legacy repository until we migrate to the new "secure" repository
227
    repository: bitnamilegacy/etcd
228
    tag: 3.5.18-debian-12-r5
229

230
  # Persistent storage configuration for etcd data
231
  persistence:
232
    # Whether to enable persistent storage (recommended for production)
233
234
235
    enabled: true
    # Use the cluster default storage-class or override with a named class
    storageClass: null
236
    # Size of persistent volume for etcd data
237
    size: 1Gi
238
239

  # Pre-upgrade job configuration
240
  preUpgradeJob:
241
    # Whether to run pre-upgrade validation jobs
242
    enabled: false
243
244

  # Number of etcd replicas (1 for single-node, 3+ for HA)
245
  replicaCount: 1
246
247
248

  # Authentication and authorization settings
  # Explicitly remove authentication for simplified internal communication
249
250
  auth:
    rbac:
251
      # Whether to create RBAC authentication (disabled for internal use)
252
253
      create: false

254
  # Health check configuration
255
  readinessProbe:
256
    # Whether to enable readiness probes (disabled to reduce startup complexity)
257
258
259
    enabled: false

  livenessProbe:
260
    # Whether to enable liveness probes (disabled to reduce startup complexity)
261
262
    enabled: false

263
  # Node tolerations for etcd pods (allows scheduling on specific nodes)
264
265
  tolerations: []

266
# NATS configuration - messaging system for operator communication
267
nats:
268
  # -- Whether to enable NATS deployment, disable if you want to use an external NATS instance. For complete configuration options, see: https://github.com/nats-io/k8s/tree/main/helm/charts/nats , all nats settings should be prefixed with "nats."
269
  enabled: true
270
271
272
273

  # TLS Certificate Authority configuration for secure communication
  # Reference a common CA Certificate or Bundle in all nats config `tls` blocks and nats-box contexts
  # Note: `tls.verify` still must be set in the appropriate nats config `tls` blocks to require mTLS
274
  tlsCA:
275
    # Whether to enable TLS CA configuration
276
277
    enabled: false

278
  # Core NATS server configuration
279
  config:
280
    # NATS clustering for high availability (multiple NATS servers)
281
    cluster:
282
      # Whether to enable NATS clustering (disabled for single-node setups)
283
284
      enabled: false

285
    # JetStream - persistent messaging and streaming capabilities
286
    jetstream:
287
      # Whether to enable JetStream (recommended for persistent messaging)
288
289
      enabled: true

290
      # File-based storage for JetStream streams and consumers
291
      fileStore:
292
        # Whether to enable file storage (persistent across restarts)
293
        enabled: true
294
        # Directory path for JetStream file storage
295
296
297
        dir: /data

        ############################################################
298
        # Persistent Volume Claim for JetStream file storage
299
300
        ############################################################
        pvc:
301
          # Whether to create a PVC for JetStream storage
302
          enabled: true
303
          # Size of the persistent volume for JetStream data
304
          size: 10Gi
305
          # Storage class name (leave empty for default)
306
307
          storageClassName:

308
          # Advanced PVC configuration (merge additional fields)
309
310
311
          # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#persistentvolumeclaim-v1-core
          merge: {}
          patch: []
312
          # PVC name (defaults to "{{ include "nats.fullname" $ }}-js")
313
314
          name:

315
        # Maximum size for JetStream file storage (defaults to PVC size)
316
317
        maxSize:

318
      # Memory-based storage for JetStream (non-persistent)
319
      memoryStore:
320
        # Whether to enable memory storage (faster but not persistent)
321
322
        enabled: false

323
324
      # Advanced JetStream configuration
      # For options see: https://docs.nats.io/running-a-nats-service/configuration#jetstream
325
326
327
      merge: {}
      patch: []

328
    # Core NATS server settings
329
    nats:
330
      # Port for NATS client connections
331
      port: 4222
332
333

      # TLS configuration for encrypted connections
334
      tls:
335
        # Whether to enable TLS encryption
336
        enabled: false
337
338
        # Advanced TLS configuration
        # For options see: https://docs.nats.io/running-a-nats-service/configuration/securing_nats/tls
339
340
341
        merge: {}
        patch: []

342
    # Leaf nodes for creating NATS topologies and remote connections
343
    leafnodes:
344
      # Whether to enable leaf node connections
345
346
      enabled: false

347
    # WebSocket support for browser-based NATS clients
348
    websocket:
349
      # Whether to enable WebSocket protocol support
350
351
      enabled: false

352
    # MQTT protocol bridge for IoT device connectivity
353
    mqtt:
354
      # Whether to enable MQTT protocol support
355
356
      enabled: false

357
    # Gateway connections for multi-cluster NATS deployments
358
    gateway:
359
      # Whether to enable gateway connections
360
361
      enabled: false

362
    # HTTP monitoring endpoint for NATS server metrics
363
    monitor:
364
      # Whether to enable HTTP monitoring interface
365
      enabled: true
366
      # Port for monitoring HTTP endpoint
367
      port: 8222
368
369

      # TLS configuration for monitoring endpoint
370
      tls:
371
372
        # Whether to enable HTTPS for monitoring (requires config.nats.tls enabled)
        # When enabled, monitoring port will use HTTPS with the options from config.nats.tls
373
374
        enabled: false

375
    # Go pprof profiling endpoint for performance debugging
376
    profiling:
377
      # Whether to enable profiling endpoint (for debugging only)
378
      enabled: false
379
      # Port for profiling endpoint
380
381
      port: 65432

382
    # Account resolver for multi-tenant NATS deployments
383
    resolver:
384
      # Whether to enable account resolution (for advanced multi-tenancy)
385
386
      enabled: false

387
388
389
    # Server naming configuration
    # Adds a prefix to the server name, which defaults to the pod name
    # Helpful for ensuring server name is unique in a super cluster
390
391
    serverNamePrefix: ""

392
393
394
    # Advanced NATS configuration merging and patching
    # For complete options see: https://docs.nats.io/running-a-nats-service/configuration
    # Special rules apply:
395
396
397
398
399
    #  1. strings that start with << and end with >> will be unquoted
    #     use this for variables and numbers with units
    #  2. keys ending in $include will be switched to include directives
    #     keys are sorted alphabetically, use prefix before $includes to control includes ordering
    #     paths should be relative to /etc/nats-config/nats.conf
400
    # Example:
401
402
403
404
405
406
407
408
    #   merge:
    #     $include: ./my-config.conf
    #     zzz$include: ./my-config-last.conf
    #     server_name: nats
    #     authorization:
    #       token: << $TOKEN >>
    #     jetstream:
    #       max_memory_store: << 1GB >>
409
410
411
    merge:
      # 10MB which allows for larger context size : The default NATS max payload size is 1MB, and 256K tokens (with tokens being int32 - 4 bytes each) tips over that 1MB max.
      max_payload: 10485760
412
413
414
    patch: []

  ############################################################
415
  # NATS container configuration in StatefulSet
416
417
  ############################################################
  container:
418
    # NATS server container image configuration
419
    image:
420
      # Official NATS server repository
421
      repository: nats
422
      # NATS server version (Alpine-based for smaller size)
423
      tag: 2.10.21-alpine
424
      # Image pull policy (leave empty for chart default)
425
      pullPolicy:
426
      # Custom registry URL (leave empty for Docker Hub)
427
428
      registry:

429
430
    # Container port configuration
    # Note: Ports must also be enabled in the config section above
431
432
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#containerport-v1-core
    ports:
433
      # Main NATS client connection port
434
      nats: {}
435
      # Leaf node connection port
436
      leafnodes: {}
437
      # WebSocket connection port
438
      websocket: {}
439
      # MQTT protocol port
440
      mqtt: {}
441
      # Cluster communication port
442
      cluster: {}
443
      # Gateway connection port
444
      gateway: {}
445
      # HTTP monitoring port
446
      monitor: {}
447
      # Go profiling port
448
449
      profiling: {}

450
451
452
    # Environment variables for the NATS container
    # Map with key as env var name, value can be string or map
    # Example:
453
454
455
456
457
458
459
460
461
    #   env:
    #     GOMEMLIMIT: 7GiB
    #     TOKEN:
    #       valueFrom:
    #         secretKeyRef:
    #           name: nats-auth
    #           key: token
    env: {}

462
    # Advanced container configuration merging and patching
463
464
465
466
467
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#container-v1-core
    merge: {}
    patch: []

  ############################################################
468
  # Configuration reloader container for hot config updates
469
470
  ############################################################
  reloader:
471
    # Whether to enable the config reloader sidecar container
472
    enabled: true
473
474

    # Config reloader container image
475
    image:
476
      # Official NATS config reloader repository
477
      repository: natsio/nats-server-config-reloader
478
      # Config reloader version
479
      tag: 0.16.0
480
      # Image pull policy (leave empty for chart default)
481
      pullPolicy:
482
      # Custom registry URL (leave empty for Docker Hub)
483
484
      registry:

485
    # Environment variables for the reloader container
486
487
    env: {}

488
489
    # Volume mount prefixes from NATS container to share with reloader
    # All NATS container volume mounts with these prefixes will be mounted into the reloader
490
491
492
    natsVolumeMountPrefixes:
    - /etc/

493
    # Advanced reloader container configuration
494
495
496
497
498
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#container-v1-core
    merge: {}
    patch: []

  ############################################################
499
  # Prometheus metrics exporter container (optional)
500
  ############################################################
501
  # Note: config.monitor must be enabled for this to work
502
  promExporter:
503
    # Whether to enable Prometheus metrics exporter sidecar
504
505
506
    enabled: false

  ############################################################
507
  # Kubernetes Service for NATS access
508
509
  ############################################################
  service:
510
    # Whether to create a Kubernetes Service for NATS
511
512
    enabled: true

513
514
515
    # Service port configuration
    # Additional boolean field 'enabled' controls whether port is exposed in the service
    # Note: Ports must also be enabled in the config section above
516
517
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#serviceport-v1-core
    ports:
518
      # Main NATS client connection port
519
520
      nats:
        enabled: true
521
      # Leaf node connection port
522
523
      leafnodes:
        enabled: true
524
      # WebSocket connection port
525
526
      websocket:
        enabled: true
527
      # MQTT protocol port
528
529
      mqtt:
        enabled: true
530
      # Cluster communication port (typically internal only)
531
532
      cluster:
        enabled: false
533
      # Gateway connection port (typically internal only)
534
535
      gateway:
        enabled: false
536
      # HTTP monitoring port (typically internal only)
537
538
      monitor:
        enabled: false
539
      # Go profiling port (typically internal only)
540
541
542
      profiling:
        enabled: false

543
    # Advanced service configuration
544
545
546
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#service-v1-core
    merge: {}
    patch: []
547
    # Service name (defaults to "{{ include "nats.fullname" $ }}")
548
549
550
    name:

  ############################################################
551
  # Advanced NATS Kubernetes resource configuration
552
553
  ############################################################

554
  # StatefulSet configuration for NATS server persistence
555
  statefulSet:
556
    # Advanced StatefulSet configuration merging and patching
557
558
559
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#statefulset-v1-apps
    merge: {}
    patch: []
560
    # StatefulSet name (defaults to "{{ include "nats.fullname" $ }}")
561
562
    name:

563
  # Pod template configuration for NATS StatefulSet
564
  podTemplate:
565
566
    # Whether to add a hash of the ConfigMap as a pod annotation
    # This will cause the StatefulSet to roll when the ConfigMap is updated
567
568
    configChecksumAnnotation: true

569
570
571
572
573
574
575
    # Pod topology spread constraints for better distribution across nodes
    # Map of topologyKey: topologySpreadConstraint
    # labelSelector will be added automatically to match StatefulSet pods
    # Example:
    #   topologySpreadConstraints:
    #     kubernetes.io/hostname:
    #       maxSkew: 1
576
577
    topologySpreadConstraints: {}

578
    # Advanced pod template configuration
579
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#pod-v1-core
580
581
    merge:
      spec:
582
        # Node tolerations for NATS pods (allows scheduling on specific nodes)
583
        tolerations: []
584
585
    patch: []

586
  # Headless service for StatefulSet pod discovery
587
  headlessService:
588
    # Advanced headless service configuration
589
590
591
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#service-v1-core
    merge: {}
    patch: []
592
    # Headless service name (defaults to "{{ include "nats.fullname" $ }}-headless")
593
594
    name:

595
  # ConfigMap for NATS server configuration
596
  configMap:
597
    # Advanced ConfigMap configuration
598
599
600
    # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#configmap-v1-core
    merge: {}
    patch: []
601
    # ConfigMap name (defaults to "{{ include "nats.fullname" $ }}-config")
602
603
    name:

604
  # Pod Disruption Budget for controlled rolling updates
605
  podDisruptionBudget:
606
    # Whether to create a PodDisruptionBudget (recommended for production)
607
608
    enabled: true

609
  # Service Account for NATS server pods
610
  serviceAccount:
611
    # Whether to create and use a dedicated service account
612
613
614
    enabled: false

  ############################################################
615
616
  # NATS Box - CLI tools and debugging container
  # NATS Box provides CLI tools for interacting with NATS server
617
618
  ############################################################
  natsBox:
619
    # Whether to deploy NATS Box for CLI access and debugging
620
    enabled: false
621
622

    ############################################################
623
    # NATS client contexts for authentication and connection
624
625
    ############################################################
    contexts:
626
      # Default context configuration
627
      default:
628
        # Credentials-based authentication
629
        creds:
630
          # Inline credentials file contents (base64 encoded)
631
          contents:
632
          # Name of existing secret containing credentials file
633
          secretName:
634
          # Directory to mount credentials (defaults to /etc/nats-creds/<context-name>)
635
          dir:
636
          # Key name in secret for credentials file
637
          key: nats.creds
638
639

        # NKey-based authentication (public/private key pairs)
640
        nkey:
641
          # Inline NKey file contents (base64 encoded)
642
          contents:
643
          # Name of existing secret containing NKey file
644
          secretName:
645
          # Directory to mount NKey (defaults to /etc/nats-nkeys/<context-name>)
646
          dir:
647
          # Key name in secret for NKey file
648
          key: nats.nk
649
650

        # TLS client certificate authentication
651
        tls:
652
          # Name of existing secret containing TLS client certificates
653
          secretName:
654
          # Directory to mount certificates (defaults to /etc/nats-certs/<context-name>)
655
          dir:
656
          # Certificate file name in secret
657
          cert: tls.crt
658
          # Private key file name in secret
659
660
          key: tls.key

661
662
        # Advanced context configuration
        # For options see: https://docs.nats.io/using-nats/nats-tools/nats_cli#nats-contexts
663
664
665
        merge: {}
        patch: []

666
    # Name of context to select by default for NATS CLI operations
667
668
669
    defaultContextName: default

    ############################################################
670
    # NATS Box container configuration
671
672
    ############################################################
    container:
673
      # NATS Box container image
674
      image:
675
        # Official NATS Box repository with CLI tools
676
        repository: natsio/nats-box
677
        # NATS Box version
678
        tag: 0.14.5
679
        # Image pull policy (leave empty for chart default)
680
        pullPolicy:
681
        # Custom registry URL (leave empty for Docker Hub)
682
683
        registry:

684
      # Environment variables for NATS Box container
685
686
      env: {}

687
      # Advanced container configuration
688
689
690
      # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#container-v1-core
      merge: {}
      patch: []
691
692

    # Service Account for NATS Box deployment
693
    serviceAccount:
694
      # Whether to create and use a dedicated service account for NATS Box
695
      enabled: false
696

697
    # Pod template configuration for NATS Box deployment
698
699
700
    podTemplate:
      merge:
        spec:
701
          # Node tolerations for NATS Box pods
702
703
          tolerations: []
      patch: []