longhorn: upgrade from 1.9.0 to 1.12.0 (with intermediate releases)
Change-Id: Ice8f4e8f7e073023ab274c83154d9368525f9231
diff --git a/charts/longhorn/Chart.yaml b/charts/longhorn/Chart.yaml
index b7df667..24b2067 100644
--- a/charts/longhorn/Chart.yaml
+++ b/charts/longhorn/Chart.yaml
@@ -1,5 +1,5 @@
apiVersion: v1
-appVersion: v1.9.0
+appVersion: v1.12.0
description: Longhorn is a distributed block storage system for Kubernetes.
home: https://github.com/longhorn/longhorn
icon: https://raw.githubusercontent.com/cncf/artwork/master/projects/longhorn/icon/color/longhorn-icon-color.png
@@ -25,4 +25,4 @@
- https://github.com/longhorn/longhorn-ui
- https://github.com/longhorn/longhorn-tests
- https://github.com/longhorn/backing-image-manager
-version: 1.9.0
+version: 1.12.0
diff --git a/charts/longhorn/README.md b/charts/longhorn/README.md
index 786b952..7a377fd 100644
--- a/charts/longhorn/README.md
+++ b/charts/longhorn/README.md
@@ -79,7 +79,10 @@
| global.cattle.windowsCluster.enabled | bool | `false` | Setting that allows Longhorn to run on a Rancher Windows cluster. |
| global.cattle.windowsCluster.nodeSelector | object | `{"kubernetes.io/os":"linux"}` | Node selector for Linux nodes that can run user-deployed Longhorn components. |
| global.cattle.windowsCluster.tolerations | list | `[{"effect":"NoSchedule","key":"cattle.io/os","operator":"Equal","value":"linux"}]` | Toleration for Linux nodes that can run user-deployed Longhorn components. |
+| global.imagePullSecrets | list | `[]` | Global override for image pull secrets for container registry. |
+| global.imageRegistry | string | `""` | Global override for container image registry. |
| global.nodeSelector | object | `{}` | Node selector for nodes allowed to run user-deployed components such as Longhorn Manager, Longhorn UI, and Longhorn Driver Deployer. |
+| global.timezone | string | `""` | Set container timezone (TZ env) for all Longhorn workloads. Leave empty to use container default. |
| global.tolerations | list | `[]` | Toleration for nodes allowed to run user-deployed components such as Longhorn Manager, Longhorn UI, and Longhorn Driver Deployer. |
### Network Policies
@@ -93,34 +96,48 @@
| Key | Type | Default | Description |
|-----|------|---------|-------------|
+| image.csi.attacher.registry | string | `""` | Registry for the CSI attacher image. When unspecified, Longhorn uses the default value. |
| image.csi.attacher.repository | string | `"longhornio/csi-attacher"` | Repository for the CSI attacher image. When unspecified, Longhorn uses the default value. |
-| image.csi.attacher.tag | string | `"v4.8.1"` | Tag for the CSI attacher image. When unspecified, Longhorn uses the default value. |
+| image.csi.attacher.tag | string | `"v4.12.0"` | Tag for the CSI attacher image. When unspecified, Longhorn uses the default value. |
+| image.csi.livenessProbe.registry | string | `""` | Registry for the CSI liveness probe image. When unspecified, Longhorn uses the default value. |
| image.csi.livenessProbe.repository | string | `"longhornio/livenessprobe"` | Repository for the CSI liveness probe image. When unspecified, Longhorn uses the default value. |
-| image.csi.livenessProbe.tag | string | `"v2.15.0"` | Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value. |
+| image.csi.livenessProbe.tag | string | `"v2.19.0"` | Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value. |
+| image.csi.nodeDriverRegistrar.registry | string | `""` | Registry for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. |
| image.csi.nodeDriverRegistrar.repository | string | `"longhornio/csi-node-driver-registrar"` | Repository for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. |
-| image.csi.nodeDriverRegistrar.tag | string | `"v2.13.0"` | Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. |
+| image.csi.nodeDriverRegistrar.tag | string | `"v2.17.0"` | Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. |
+| image.csi.provisioner.registry | string | `""` | Registry for the CSI Provisioner image. When unspecified, Longhorn uses the default value. |
| image.csi.provisioner.repository | string | `"longhornio/csi-provisioner"` | Repository for the CSI Provisioner image. When unspecified, Longhorn uses the default value. |
-| image.csi.provisioner.tag | string | `"v5.2.0"` | Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value. |
+| image.csi.provisioner.tag | string | `"v5.3.0-20260514"` | Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value. |
+| image.csi.resizer.registry | string | `""` | Registry for the CSI Resizer image. When unspecified, Longhorn uses the default value. |
| image.csi.resizer.repository | string | `"longhornio/csi-resizer"` | Repository for the CSI Resizer image. When unspecified, Longhorn uses the default value. |
-| image.csi.resizer.tag | string | `"v1.13.2"` | Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value. |
+| image.csi.resizer.tag | string | `"v2.1.0-20260514"` | Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value. |
+| image.csi.snapshotter.registry | string | `""` | Registry for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. |
| image.csi.snapshotter.repository | string | `"longhornio/csi-snapshotter"` | Repository for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. |
-| image.csi.snapshotter.tag | string | `"v8.2.0"` | Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. |
+| image.csi.snapshotter.tag | string | `"v8.5.0-20260514"` | Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. |
+| image.longhorn.backingImageManager.registry | string | `""` | Registry for the Backing Image Manager image. When unspecified, Longhorn uses the default value. |
| image.longhorn.backingImageManager.repository | string | `"longhornio/backing-image-manager"` | Repository for the Backing Image Manager image. When unspecified, Longhorn uses the default value. |
-| image.longhorn.backingImageManager.tag | string | `"v1.9.0"` | Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value. |
+| image.longhorn.backingImageManager.tag | string | `"v1.12.0"` | Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value. |
+| image.longhorn.engine.registry | string | `""` | Registry for the Longhorn Engine image. |
| image.longhorn.engine.repository | string | `"longhornio/longhorn-engine"` | Repository for the Longhorn Engine image. |
-| image.longhorn.engine.tag | string | `"v1.9.0"` | Tag for the Longhorn Engine image. |
+| image.longhorn.engine.tag | string | `"v1.12.0"` | Tag for the Longhorn Engine image. |
+| image.longhorn.instanceManager.registry | string | `""` | Registry for the Longhorn Instance Manager image. |
| image.longhorn.instanceManager.repository | string | `"longhornio/longhorn-instance-manager"` | Repository for the Longhorn Instance Manager image. |
-| image.longhorn.instanceManager.tag | string | `"v1.9.0"` | Tag for the Longhorn Instance Manager image. |
+| image.longhorn.instanceManager.tag | string | `"v1.12.0"` | Tag for the Longhorn Instance Manager image. |
+| image.longhorn.manager.registry | string | `""` | Registry for the Longhorn Manager image. |
| image.longhorn.manager.repository | string | `"longhornio/longhorn-manager"` | Repository for the Longhorn Manager image. |
-| image.longhorn.manager.tag | string | `"v1.9.0"` | Tag for the Longhorn Manager image. |
+| image.longhorn.manager.tag | string | `"v1.12.0"` | Tag for the Longhorn Manager image. |
+| image.longhorn.shareManager.registry | string | `""` | Registry for the Longhorn Share Manager image. |
| image.longhorn.shareManager.repository | string | `"longhornio/longhorn-share-manager"` | Repository for the Longhorn Share Manager image. |
-| image.longhorn.shareManager.tag | string | `"v1.9.0"` | Tag for the Longhorn Share Manager image. |
+| image.longhorn.shareManager.tag | string | `"v1.12.0"` | Tag for the Longhorn Share Manager image. |
+| image.longhorn.supportBundleKit.registry | string | `""` | Registry for the Longhorn Support Bundle Manager image. |
| image.longhorn.supportBundleKit.repository | string | `"longhornio/support-bundle-kit"` | Repository for the Longhorn Support Bundle Manager image. |
-| image.longhorn.supportBundleKit.tag | string | `"v0.0.55"` | Tag for the Longhorn Support Bundle Manager image. |
+| image.longhorn.supportBundleKit.tag | string | `"v0.0.86"` | Tag for the Longhorn Support Bundle Manager image. |
+| image.longhorn.ui.registry | string | `""` | Registry for the Longhorn UI image. |
| image.longhorn.ui.repository | string | `"longhornio/longhorn-ui"` | Repository for the Longhorn UI image. |
-| image.longhorn.ui.tag | string | `"v1.9.0"` | Tag for the Longhorn UI image. |
+| image.longhorn.ui.tag | string | `"v1.12.0"` | Tag for the Longhorn UI image. |
+| image.openshift.oauthProxy.registry | string | `""` | Registry for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users. |
| image.openshift.oauthProxy.repository | string | `""` | Repository for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users. |
-| image.openshift.oauthProxy.tag | string | `""` | Tag for the OAuth Proxy image. Specify OCP/OKD version 4.1 or later (including version 4.15, which is available at quay.io/openshift/origin-oauth-proxy:4.15). This setting applies only to OpenShift users. |
+| image.openshift.oauthProxy.tag | string | `""` | Tag for the OAuth Proxy image. Specify OCP/OKD version 4.1 or later (including version 4.18, which is available at quay.io/openshift/origin-oauth-proxy:4.18). This setting applies only to OpenShift users. |
| image.pullPolicy | string | `"IfNotPresent"` | Image pull policy that applies to all user-deployed Longhorn components, such as Longhorn Manager, Longhorn driver, and Longhorn UI. |
### Service Settings
@@ -129,6 +146,9 @@
|-----|-------------|
| service.manager.nodePort | NodePort port number for Longhorn Manager. When unspecified, Longhorn selects a free port between 30000 and 32767. |
| service.manager.type | Service type for Longhorn Manager. |
+| service.ui.annotations | Annotation for the Longhorn UI service. |
+| service.ui.labels | |
+| service.ui.loadBalancerClass | Class of a load balancer implementation |
| service.ui.nodePort | NodePort port number for Longhorn UI. When unspecified, Longhorn selects a free port between 30000 and 32767. |
| service.ui.type | Service type for Longhorn UI. (Options: "ClusterIP", "NodePort", "LoadBalancer", "Rancher-Proxy") |
@@ -136,12 +156,14 @@
| Key | Type | Default | Description |
|-----|------|---------|-------------|
+| persistence.annotations | object | `{}` | Setting that allows to set the annotations of the default Longhorn StorageClass. |
| persistence.backingImage.dataSourceParameters | string | `nil` | Data source parameters of a backing image used in a Longhorn StorageClass. You can specify a JSON string of a map. (Example: `'{\"url\":\"https://backing-image-example.s3-region.amazonaws.com/test-backing-image\"}'`) |
| persistence.backingImage.dataSourceType | string | `nil` | Data source type of a backing image used in a Longhorn StorageClass. If the backing image exists in the cluster, Longhorn uses this setting to verify the image. If the backing image does not exist, Longhorn creates one using the specified data source type. |
| persistence.backingImage.enable | bool | `false` | Setting that allows you to use a backing image in a Longhorn StorageClass. |
| persistence.backingImage.expectedChecksum | string | `nil` | Expected SHA-512 checksum of a backing image used in a Longhorn StorageClass. |
| persistence.backingImage.name | string | `nil` | Backing image to be used for creating and restoring volumes in a Longhorn StorageClass. When no backing images are available, specify the data source type and parameters that Longhorn can use to create a backing image. |
| persistence.backupTargetName | string | `"default"` | Setting that allows you to specify the backup target for the default Longhorn StorageClass. |
+| persistence.createStorageClass | bool | `true` | Setting that allows you to create the default Longhorn StorageClass ConfigMap. Set to false to skip StorageClass creation. |
| persistence.dataEngine | string | `"v1"` | Setting that allows you to specify the data engine version for the default Longhorn StorageClass. (Options: "v1", "v2") |
| persistence.defaultClass | bool | `true` | Setting that allows you to specify the default Longhorn StorageClass. |
| persistence.defaultClassReplicaCount | int | `3` | Replica count of the default Longhorn StorageClass. |
@@ -158,7 +180,11 @@
| persistence.reclaimPolicy | string | `"Delete"` | Reclaim policy that provides instructions for handling of a volume after its claim is released. (Options: "Retain", "Delete") |
| persistence.recurringJobSelector.enable | bool | `false` | Setting that allows you to enable the recurring job selector for a Longhorn StorageClass. |
| persistence.recurringJobSelector.jobList | list | `[]` | Recurring job selector for a Longhorn StorageClass. Ensure that quotes are used correctly when specifying job parameters. (Example: `[{"name":"backup", "isGroup":true}]`) |
-| persistence.removeSnapshotsDuringFilesystemTrim | string | `"ignored"` | Setting that allows you to enable automatic snapshot removal during filesystem trim for a Longhorn StorageClass. (Options: "ignored", "enabled", "disabled") |
+| persistence.shareManagerNodeSelector.enable | bool | `false` | Setting that allows you to enable the share manager node selector for the default Longhorn StorageClass. |
+| persistence.shareManagerNodeSelector.selector | string | `""` | Node selector for the share manager pods of the default Longhorn StorageClass. Longhorn schedules share manager pods only on nodes with the specified tags. (Examples: "storage,fast") |
+| persistence.shareManagerTolerations.enable | bool | `false` | Setting that allows you to enable the share manager tolerations for the default Longhorn StorageClass. |
+| persistence.shareManagerTolerations.tolerations | string | `""` | Tolerations for the share manager pods of the default Longhorn StorageClass. Specify values using a semicolon-separated list in `kubectl taint` syntax. (Example: "key1=value1:effect; key2=value2:effect") |
+| persistence.unmapMarkSnapChainRemoved | string | `"ignored"` | Setting that allows you to enable automatic snapshot removal during filesystem trim for a Longhorn StorageClass. (Options: "ignored", "enabled", "disabled") |
| persistence.volumeBindingMode | string | `"Immediate"` | VolumeBindingMode controls when volume binding and dynamic provisioning should occur. (Options: "Immediate", "WaitForFirstConsumer") (Defaults to "Immediate") |
### CSI Settings
@@ -167,6 +193,7 @@
|-----|-------------|
| csi.attacherReplicaCount | Replica count of the CSI Attacher. When unspecified, Longhorn uses the default value ("3"). |
| csi.kubeletRootDir | kubelet root directory. When unspecified, Longhorn uses the default value. |
+| csi.podAntiAffinityPreset | Configures Pod anti-affinity to prevent multiple instances on the same node. Use soft (tries to separate) or hard (must separate). When unspecified, Longhorn uses the default value ("soft"). |
| csi.provisionerReplicaCount | Replica count of the CSI Provisioner. When unspecified, Longhorn uses the default value ("3"). |
| csi.resizerReplicaCount | Replica count of the CSI Resizer. When unspecified, Longhorn uses the default value ("3"). |
| csi.snapshotterReplicaCount | Replica count of the CSI Snapshotter. When unspecified, Longhorn uses the default value ("3"). |
@@ -177,11 +204,15 @@
| Key | Type | Default | Description |
|-----|------|---------|-------------|
+| longhornManager.distro | string | `"longhorn"` | Optional distro identifier used for upgrade responder reporting. |
| longhornManager.log.format | string | `"plain"` | Format of Longhorn Manager logs. (Options: "plain", "json") |
| longhornManager.nodeSelector | object | `{}` | Node selector for Longhorn Manager. Specify the nodes allowed to run Longhorn Manager. |
| longhornManager.priorityClass | string | `"longhorn-critical"` | PriorityClass for Longhorn Manager. |
+| longhornManager.resources | string | `nil` | Resource requests and limits for Longhorn Manager pods. |
| longhornManager.serviceAnnotations | object | `{}` | Annotation for the Longhorn Manager service. |
+| longhornManager.serviceLabels | object | `{}` | |
| longhornManager.tolerations | list | `[]` | Toleration for Longhorn Manager on nodes allowed to run Longhorn components. |
+| longhornManager.updateStrategy.rollingUpdate.maxUnavailable | string | `"100%"` | |
### Longhorn Driver Settings
@@ -210,8 +241,9 @@
| Key | Type | Default | Description |
|-----|------|---------|-------------|
-| ingress.annotations | string | `nil` | Ingress annotations in the form of key-value pairs. |
+| ingress.annotations | object | `{}` | Ingress annotations in the form of key-value pairs. |
| ingress.enabled | bool | `false` | Setting that allows Longhorn to generate ingress records for the Longhorn UI service. |
+| ingress.extraHosts | list | `[]` | Extra hostnames for TLS (Subject Alternative Names - SAN). Used when you need multiple FQDNs for the same ingress. Example: extraHosts: - longhorn.example.com - longhorn-ui.internal.local |
| ingress.host | string | `"sslip.io"` | Hostname of the Layer 7 load balancer. |
| ingress.ingressClassName | string | `nil` | IngressClass resource that contains ingress configuration, including the name of the Ingress controller. ingressClassName can replace the kubernetes.io/ingress.class annotation used in earlier Kubernetes releases. |
| ingress.path | string | `"/"` | Default ingress path. You can access the Longhorn UI by following the full ingress path {{host}}+{{path}}. |
@@ -221,15 +253,26 @@
| ingress.tls | bool | `false` | Setting that allows you to enable TLS on ingress records. |
| ingress.tlsSecret | string | `"longhorn.local-tls"` | TLS secret that contains the private key and certificate to be used for TLS. This setting applies only when TLS is enabled on ingress records. |
+### HTTPRoute Settings
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| httproute.annotations | object | `{}` | Annotations for the HTTPRoute resource in the form of key-value pairs. |
+| httproute.enabled | bool | `false` | Setting that allows Longhorn to generate HTTPRoute records for the Longhorn UI service using Gateway API. |
+| httproute.hostnames | list | `[]` | List of hostnames for the HTTPRoute. Multiple hostnames are supported. |
+| httproute.parentRefs | list | `[]` | Gateway references for HTTPRoute. Specify which Gateway(s) should handle this route. |
+| httproute.path | string | `"/"` | Default path for HTTPRoute. You can access the Longhorn UI by following the full path. |
+| httproute.pathType | string | `"PathPrefix"` | Path match type for HTTPRoute. (Options: "Exact", "PathPrefix") |
+
### Private Registry Settings
You can install Longhorn in an air-gapped environment with a private registry. For more information, see the **Air Gap Installation** section of the [documentation](https://longhorn.io/docs).
| Key | Description |
|-----|-------------|
-| privateRegistry.createSecret | Setting that allows you to create a private registry secret. |
+| privateRegistry.createSecret | Set to `true` to automatically create a new private registry secret. |
| privateRegistry.registryPasswd | Password for authenticating with a private registry. |
-| privateRegistry.registrySecret | Kubernetes secret that allows you to pull images from a private registry. This setting applies only when creation of private registry secrets is enabled. You must include the private registry name in the secret name. |
+| privateRegistry.registrySecret | If create a new private registry secret is true, create a Kubernetes secret with this name; else use the existing secret of this name. Use it to pull images from your private registry. |
| privateRegistry.registryUrl | URL of a private registry. When unspecified, Longhorn uses the default system registry. |
| privateRegistry.registryUser | User account used for authenticating with a private registry. |
@@ -243,6 +286,7 @@
| metrics.serviceMonitor.interval | string | `""` | Interval at which Prometheus scrapes the metrics from the target. |
| metrics.serviceMonitor.metricRelabelings | list | `[]` | Configures the relabeling rules to apply to the samples before ingestion. See the [Prometheus Operator documentation](https://prometheus-operator.dev/docs/api-reference/api/#monitoring.coreos.com/v1.Endpoint) for formatting details. |
| metrics.serviceMonitor.relabelings | list | `[]` | Configures the relabeling rules to apply the target’s metadata labels. See the [Prometheus Operator documentation](https://prometheus-operator.dev/docs/api-reference/api/#monitoring.coreos.com/v1.Endpoint) for formatting details. |
+| metrics.serviceMonitor.sampleLimit | int | `0` | Per-scrape sample limit. A value of 0 (default) omits sampleLimit. |
| metrics.serviceMonitor.scrapeTimeout | string | `""` | Timeout after which Prometheus considers the scrape to be failed. |
### OS/Kubernetes Distro Settings
@@ -296,33 +340,54 @@
| defaultSettings.backupCompressionMethod | Setting that allows you to specify a backup compression method. |
| defaultSettings.backupConcurrentLimit | Maximum number of worker threads that can concurrently run for each backup. |
| defaultSettings.backupExecutionTimeout | Number of minutes that Longhorn allows for the backup execution. The default value is "1". |
+| defaultSettings.blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly | Blacklist of controller api/kind values for the setting Automatically Delete Workload Pod when the Volume Is Detached Unexpectedly. If a workload pod is managed by a controller whose api/kind is listed in this blacklist, Longhorn will not automatically delete the pod when its volume is unexpectedly detached. Multiple controller api/kind entries can be specified, separated by semicolons. For example: `apps/StatefulSet;apps/DaemonSet`. Note that the controller api/kind is case sensitive and must exactly match the api/kind in the workload pod's owner reference. |
| defaultSettings.concurrentAutomaticEngineUpgradePerNodeLimit | Maximum number of engines that are allowed to concurrently upgrade on each node after Longhorn Manager is upgraded. When the value is "0", Longhorn does not automatically upgrade volume engines to the new default engine image version. |
| defaultSettings.concurrentReplicaRebuildPerNodeLimit | Maximum number of replicas that can be concurrently rebuilt on each node. |
| defaultSettings.concurrentVolumeBackupRestorePerNodeLimit | Maximum number of volumes that can be concurrently restored on each node using a backup. When the value is "0", restoration of volumes using a backup is disabled. |
| defaultSettings.createDefaultDiskLabeledNodes | Setting that allows Longhorn to automatically create a default disk only on nodes with the label "node.longhorn.io/create-default-disk=true" (if no other disks exist). When this setting is disabled, Longhorn creates a default disk on each node that is added to the cluster. |
+| defaultSettings.csiAllowedTopologyKeys | Comma-separated list of topology keys that the Longhorn CSI driver is allowed to pass through. When empty (default), no topology keys are passed through, and PVs will have no nodeAffinity. When configured (e.g., "topology.kubernetes.io/zone,topology.kubernetes.io/region"), only the specified keys are kept in topology segments. All other keys are filtered out from both CreateVolumeResponse.AccessibleTopology and NodeGetInfo topology. |
+| defaultSettings.csiStorageCapacityTracking | Setting that controls CSI storage capacity tracking, which allows the kube-scheduler to filter nodes that cannot fit the requested volume. |
+| defaultSettings.dataEngineCPUMask | Applies only to the V2 Data Engine. Specifies the CPU cores on which the Storage Performance Development Kit (SPDK) target daemon runs. The daemon is deployed in each Instance Manager pod. Ensure that the assigned CPU cores do not exceed the guaranteed CPUs allocated to the V2 Data Engine Instance Manager. A minimum of 2 CPU cores is recommended. SPDK uses a busy-polling reactor model where the master reactor handles both I/O polling and management RPCs. When only a single core is assigned, heavy I/O workloads can delay or starve RPC processing, resulting in increased latency, timeout events, and operational instability. Assigning 2 or more cores allows I/O and management tasks to run on separate reactors, improving responsiveness and operational stability. Accepts either hexadecimal CPU masks (for example, 0x3 or 0xff) or CPU list format (for example, 0-1,2,5). CPU lists are automatically converted to hexadecimal masks. The default value is 0x3. |
+| defaultSettings.dataEngineHugepageEnabled | Applies only to the V2 Data Engine. Enables hugepages for the Storage Performance Development Kit (SPDK) target daemon. If disabled, legacy memory is used. Allocation size is set via the Data Engine Memory Size setting. |
+| defaultSettings.dataEngineLogFlags | Applies only to the V2 Data Engine. Specifies the log flags for the Storage Performance Development Kit (SPDK) target daemon. |
+| defaultSettings.dataEngineLogLevel | Applies only to the V2 Data Engine. Specifies the log level for the Storage Performance Development Kit (SPDK) target daemon. Supported values are: Error, Warning, Notice, Info, and Debug. The default is Notice. |
+| defaultSettings.dataEngineMemorySize | Applies only to the V2 Data Engine. Specifies the hugepage size, in MiB, for the Storage Performance Development Kit (SPDK) target daemon. The default value is "{"v2":"2048"}" |
+| defaultSettings.defaultBackupBlockSize | Specifies the default backup block size, in MiB, used when creating a new volume. Supported values are 2 or 16. |
| defaultSettings.defaultDataLocality | Default data locality. A Longhorn volume has data locality if a local replica of the volume exists on the same node as the pod that is using the volume. |
-| defaultSettings.defaultDataPath | Default path for storing data on a host. The default value is "/var/lib/longhorn/". |
+| defaultSettings.defaultDataPath | Default path to use for storing data on a host. An absolute directory path indicates a filesystem-type disk used by the V1 Data Engine, while a path to a block device indicates a block-type disk used by the V2 Data Engine. The default value is "/var/lib/longhorn/". |
| defaultSettings.defaultLonghornStaticStorageClass | Default name of Longhorn static StorageClass. "storageClassName" is assigned to PVs and PVCs that are created for an existing Longhorn volume. "storageClassName" can also be used as a label, so it is possible to use a Longhorn StorageClass to bind a workload to an existing PV without creating a Kubernetes StorageClass object. "storageClassName" needs to be an existing StorageClass. The default value is "longhorn-static". |
-| defaultSettings.defaultReplicaCount | Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass. The default value is "3". |
+| defaultSettings.defaultReplicaCount | Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass. The default value is "{"v1":"3","v2":"3"}". |
+| defaultSettings.defaultUblkNumberOfQueue | This setting specifies the default the number of queues for ublk frontend. This setting applies to volumes using the V2 Data Engine with Ublk front end. Individual volumes can override this setting by specifying their own number of queues for ublk. |
+| defaultSettings.defaultUblkQueueDepth | This setting specifies the default depth of each queue for Ublk frontend. This setting applies to volumes using the V2 Data Engine with Ublk front end. Individual volumes can override this setting by specifying their own Ublk queue depth. |
| defaultSettings.deletingConfirmationFlag | Flag that prevents accidental uninstallation of Longhorn. |
| defaultSettings.detachManuallyAttachedVolumesWhenCordoned | Setting that allows automatic detaching of manually-attached volumes when a node is cordoned. |
| defaultSettings.disableRevisionCounter | Setting that disables the revision counter and thereby prevents Longhorn from tracking all write operations to a volume. When salvaging a volume, Longhorn uses properties of the "volume-head-xxx.img" file (the last file size and the last time the file was modified) to select the replica to be used for volume recovery. This setting applies only to volumes created using the Longhorn UI. |
| defaultSettings.disableSchedulingOnCordonedNode | Setting that prevents Longhorn Manager from scheduling replicas on a cordoned Kubernetes node. This setting is enabled by default. |
| defaultSettings.disableSnapshotPurge | Setting that temporarily prevents all attempts to purge volume snapshots. |
+| defaultSettings.endpointNetworkForRWXVolume | Specifies a dedicated network for mounting RWX (ReadWriteMany) volumes. Leave this blank to use the default Kubernetes cluster network. **Caution**: This setting should change after all RWX volumes are detached because some Longhorn component pods must be recreated to apply the setting. You cannot modify this setting while RWX volumes are still attached. |
+| defaultSettings.engineImagePodLivenessProbeFailureThreshold | The setting specifies the number of consecutive failed liveness probes before an engine image pod is restarted. The default value is 3. |
+| defaultSettings.engineImagePodLivenessProbePeriod | In seconds. The setting specifies the interval between liveness probes for engine image pods. The default value is 5 seconds. |
+| defaultSettings.engineImagePodLivenessProbeTimeout | In seconds. The setting specifies the timeout for the engine image pod liveness probe. The default value is 4 seconds. |
| defaultSettings.engineReplicaTimeout | Timeout between the Longhorn Engine and replicas. Specify a value between "8" and "30" seconds. The default value is "8". |
| defaultSettings.failedBackupTTL | Number of minutes that Longhorn keeps a failed backup resource. When the value is "0", automatic deletion is disabled. |
| defaultSettings.fastReplicaRebuildEnabled | Setting that allows fast rebuilding of replicas using the checksum of snapshot disk files. Before enabling this setting, you must set the snapshot-data-integrity value to "enable" or "fast-check". |
| defaultSettings.freezeFilesystemForSnapshot | Setting that freezes the filesystem on the root partition before a snapshot is created. |
-| defaultSettings.guaranteedInstanceManagerCPU | Percentage of the total allocatable CPU resources on each node to be reserved for each instance manager pod when the V1 Data Engine is enabled. The default value is "12". |
+| defaultSettings.guaranteedInstanceManagerCPU | Percentage of the total allocatable CPU resources on each node to be reserved for each instance manager pod. The default value is {"v1":"12","v2":"12"}. |
+| defaultSettings.instanceManagerPodLivenessProbeTimeout | In seconds. The setting specifies the timeout for the instance manager pod liveness probe. The default value is 10 seconds. |
| defaultSettings.kubernetesClusterAutoscalerEnabled | Setting that notifies Longhorn that the cluster is using the Kubernetes Cluster Autoscaler. |
+| defaultSettings.kubernetesMetricsServerMetricsEnabled | Setting that allows Longhorn to query the Kubernetes Metrics Server ('metrics.k8s.io') for pod and node resource usage. |
| defaultSettings.logLevel | Log levels that indicate the type and severity of logs in Longhorn Manager. The default value is "Info". (Options: "Panic", "Fatal", "Error", "Warn", "Info", "Debug", "Trace") |
+| defaultSettings.logPath | Specifies the directory on the host where Longhorn stores log files for the instance manager pod. Currently, it is only used for instance manager pods in the v2 data engine. |
| defaultSettings.longGRPCTimeOut | Number of seconds that Longhorn allows for the completion of replica rebuilding and snapshot cloning operations. |
+| defaultSettings.managerUrl | URL prefix embedded in Longhorn Manager API response links (the "actions" and "links" fields). When set, internal components such as longhorn-driver-deployer and longhorn-csi-plugin will follow links using this URL, so it must be reachable from within the cluster without authentication. Setting this to an externally-facing URL that is protected by auth middleware (e.g. OAuth2 proxy, ingress auth) will cause internal components to receive an HTML redirect instead of JSON, resulting in "invalid character '<'" errors and CSI driver deployment failure. Use this setting only when the URL is accessible unauthenticated from inside the cluster. Format: scheme://host[:port] (for example, http://longhorn.example.com). Leave empty to use the default behavior (internal pod IP). Note: this value is persisted in the manager-url Setting CR; removing it from Helm values does not automatically clear the CR. To reset, manually set the manager-url Setting CR value to empty via the Longhorn UI or kubectl. |
+| defaultSettings.nodeDiskHealthMonitoring | Controls whether Longhorn monitors and records health information for node disks. When disabled, disk health checks and status updates are skipped. |
| defaultSettings.nodeDownPodDeletionPolicy | Policy that defines the action Longhorn takes when a volume is stuck with a StatefulSet or Deployment pod on a node that failed. |
| defaultSettings.nodeDrainPolicy | Policy that defines the action Longhorn takes when a node with the last healthy replica of a volume is drained. |
-| defaultSettings.offlineRelicaRebuilding | Enables automatic rebuilding of degraded replicas while the volume is detached. This setting only takes effect if the individual volume setting is set to `ignored` or `enabled`. |
-| defaultSettings.orphanResourceAutoDeletion | Enables Longhorn to automatically delete orphaned resources and their associated data or processes (e.g., stale replicas). Orphaned resources on failed or unknown nodes are not automatically cleaned up. You need to specify the resource types to be deleted using a semicolon-separated list (e.g., `replica-data;instance`). Available items are: `replica-data`, `instance`. |
+| defaultSettings.offlineReplicaRebuilding | Enables automatic rebuilding of degraded replicas while the volume is detached. This setting only takes effect if the individual volume setting is set to `ignored` or `enabled`. |
+| defaultSettings.orphanResourceAutoDeletion | Enables Longhorn to automatically delete orphaned resources and their associated data or processes (e.g., stale replicas). Orphaned resources on failed or unknown nodes are not automatically cleaned up. You need to specify the resource types to be deleted using a semicolon-separated list (e.g., `replica-data;instance`). Available items are: `replica-data`, `instance`. |
| defaultSettings.orphanResourceAutoDeletionGracePeriod | Specifies the wait time, in seconds, before Longhorn automatically deletes an orphaned Custom Resource (CR) and its associated resources. Note that if a user manually deletes an orphaned CR, the deletion occurs immediately and does not respect this grace period. |
| defaultSettings.priorityClass | PriorityClass for system-managed Longhorn components. This setting can help prevent Longhorn components from being evicted under Node Pressure. Notice that this will be applied to Longhorn user-deployed components by default if there are no priority class values set yet, such as `longhornManager.priorityClass`. |
+| defaultSettings.rebuildConcurrentSyncLimit | Maximum number of file synchronization operations that can run concurrently during a single replica rebuild. Right now, it's for v1 data engine only. |
| defaultSettings.recurringFailedJobsHistoryLimit | Maximum number of failed recurring backup and snapshot jobs to be retained. When the value is "0", a history of failed recurring jobs is not retained. |
| defaultSettings.recurringJobMaxRetention | Maximum number of snapshots or backups to be retained. |
| defaultSettings.recurringSuccessfulJobsHistoryLimit | Maximum number of successful recurring backup and snapshot jobs to be retained. When the value is "0", a history of successful recurring jobs is not retained. |
@@ -330,21 +395,25 @@
| defaultSettings.replicaAutoBalance | Setting that automatically rebalances replicas when an available node is discovered. |
| defaultSettings.replicaDiskSoftAntiAffinity | Setting that allows scheduling on disks with existing healthy replicas of the same volume. This setting is enabled by default. |
| defaultSettings.replicaFileSyncHttpClientTimeout | Number of seconds that an HTTP client waits for a response from a File Sync server before considering the connection to have failed. |
+| defaultSettings.replicaRebuildingBandwidthLimit | This setting specifies the default write bandwidth limit (in megabytes per second) for volume replica rebuilding when using the v2 data engine (SPDK). If this value is set to 0, there will be no write bandwidth limitation. Individual volumes can override this setting by specifying their own rebuilding bandwidth limit. |
| defaultSettings.replicaReplenishmentWaitInterval | Number of seconds that Longhorn waits before reusing existing data on a failed replica instead of creating a new replica of a degraded volume. |
| defaultSettings.replicaSoftAntiAffinity | Setting that allows scheduling on nodes with healthy replicas of the same volume. This setting is disabled by default. |
| defaultSettings.replicaZoneSoftAntiAffinity | Setting that allows Longhorn to schedule new replicas of a volume to nodes in the same zone as existing healthy replicas. Nodes that do not belong to any zone are treated as existing in the zone that contains healthy replicas. When identifying zones, Longhorn relies on the label "topology.kubernetes.io/zone=<Zone name of the node>" in the Kubernetes node object. |
| defaultSettings.restoreConcurrentLimit | Maximum number of worker threads that can concurrently run for each restore operation. |
| defaultSettings.restoreVolumeRecurringJobs | Setting that restores recurring jobs from a backup volume on a backup target and creates recurring jobs if none exist during backup restoration. |
| defaultSettings.rwxVolumeFastFailover | Setting that allows Longhorn to detect node failure and immediately migrate affected RWX volumes. |
+| defaultSettings.snapshotCountWarningThreshold | Warning threshold for the count-based TooManySnapshots volume condition. The value should be between 2 to 250. Default is 100. |
| defaultSettings.snapshotDataIntegrity | Setting that allows you to enable and disable snapshot hashing and data integrity checks. |
| defaultSettings.snapshotDataIntegrityCronjob | Setting that defines when Longhorn checks the integrity of data in snapshot disk files. You must use the Unix cron expression format. |
| defaultSettings.snapshotDataIntegrityImmediateCheckAfterSnapshotCreation | Setting that allows disabling of snapshot hashing after snapshot creation to minimize impact on system performance. |
+| defaultSettings.snapshotHeavyTaskConcurrentLimit | Setting that controls how many snapshot heavy task operations (such as purge and clone) can run concurrently per node. This is a best-effort mechanism: due to the distributed nature of the system, temporary oversubscription may occur. The limiter reduces worst-case overload but does not guarantee perfect enforcement. |
| defaultSettings.snapshotMaxCount | Maximum snapshot count for a volume. The value should be between 2 to 250 |
| defaultSettings.storageMinimalAvailablePercentage | Percentage of minimum available disk capacity. When the minimum available capacity exceeds the total available capacity, the disk becomes unschedulable until more space is made available for use. The default value is "25". |
| defaultSettings.storageNetwork | Storage network for in-cluster traffic. When unspecified, Longhorn uses the Kubernetes cluster network. |
| defaultSettings.storageOverProvisioningPercentage | Percentage of storage that can be allocated relative to hard drive capacity. The default value is "100". |
| defaultSettings.storageReservedPercentageForDefaultDisk | Percentage of disk space that is not allocated to the default disk on each new Longhorn node. |
| defaultSettings.supportBundleFailedHistoryLimit | Maximum number of failed support bundles that can exist in the cluster. When the value is "0", Longhorn automatically purges all failed support bundles. |
+| defaultSettings.systemManagedCSIComponentsResourceLimits | Resource limits for system-managed CSI components. This setting allows you to configure CPU and memory requests/limits for CSI attacher, provisioner, resizer, snapshotter, and plugin components. Supported components: csi-attacher, csi-provisioner, csi-resizer, csi-snapshotter, longhorn-csi-plugin, node-driver-registrar, longhorn-liveness-probe. Notice that changing resource limits will cause CSI components to restart, which may temporarily affect volume provisioning and attach/detach operations until the components are ready. The value should be a JSON object with component names as keys and ResourceRequirements as values. |
| defaultSettings.systemManagedComponentsNodeSelector | Node selector for system-managed Longhorn components. |
| defaultSettings.systemManagedPodsImagePullPolicy | Image pull policy for system-managed pods, such as Instance Manager, engine images, and CSI Driver. Changes to the image pull policy are applied only after the system-managed pods restart. |
| defaultSettings.taintToleration | Taint or toleration for system-managed Longhorn components. Specify values using a semicolon-separated list in `kubectl taint` syntax (Example: key1=value1:effect; key2=value2:effect). |
@@ -352,12 +421,6 @@
| defaultSettings.upgradeResponderURL | The Upgrade Responder sends a notification whenever a new Longhorn version that you can upgrade to becomes available. The default value is https://longhorn-upgrade-responder.rancher.io/v1/checkupgrade. |
| defaultSettings.v1DataEngine | Setting that allows you to enable the V1 Data Engine. |
| defaultSettings.v2DataEngine | Setting that allows you to enable the V2 Data Engine, which is based on the Storage Performance Development Kit (SPDK). The V2 Data Engine is an experimental feature and should not be used in production environments. |
-| defaultSettings.v2DataEngineCPUMask | CPU cores on which the Storage Performance Development Kit (SPDK) target daemon should run. The SPDK target daemon is located in each Instance Manager pod. Ensure that the number of cores is less than or equal to the guaranteed Instance Manager CPUs for the V2 Data Engine. The default value is "0x1". |
-| defaultSettings.v2DataEngineGuaranteedInstanceManagerCPU | Number of millicpus on each node to be reserved for each Instance Manager pod when the V2 Data Engine is enabled. The default value is "1250". |
-| defaultSettings.v2DataEngineHugepageLimit | Setting that allows you to configure maximum huge page size (in MiB) for the V2 Data Engine. |
-| defaultSettings.v2DataEngineLogFlags | Setting that allows you to configure the log flags of the SPDK target daemon (spdk_tgt) of the V2 Data Engine. |
-| defaultSettings.v2DataEngineLogLevel | Setting that allows you to configure the log level of the SPDK target daemon (spdk_tgt) of the V2 Data Engine. |
-| defaultSettings.v2DataEngineSnapshotDataIntegrity | Setting allows you to enable or disable snapshot hashing and data integrity checking for the V2 Data Engine. |
---
Please see [link](https://github.com/longhorn/longhorn) for more information.
diff --git a/charts/longhorn/README.md.gotmpl b/charts/longhorn/README.md.gotmpl
index 5368786..bafbe8c 100644
--- a/charts/longhorn/README.md.gotmpl
+++ b/charts/longhorn/README.md.gotmpl
@@ -175,6 +175,16 @@
{{- end }}
{{- end }}
+### HTTPRoute Settings
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+{{- range .Values }}
+ {{- if hasPrefix "httproute" .Key }}
+| {{ .Key }} | {{ .Type }} | {{ if .Default }}{{ .Default }}{{ else }}{{ .AutoDefault }}{{ end }} | {{ if .Description }}{{ .Description }}{{ else }}{{ .AutoDescription }}{{ end }} |
+ {{- end }}
+{{- end }}
+
### Private Registry Settings
You can install Longhorn in an air-gapped environment with a private registry. For more information, see the **Air Gap Installation** section of the [documentation](https://longhorn.io/docs).
@@ -227,6 +237,7 @@
(hasPrefix "longhornUI" .Key)
(hasPrefix "privateRegistry" .Key)
(hasPrefix "ingress" .Key)
+ (hasPrefix "httproute" .Key)
(hasPrefix "metrics" .Key)
(hasPrefix "openshift" .Key)
(hasPrefix "global" .Key)) }}
diff --git a/charts/longhorn/ocp-readme.md b/charts/longhorn/ocp-readme.md
index d2fb98e..f009b80 100644
--- a/charts/longhorn/ocp-readme.md
+++ b/charts/longhorn/ocp-readme.md
@@ -142,10 +142,11 @@
Minimum Adjustments Required
```yaml
-openshift:
- oauthProxy:
- repository: quay.io/openshift/origin-oauth-proxy
- tag: 4.15 # Use Your OCP/OKD 4.X Version, Current Stable is 4.15
+image:
+ openshift:
+ oauthProxy:
+ repository: quay.io/openshift/origin-oauth-proxy
+ tag: 4.18 # Use Your OCP/OKD 4.X Version, Current Stable is 4.18
# defaultSettings: # Preparing nodes (Optional)
# createDefaultDiskLabeledNodes: true
diff --git a/charts/longhorn/questions.yaml b/charts/longhorn/questions.yaml
index 4f72324..5b2b661 100644
--- a/charts/longhorn/questions.yaml
+++ b/charts/longhorn/questions.yaml
@@ -17,7 +17,7 @@
label: Longhorn Manager Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.manager.tag
- default: v1.9.0
+ default: v1.12.0
description: Tag for the Longhorn Manager image.
type: string
label: Longhorn Manager Image Tag
@@ -29,7 +29,7 @@
label: Longhorn Engine Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.engine.tag
- default: v1.9.0
+ default: v1.12.0
description: Tag for the Longhorn Engine image.
type: string
label: Longhorn Engine Image Tag
@@ -41,7 +41,7 @@
label: Longhorn UI Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.ui.tag
- default: v1.9.0
+ default: v1.12.0
description: Tag for the Longhorn UI image.
type: string
label: Longhorn UI Image Tag
@@ -53,7 +53,7 @@
label: Longhorn Instance Manager Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.instanceManager.tag
- default: v1.9.0
+ default: v1.12.0
description: Tag for the Longhorn Instance Manager image.
type: string
label: Longhorn Instance Manager Image Tag
@@ -65,7 +65,7 @@
label: Longhorn Share Manager Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.shareManager.tag
- default: v1.9.0
+ default: v1.12.0
description: Tag for the Longhorn Share Manager image.
type: string
label: Longhorn Share Manager Image Tag
@@ -78,7 +78,7 @@
label: Longhorn Backing Image Manager Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.backingImageManager.tag
- default: v1.9.0
+ default: v1.12.0
description: >-
Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
type: string
@@ -91,7 +91,7 @@
label: Longhorn Support Bundle Kit Image Repository
group: Longhorn Images Settings
- variable: image.longhorn.supportBundleKit.tag
- default: v0.0.55
+ default: v0.0.86
description: Tag for the Longhorn Support Bundle Manager image.
type: string
label: Longhorn Support Bundle Kit Image Tag
@@ -104,7 +104,7 @@
label: Longhorn CSI Attacher Image Repository
group: Longhorn CSI Driver Images
- variable: image.csi.attacher.tag
- default: v4.8.1
+ default: v4.12.0
description: >-
Tag for the CSI attacher image. When unspecified, Longhorn uses the default value.
type: string
@@ -118,7 +118,7 @@
label: Longhorn CSI Provisioner Image Repository
group: Longhorn CSI Driver Images
- variable: image.csi.provisioner.tag
- default: v5.2.0
+ default: v5.3.0-20260514
description: >-
Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
type: string
@@ -132,7 +132,7 @@
label: Longhorn CSI Node Driver Registrar Image Repository
group: Longhorn CSI Driver Images
- variable: image.csi.nodeDriverRegistrar.tag
- default: v2.13.0
+ default: v2.17.0
description: >-
Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
type: string
@@ -146,7 +146,7 @@
label: Longhorn CSI Driver Resizer Image Repository
group: Longhorn CSI Driver Images
- variable: image.csi.resizer.tag
- default: v1.13.2
+ default: v2.1.0-20260514
description: >-
Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value.
type: string
@@ -160,7 +160,7 @@
label: Longhorn CSI Driver Snapshotter Image Repository
group: Longhorn CSI Driver Images
- variable: image.csi.snapshotter.tag
- default: v8.2.0
+ default: v8.5.0-20260514
description: >-
Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
type: string
@@ -174,7 +174,7 @@
label: Longhorn CSI Liveness Probe Image Repository
group: Longhorn CSI Driver Images
- variable: image.csi.livenessProbe.tag
- default: v2.15.0
+ default: v2.19.0
description: >-
Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
type: string
@@ -191,14 +191,14 @@
- variable: privateRegistry.registrySecret
label: Private registry secret name
description: >-
- Kubernetes secret that allows you to pull images from a private registry. This setting applies only when creation of private registry secrets is enabled. You must include the private registry name in the secret name.
+ If create a new private registry secret is true, create a Kubernetes secret with this name; else use the existing secret of this name. Use it to pull images from your private registry.
group: Private Registry Settings
type: string
default: ''
subquestions: []
- variable: privateRegistry.createSecret
default: 'true'
- description: Setting that allows you to create a private registry secret.
+ description: Set to true to automatically create a new private registry secret.
type: boolean
group: Private Registry Settings
label: Create Secret for Private Registry Settings
@@ -230,6 +230,13 @@
type: string
label: Kubelet Root Directory
group: Longhorn CSI Driver Settings
+ - variable: csi.podAntiAffinityPreset
+ type: string
+ label: Longhorn CSI Pod AntiAffinity Preset
+ group: Longhorn CSI Driver Settings
+ default: soft
+ description: >-
+ Configures Pod anti-affinity to prevent multiple instances on the same node. Use soft (tries to separate) or hard (must separate). When unspecified, Longhorn uses the default value ("soft").
- variable: csi.attacherReplicaCount
type: int
default: 3
@@ -282,6 +289,15 @@
min: 2
max: 250
default: 250
+ - variable: defaultSettings.snapshotCountWarningThreshold
+ label: Snapshot Count Warning Threshold
+ description: >-
+ Warning threshold for the count-based TooManySnapshots volume condition. The value should be between 2 to 250.
+ group: Longhorn Default Settings
+ type: int
+ min: 2
+ max: 250
+ default: 100
- variable: defaultSettings.createDefaultDiskLabeledNodes
label: Create Default Disk on Labeled Nodes
description: >-
@@ -292,7 +308,7 @@
- variable: defaultSettings.defaultDataPath
label: Default Data Path
description: >-
- Default path for storing data on a host. The default value is "/var/lib/longhorn/".
+ Default path to use for storing data on a host. An absolute directory path indicates a filesystem-type disk used by the V1 Data Engine, while a path to a block device indicates a block-type disk used by the V2 Data Engine. The default value is "/var/lib/longhorn/".
group: Longhorn Default Settings
type: string
default: /var/lib/longhorn/
@@ -364,15 +380,20 @@
group: Longhorn Default Settings
type: string
default: 'https://longhorn-upgrade-responder.rancher.io/v1/checkupgrade'
+ - variable: defaultSettings.managerUrl
+ label: Manager URL
+ description: >-
+ The external URL used to access the Longhorn Manager API. When set, this URL is returned in API responses (the actions and links fields) instead of the internal pod IP. This is useful when accessing the API through Ingress or Gateway API HTTPRoute. Format: scheme://host[:port] (for example, https://longhorn.example.com or https://longhorn.example.com:8443). Leave it empty to use the default behavior. Warning: Internal components (including longhorn-driver-deployer and longhorn-csi-plugin) follow the links returned in API responses. If this URL passes through proxy middleware (such as an OAuth2 proxy, ingress auth, or any other HTTP-intercepting layer), those components may receive an unexpected response (such as an HTML redirect) instead of JSON, causing errors such as "invalid character '<' looking for beginning of value" and CSI driver deployment failure.
+ group: Longhorn Default Settings
+ type: string
+ default: ''
- variable: defaultSettings.defaultReplicaCount
label: Default Replica Count
description: >-
- Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass. The default value is "3".
+ Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass.
group: Longhorn Default Settings
- type: int
- min: 1
- max: 20
- default: 3
+ type: string
+ default: '{"v1":"3","v2":"3"}'
- variable: defaultSettings.defaultLonghornStaticStorageClass
label: Default Longhorn Static StorageClass Name
description: >-
@@ -448,6 +469,14 @@
group: Longhorn Default Settings
type: boolean
default: 'true'
+ - variable: defaultSettings.blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly
+ label: >-
+ Blacklist for Automatically Delete Workload Pod when The Volume Is Detached Unexpectedly
+ description: >-
+ Blacklist of controller api/kind values for the setting Automatically Delete Workload Pod when the Volume Is Detached Unexpectedly. If a workload pod is managed by a controller whose api/kind is listed in this blacklist, Longhorn will not automatically delete the pod when its volume is unexpectedly detached. Multiple controller api/kind entries can be specified, separated by semicolons. For example: `apps/StatefulSet;apps/DaemonSet`. Note that the controller api/kind is case sensitive and must exactly match the api/kind in the workload pod's owner reference.
+ group: Longhorn Default Settings
+ type: string
+ default: null
- variable: defaultSettings.disableSchedulingOnCordonedNode
label: Disable Scheduling On Cordoned Node
description: >-
@@ -538,6 +567,15 @@
type: int
min: 0
default: 5
+ - variable: defaultSettings.rebuildConcurrentSyncLimit
+ label: Rebuild Concurrent Sync Limit
+ description: >-
+ Maximum number of file synchronization operations that can run concurrently during a single replica rebuild. Right now, it's for v1 data engine only.
+ group: Longhorn Default Settings
+ type: int
+ min: 1
+ max: 5
+ default: 1
- variable: defaultSettings.concurrentVolumeBackupRestorePerNodeLimit
label: Concurrent Volume Backup Restore Per Node Limit
description: >-
@@ -551,8 +589,8 @@
description: >-
Setting that disables the revision counter and thereby prevents Longhorn from tracking all write operations to a volume. When salvaging a volume, Longhorn uses properties of the "volume-head-xxx.img" file (the last file size and the last time the file was modified) to select the replica to be used for volume recovery. This setting applies only to volumes created using the Longhorn UI.
group: Longhorn Default Settings
- type: boolean
- default: 'true'
+ type: string
+ default: '{"v1":"true"}'
- variable: defaultSettings.systemManagedPodsImagePullPolicy
label: System Managed Pod Image Pull Policy
description: >-
@@ -612,12 +650,10 @@
- variable: defaultSettings.guaranteedInstanceManagerCPU
label: Guaranteed Instance Manager CPU
description: >-
- Percentage of the total allocatable CPU resources on each node to be reserved for each Instance Manager pod when the V1 Data Engine is enabled. You can specify a value between "0" and "40" to accommodate the possible number of new Instance Manager pods during upgrades. The default value is "12". **Caution**: [1] When the value is "0", CPU requests are removed from the spec of Instance Manager pods. [2] A new set of Instance Manager pods must be deployed when Longhorn is upgraded. If the available CPUs are not sufficient for the new pods, you must detach the volumes using the oldest Instance Manager pods so that Longhorn can automatically clean up the old pods and release the CPU resources. Once completed, the new pods with the latest Instance Manager image are launched. [3] This global setting is not applied to nodes with a specified value for the "InstanceManagerCPURequest" field. [4] After this setting is configured, Instance Manager pods on all nodes that use this setting are automatically restarted. **Do not change this setting while volumes are still attached.**
+ Percentage of the total allocatable CPU resources on each node to be reserved for each Instance Manager pod when the V1 Data Engine is enabled. You can specify a floating point value between "0" and "40" to accommodate the possible number of new Instance Manager pods during upgrades. The default value is "12". **Caution**: [1] When the value is "0", CPU requests are removed from the spec of Instance Manager pods. [2] A new set of Instance Manager pods must be deployed when Longhorn is upgraded. If the available CPUs are not sufficient for the new pods, you must detach the volumes using the oldest Instance Manager pods so that Longhorn can automatically clean up the old pods and release the CPU resources. Once completed, the new pods with the latest Instance Manager image are launched. [3] This global setting is not applied to nodes with a specified value for the "InstanceManagerCPURequest" field. [4] After this setting is configured, Instance Manager pods on all nodes that use this setting are automatically restarted. **Do not change this setting while volumes are still attached. [5] or the v2 Data Engine, the spdk_tgt process inside each instance manager pod uses one or more dedicated CPU cores. Setting a minimum CPU usage is critical to maintaining stability during periods of high node load.**
group: Longhorn Default Settings
- type: int
- min: 0
- max: 40
- default: 12
+ type: string
+ default: '{"v1":"12","v2":"12"}'
- variable: defaultSettings.logLevel
label: Log Level
description: >-
@@ -636,8 +672,8 @@
description: >-
Setting that freezes the filesystem on the root partition before a snapshot is created.
group: Longhorn Default Settings
- type: boolean
- default: 'false'
+ type: string
+ default: '{"v1":"false"}'
- variable: defaultSettings.kubernetesClusterAutoscalerEnabled
label: Kubernetes Cluster Autoscaler Enabled (Experimental)
description: >-
@@ -666,6 +702,13 @@
group: Longhorn Default Settings
type: string
default: null
+ - variable: defaultSettings.EndpointNetworkForRWXVolume
+ label: Endpoint Network For RWX Volume
+ description: >-
+ Specifies a dedicated network for mounting RWX (ReadWriteMany) volumes. Leave this blank to use the default Kubernetes cluster network. **Caution**: This setting should change after all RWX volumes are detached because some Longhorn component pods must be recreated to apply the setting. You cannot modify this setting while RWX volumes are still attached.
+ group: Longhorn Default Settings
+ type: string
+ default: null
- variable: defaultSettings.taintToleration
label: Taint Toleration
description: >-
@@ -680,6 +723,13 @@
group: Longhorn Default Settings
type: string
default: null
+ - variable: defaultSettings.systemManagedCSIComponentsResourceLimits
+ label: System Managed CSI Components Resource Limits
+ description: >-
+ Resource limits for system managed CSI components. This setting allows you to configure CPU and memory requests/limits for CSI attacher, provisioner, resizer, snapshotter, and plugin components. Supported components: csi-attacher, csi-provisioner, csi-resizer, csi-snapshotter, longhorn-csi-plugin, node-driver-registrar, longhorn-liveness-probe. Notice that changing resource limits will cause CSI components to restart, which may temporarily affect volume provisioning and attach/detach operations until the components are ready. The value should be a JSON object with component names as keys and ResourceRequirements as values.
+ group: Longhorn Default Settings
+ type: string
+ default: null
- variable: defaultSettings.deletingConfirmationFlag
label: Deleting Confirmation Flag
description: Flag that prevents accidental uninstallation of Longhorn.
@@ -691,8 +741,8 @@
description: >-
Timeout between the Longhorn Engine and replicas. Specify a value between "8" and "30" seconds. The default value is "8".
group: Longhorn Default Settings
- type: int
- default: '8'
+ type: string
+ default: '{"v1":"8","v2":"8"}'
- variable: defaultSettings.snapshotDataIntegrity
label: Snapshot Data Integrity
description: >-
@@ -710,15 +760,15 @@
description: >-
Hashing snapshot disk files impacts the performance of the system. The immediate snapshot hashing and checking can be disabled to minimize the impact after creating a snapshot.
group: Longhorn Default Settings
- type: boolean
- default: 'false'
+ type: string
+ default: '{"v1":"false","v2":"false"}'
- variable: defaultSettings.snapshotDataIntegrityCronjob
label: Snapshot Data Integrity Check CronJob
description: >-
Unix-cron string format. The setting specifies when Longhorn checks the data integrity of snapshot disk files.
group: Longhorn Default Settings
type: string
- default: 0 0 */7 * *
+ default: '{"v1":"0 0 */7 * *","v2":"0 0 */7 * *"}'
- variable: defaultSettings.removeSnapshotsDuringFilesystemTrim
label: Remove Snapshots During Filesystem Trim
description: >-
@@ -731,8 +781,8 @@
description: >-
Setting that allows fast rebuilding of replicas using the checksum of snapshot disk files. Before enabling this setting, you must set the snapshot-data-integrity value to "enable" or "fast-check".
group: Longhorn Default Settings
- type: boolean
- default: false
+ type: string
+ default: '{"v1":"true","v2":"true"}'
- variable: defaultSettings.replicaFileSyncHttpClientTimeout
label: Timeout of HTTP Client to Replica File Sync Server
description: >-
@@ -761,6 +811,16 @@
type: int
min: 1
default: 2
+ - variable: defaultSettings.backupBlockSize
+ label: Backup Block Size
+ description: >-
+ Specifies the default backup block size, in MiB, used when creating a new volume. Supported values are 2 or 16.
+ group: Longhorn Default Settings
+ type: enum
+ options:
+ - '2'
+ - '16'
+ default: '2'
- variable: defaultSettings.restoreConcurrentLimit
label: Restore Concurrent Limit Per Backup
description: >-
@@ -789,44 +849,34 @@
group: Longhorn V2 Data Engine (Experimental Feature) Settings
type: boolean
default: false
- - variable: defaultSettings.v2DataEngineHugepageLimit
+ - variable: defaultSettings.dataEngineHugepageEnabled
label: V2 Data Engine
description: >-
- This allows users to configure maximum huge page size (in MiB) for the V2 Data Engine.
- group: Longhorn V2 Data Engine (Experimental Feature) Settings
- type: int
- default: '2048'
- - variable: defaultSettings.v2DataEngineLogLevel
- label: V2 Data Engine Log Level
- description: >-
- Setting that allows you to configure the log level of the SPDK target daemon (spdk_tgt) of the V2 Data Engine.
- group: Longhorn V2 Data Engine (Experimental Feature) Settings
- type: enum
- options:
- - Disabled
- - Error
- - Warn
- - Notice
- - Info
- - Debug
- default: Notice
- - variable: defaultSettings.v2DataEngineLogFlags
- label: V2 Data Engine Log Flags
- description: >-
- Setting that allows you to configure the log flags of the SPDK target daemon (spdk_tgt) of the V2 Data Engine.
+ Applies only to the V2 Data Engine. Enables hugepages for the Storage Performance Development Kit (SPDK) target daemon. If disabled, legacy memory is used. Allocation size is set via the Data Engine Memory Size setting.
group: Longhorn V2 Data Engine (Experimental Feature) Settings
type: string
- default: null
- - variable: defaultSettings.v2DataEngineSnapshotDataIntegrity
- label: V2 Data Engine Snapshot Data Integrity
+ default: '{"v2":"true"}'
+ - variable: defaultSettings.dataEngineMemorySize
+ label: V2 Data Engine
description: >-
- Setting that allows you to enable or disable snapshot hashing and data integrity checking for the V2 Data Engine.
+ Applies only to the V2 Data Engine. Specifies the memory size, in MiB, allocated to the Storage Performance Development Kit (SPDK) target daemon. When hugepage is enabled, this defines the hugepage size; when legacy memory is used, hugepage is disabled.
group: Longhorn V2 Data Engine (Experimental Feature) Settings
- type: enum
- options:
- - fast-check
- - disabled
- default: disabled
+ type: string
+ default: '{"v2":"2048"}'
+ - variable: defaultSettings.dataEngineLogLevel
+ label: Data Engine Log Level
+ description: >-
+ Applies only to the V2 Data Engine. Specifies the log level for the Storage Performance Development Kit (SPDK) target daemon. Supported values are: Error, Warning, Notice, Info, and Debug. The default is Notice.
+ group: Longhorn V2 Data Engine (Experimental Feature) Settings
+ type: string
+ default: '{"v2":"Notice"}'
+ - variable: defaultSettings.dataEngineLogFlags
+ label: Data Engine Log Flags
+ description: >-
+ Applies only to the V2 Data Engine. Specifies the log flags for the Storage Performance Development Kit (SPDK) target daemon.
+ group: Longhorn V2 Data Engine (Experimental Feature) Settings
+ type: string
+ default: '{"v2":""}'
- variable: defaultSettings.autoCleanupSnapshotWhenDeleteBackup
label: Auto Cleanup Snapshot When Delete Backup
description: >-
@@ -848,13 +898,99 @@
group: Longhorn Default Settings
type: boolean
default: false
- - variable: defaultSettings.offlineRelicaRebuilding
+ - variable: defaultSettings.offlineReplicaRebuilding
label: Offline Replica Rebuilding
description: >-
Enables automatic rebuilding of degraded replicas while the volume is detached. This setting only takes effect if the individual volume setting is set to `ignored` or `enabled`.
group: Longhorn Default Settings
+ type: string
+ default: '{"v1":"false","v2":"false"}'
+ - variable: defaultSettings.dataEngineCPUMask
+ label: Data Engine CPU Mask
+ description: >-
+ Applies only to the V2 Data Engine. Specifies the CPU cores on which the Storage Performance Development Kit (SPDK) target daemon runs. The daemon is deployed in each Instance Manager pod. Ensure that the assigned CPU cores do not exceed the guaranteed CPUs allocated to the V2 Data Engine Instance Manager. A minimum of 2 CPU cores is recommended. SPDK uses a busy-polling reactor model where the master reactor handles both I/O polling and management RPCs. When only a single core is assigned, heavy I/O workloads can delay or starve RPC processing, resulting in increased latency, timeout events, and operational instability. Assigning 2 or more cores allows I/O and management tasks to run on separate reactors, improving responsiveness and operational stability.
+ group: Longhorn Default Settings
+ type: string
+ default: '{"v2":"0x3"}'
+ - variable: defaultSettings.replicaRebuildingBandwidthLimit
+ label: Replica Rebuilding Bandwidth Limit
+ description: >-
+ Applies only to the V2 Data Engine. Specifies the default write bandwidth limit, in megabytes per second (MB/s), for volume replica rebuilding. If this value is set to 0, there will be no write bandwidth limitation. Individual volumes can override this setting by specifying their own rebuilding bandwidth limit.
+ group: Longhorn Default Settings
+ type: string
+ default: '{"v2":"0"}'
+ - variable: defaultSettings.instanceManagerPodLivenessProbeTimeout
+ label: Instance Manager Pod Liveness Probe Timeout
+ description: >-
+ In seconds. The setting specifies the timeout for the instance manager pod liveness probe. The default value is 10 seconds.
+ group: Longhorn Default Settings
+ type: int
+ min: 1
+ max: 60
+ default: 10
+ - variable: defaultSettings.engineImagePodLivenessProbePeriod
+ label: Engine Image Pod Liveness Probe Period
+ description: >-
+ Interval (in seconds) between liveness probes for engine image pods.
+ group: Longhorn Default Settings
+ type: int
+ min: 1
+ max: 60
+ default: 5
+ - variable: defaultSettings.engineImagePodLivenessProbeTimeout
+ label: Engine Image Pod Liveness Probe Timeout
+ description: >-
+ Time (in seconds) to wait for a liveness probe to complete before marking it as failed.
+ group: Longhorn Default Settings
+ type: int
+ min: 1
+ max: 60
+ default: 4
+ - variable: defaultSettings.engineImagePodLivenessProbeFailureThreshold
+ label: Engine Image Pod Liveness Probe Failure Threshold
+ description: >-
+ Number of consecutive failed probes required to trigger a pod restart.
+ group: Longhorn Default Settings
+ type: int
+ min: 1
+ max: 60
+ default: 3
+ - variable: defaultSettings.snapshotHeavyTaskConcurrentLimit
+ label: Snapshot Heavy Task Concurrent Limit
+ description: >-
+ Setting that controls how many snapshot heavy task operations (such as purge and clone) can run concurrently per node. This is a best-effort mechanism: due to the distributed nature of the system, temporary oversubscription may occur. The limiter reduces worst-case overload but does not guarantee perfect enforcement.
+ group: Longhorn Default Settings
+ type: int
+ min: 0
+ default: 5
+ - variable: defaultSettings.nodeDiskHealthMonitoring
+ label: Node Disk Health Monitoring
+ description: >-
+ Controls whether Longhorn monitors and records health information for node disks. When disabled, disk health checks and status updates are skipped.
+ group: Longhorn Default Settings
+ type: boolean
+ default: true
+ - variable: defaultSettings.csiAllowedTopologyKeys
+ label: CSI Allowed Topology Keys
+ description: >-
+ Comma-separated list of topology keys that the Longhorn CSI driver is allowed to pass through. When empty (default), no topology keys are passed through, and PVs will have no nodeAffinity. When configured (e.g., "topology.kubernetes.io/zone,topology.kubernetes.io/region"), only the specified keys are kept in topology segments. All other keys are filtered out from both CreateVolumeResponse.AccessibleTopology and NodeGetInfo topology.
+ group: Longhorn Default Settings
+ type: string
+ default: null
+ - variable: defaultSettings.csiStorageCapacityTracking
+ label: CSI Storage Capacity Tracking
+ description: >-
+ Controls CSI storage capacity tracking, which allows the kube-scheduler to filter nodes that cannot fit the requested volume.
+ group: Longhorn Default Settings
type: boolean
default: false
+ - variable: defaultSettings.kubernetesMetricsServerMetricsEnabled
+ label: Kubernetes Metrics Server Metrics Enabled
+ description: >-
+ Allows Longhorn to query the Kubernetes Metrics Server ('metrics.k8s.io') for pod and node resource usage.
+ group: Longhorn Default Settings
+ type: boolean
+ default: true
- variable: persistence.defaultClass
default: 'true'
description: Setting that allows you to specify the default Longhorn StorageClass.
@@ -977,6 +1113,38 @@
group: Longhorn Storage Class Settings
type: string
default: null
+ - variable: persistence.shareManagerNodeSelector.enable
+ description: >-
+ Setting that allows you to enable the share manager node selector for the default Longhorn StorageClass.
+ group: Longhorn Storage Class Settings
+ label: Enable Storage Class Share Manager Node Selector
+ type: boolean
+ default: false
+ show_subquestion_if: true
+ subquestions:
+ - variable: persistence.shareManagerNodeSelector.selector
+ label: Storage Class Share Manager Node Selector
+ description: >-
+ Node selector for the share manager pods of the default Longhorn StorageClass. Longhorn schedules share manager pods only on nodes with the specified tags. (Examples: "storage,fast")
+ group: Longhorn Storage Class Settings
+ type: string
+ default: null
+ - variable: persistence.shareManagerTolerations.enable
+ description: >-
+ Setting that allows you to enable the share manager tolerations for the default Longhorn StorageClass.
+ group: Longhorn Storage Class Settings
+ label: Enable Storage Class Share Manager Tolerations
+ type: boolean
+ default: false
+ show_subquestion_if: true
+ subquestions:
+ - variable: persistence.shareManagerTolerations.tolerations
+ label: Storage Class Share Manager Tolerations
+ description: >-
+ Tolerations for the share manager pods of the default Longhorn StorageClass. Specify values using a semicolon-separated list in `kubectl taint` syntax. (Example: "key1=value1:effect; key2=value2:effect")
+ group: Longhorn Storage Class Settings
+ type: string
+ default: null
- variable: persistence.backingImage.enable
description: Setting that allows you to use a backing image in a Longhorn StorageClass.
group: Longhorn Storage Class Settings
@@ -1018,7 +1186,7 @@
group: Longhorn Storage Class Settings
type: string
default: null
- - variable: persistence.removeSnapshotsDuringFilesystemTrim
+ - variable: persistence.unmapMarkSnapChainRemoved
description: >-
Setting that allows you to enable automatic snapshot removal during filesystem trim for a Longhorn StorageClass. (Options: "ignored", "enabled", "disabled")
label: Default Storage Class Remove Snapshots During Filesystem Trim
@@ -1081,6 +1249,45 @@
- Prefix
required: true
label: Ingress Path Type
+ - variable: httproute.enabled
+ default: 'false'
+ description: Expose app using Gateway API HTTPRoute
+ type: boolean
+ group: Services and Load Balancing
+ label: Expose app using Gateway API HTTPRoute
+ show_subquestion_if: true
+ subquestions:
+ - variable: httproute.parentRefs
+ default: '[]'
+ description: >-
+ Gateway references as JSON array. Required fields: name, namespace. Optional: group (default: gateway.networking.k8s.io), kind (default: Gateway), sectionName. Example: [{"name":"my-gateway","namespace":"default","sectionName":"https"}]
+ type: string
+ required: true
+ label: Gateway References (JSON array)
+ - variable: httproute.hostnames
+ default: '[]'
+ description: >-
+ Hostnames for HTTPRoute as JSON array (e.g., ["longhorn.example.com"])
+ type: string
+ required: true
+ label: Hostnames (JSON array)
+ - variable: httproute.path
+ default: /
+ description: >-
+ Default path for HTTPRoute. You can access the Longhorn UI by following the full path.
+ type: string
+ required: true
+ label: HTTPRoute Path
+ - variable: httproute.pathType
+ default: PathPrefix
+ description: >-
+ Path match type for HTTPRoute. (Options: "Exact", "PathPrefix")
+ type: enum
+ options:
+ - Exact
+ - PathPrefix
+ required: true
+ label: HTTPRoute Path Type
- variable: service.ui.type
default: Rancher-Proxy
description: >-
@@ -1169,16 +1376,3 @@
- rke1
- rke2
- k3s
- - variable: defaultSettings.v2DataEngineGuaranteedInstanceManagerCPU
- label: Guaranteed Instance Manager CPU for V2 Data Engine
- description: >-
- Number of millicpu on each node to be reserved for each Instance Manager pod when the V2 Data Engine is enabled. The default value is \"1250\". **Caution** [1] Specifying a value of \"0\" disables CPU requests for Instance Manager pods. You must specify an integer larger than \"1000\". [2] This is a global setting. Modifying the value triggers an automatic restart of the Instance Manager pods. Do not modify the value while volumes are still attached.
- type: int
- min: 1000
- default: 1250
- - variable: defaultSettings.v2DataEngineCPUMask
- label: CPU Mask for V2 Data Engine
- description: >-
- CPU cores on which the Storage Performance Development Kit (SPDK) target daemon should run. The SPDK target daemon is located in each Instance Manager pod. Ensure that the number of cores is less than or equal to the guaranteed Instance Manager CPUs for the V2 Data Engine. The default value is \"0x1\".
- type: string
- default: '0x1'
diff --git a/charts/longhorn/templates/_helpers.tpl b/charts/longhorn/templates/_helpers.tpl
index 3fbc2ac..67afc97 100644
--- a/charts/longhorn/templates/_helpers.tpl
+++ b/charts/longhorn/templates/_helpers.tpl
@@ -40,15 +40,15 @@
{{- define "system_default_registry" -}}
{{- if .Values.global.cattle.systemDefaultRegistry -}}
-{{- printf "%s/" .Values.global.cattle.systemDefaultRegistry -}}
+{{- .Values.global.cattle.systemDefaultRegistry -}}
{{- else -}}
-{{- "" -}}
+{{- "docker.io" -}}
{{- end -}}
{{- end -}}
{{- define "registry_url" -}}
{{- if .Values.privateRegistry.registryUrl -}}
-{{- printf "%s/" .Values.privateRegistry.registryUrl -}}
+{{- .Values.privateRegistry.registryUrl -}}
{{- else -}}
{{ include "system_default_registry" . }}
{{- end -}}
@@ -64,3 +64,28 @@
{{- .Release.Namespace -}}
{{- end -}}
{{- end -}}
+
+{{- /*
+multiTypeSetting helper
+Input: any value (string, number, or map)
+Output: properly quoted YAML string
+*/ -}}
+{{- define "longhorn.multiTypeSetting" -}}
+ {{- $v := . -}}
+ {{- if kindIs "map" $v -}}
+ {{- $v | toJson | quote -}}
+ {{- else -}}
+ {{- $v | quote -}}
+ {{- end -}}
+{{- end -}}
+
+{{/*
+Optional timezone injection for all Longhorn workloads.
+When .Values.global.timezone is set, this snippet renders a TZ env var.
+*/}}
+{{- define "longhorn.timezoneEnv" -}}
+{{- if .Values.global.timezone }}
+- name: TZ
+ value: {{ .Values.global.timezone | quote }}
+{{- end }}
+{{- end -}}
diff --git a/charts/longhorn/templates/clusterrole.yaml b/charts/longhorn/templates/clusterrole.yaml
index 731e99d..8f57d2d 100644
--- a/charts/longhorn/templates/clusterrole.yaml
+++ b/charts/longhorn/templates/clusterrole.yaml
@@ -11,31 +11,37 @@
verbs:
- "*"
- apiGroups: [""]
- resources: ["pods", "events", "persistentvolumes", "persistentvolumeclaims", "persistentvolumeclaims/status", "nodes", "proxy/nodes", "pods/log", "secrets", "services", "endpoints", "configmaps", "serviceaccounts"]
+ resources: ["pods"]
+ verbs: ["get", "list", "watch", "delete", "deletecollection"]
+- apiGroups: [""]
+ resources: ["secrets", "services", "endpoints", "configmaps", "serviceaccounts", "pods/log"]
+ verbs: ["get", "list", "watch"]
+- apiGroups: [""]
+ resources: ["events", "persistentvolumes", "persistentvolumeclaims", "persistentvolumeclaims/status", "nodes"]
verbs: ["*"]
- apiGroups: [""]
resources: ["namespaces"]
verbs: ["get", "list"]
- apiGroups: ["apps"]
- resources: ["daemonsets", "statefulsets", "deployments"]
- verbs: ["*"]
+ resources: ["daemonsets", "statefulsets", "deployments", "replicasets"]
+ verbs: ["get", "list", "watch"]
- apiGroups: ["batch"]
resources: ["jobs", "cronjobs"]
- verbs: ["*"]
+ verbs: ["get", "list", "watch"]
- apiGroups: ["policy"]
- resources: ["poddisruptionbudgets", "podsecuritypolicies"]
- verbs: ["*"]
+ resources: ["poddisruptionbudgets"]
+ verbs: ["get", "list", "watch"]
- apiGroups: ["scheduling.k8s.io"]
resources: ["priorityclasses"]
verbs: ["watch", "list"]
- apiGroups: ["storage.k8s.io"]
- resources: ["storageclasses", "volumeattachments", "volumeattachments/status", "csinodes", "csidrivers"]
+ resources: ["storageclasses", "volumeattachments", "volumeattachments/status", "volumeattributesclasses", "csinodes", "csidrivers", "csistoragecapacities"]
verbs: ["*"]
- apiGroups: ["snapshot.storage.k8s.io"]
resources: ["volumesnapshotclasses", "volumesnapshots", "volumesnapshotcontents", "volumesnapshotcontents/status"]
verbs: ["*"]
- apiGroups: ["longhorn.io"]
- resources: ["volumes", "volumes/status", "engines", "engines/status", "replicas", "replicas/status", "settings", "settings/status",
+ resources: ["volumes", "volumes/status", "enginefrontends", "enginefrontends/status", "engines", "engines/status", "replicas", "replicas/status", "settings", "settings/status",
"engineimages", "engineimages/status", "nodes", "nodes/status", "instancemanagers", "instancemanagers/status",
{{- if .Values.openshift.enabled }}
"engineimages/finalizers", "nodes/finalizers", "instancemanagers/finalizers",
@@ -49,7 +55,7 @@
verbs: ["*"]
- apiGroups: ["coordination.k8s.io"]
resources: ["leases"]
- verbs: ["*"]
+ verbs: ["get", "list", "watch"]
- apiGroups: ["metrics.k8s.io"]
resources: ["pods", "nodes"]
verbs: ["get", "list"]
@@ -60,7 +66,13 @@
resources: ["mutatingwebhookconfigurations", "validatingwebhookconfigurations"]
verbs: ["get", "list", "create", "patch", "delete"]
- apiGroups: ["rbac.authorization.k8s.io"]
- resources: ["roles", "rolebindings", "clusterrolebindings", "clusterroles"]
+ resources: ["roles", "rolebindings"]
+ verbs: ["get", "list", "watch"]
+- apiGroups: ["discovery.k8s.io"]
+ resources: ["endpointslices"]
+ verbs: ["get", "list", "watch"]
+- apiGroups: ["rbac.authorization.k8s.io"]
+ resources: ["clusterrolebindings", "clusterroles"]
verbs: ["*"]
{{- if .Values.openshift.enabled }}
---
diff --git a/charts/longhorn/templates/crds.yaml b/charts/longhorn/templates/crds.yaml
index 73110b7..2ce4289 100644
--- a/charts/longhorn/templates/crds.yaml
+++ b/charts/longhorn/templates/crds.yaml
@@ -3,7 +3,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backingimagedatasources.longhorn.io
@@ -19,62 +19,6 @@
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The current state of the pod used to provision the backing image
- file from source
- jsonPath: .status.currentState
- name: State
- type: string
- - description: The data source type
- jsonPath: .spec.sourceType
- name: SourceType
- type: string
- - description: The node the backing image file will be prepared on
- jsonPath: .spec.nodeID
- name: Node
- type: string
- - description: The disk the backing image file will be prepared on
- jsonPath: .spec.diskUUID
- name: DiskUUID
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 BackingImageDataSource is deprecated;
- use longhorn.io/v1beta2 BackingImageDataSource instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: BackingImageDataSource is where Longhorn stores backing image
- data source object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The system generated UUID of the provisioned backing image file
jsonPath: .spec.uuid
name: UUID
@@ -192,7 +136,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backingimagemanagers.longhorn.io
@@ -231,65 +175,6 @@
- jsonPath: .metadata.creationTimestamp
name: Age
type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 BackingImageManager is deprecated; use
- longhorn.io/v1beta2 BackingImageManager instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: BackingImageManager is where Longhorn stores backing image manager
- object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: The current state of the manager
- jsonPath: .status.currentState
- name: State
- type: string
- - description: The image the manager pod will use
- jsonPath: .spec.image
- name: Image
- type: string
- - description: The node the manager is on
- jsonPath: .spec.nodeID
- name: Node
- type: string
- - description: The disk the manager is responsible for
- jsonPath: .spec.diskUUID
- name: DiskUUID
- type: string
- - description: The disk path the manager is using
- jsonPath: .spec.diskPath
- name: DiskPath
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
name: v1beta2
schema:
openAPIV3Schema:
@@ -388,23 +273,11 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backingimages.longhorn.io
spec:
- conversion:
- strategy: Webhook
- webhook:
- clientConfig:
- service:
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
- path: /v1/webhook/conversion
- port: 9501
- conversionReviewVersions:
- - v1beta2
- - v1beta1
group: longhorn.io
names:
kind: BackingImage
@@ -416,48 +289,6 @@
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The backing image name
- jsonPath: .spec.image
- name: Image
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 BackingImage is deprecated; use longhorn.io/v1beta2
- BackingImage instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: BackingImage is where Longhorn stores backing image object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The system generated UUID
jsonPath: .status.uuid
name: UUID
@@ -621,7 +452,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backupbackingimages.longhorn.io
@@ -788,7 +619,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backups.longhorn.io
@@ -816,61 +647,6 @@
jsonPath: .status.snapshotCreatedAt
name: SnapshotCreatedAt
type: string
- - description: The backup state
- jsonPath: .status.state
- name: State
- type: string
- - description: The backup last synced time
- jsonPath: .status.lastSyncedAt
- name: LastSyncedAt
- type: string
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 Backup is deprecated; use longhorn.io/v1beta2
- Backup instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: Backup is where Longhorn stores backup object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: The snapshot name
- jsonPath: .status.snapshotName
- name: SnapshotName
- type: string
- - description: The snapshot size
- jsonPath: .status.size
- name: SnapshotSize
- type: string
- - description: The snapshot creation time
- jsonPath: .status.snapshotCreatedAt
- name: SnapshotCreatedAt
- type: string
- description: The backup target name
jsonPath: .status.backupTargetName
name: BackupTarget
@@ -908,6 +684,15 @@
spec:
description: BackupSpec defines the desired state of the Longhorn backup
properties:
+ backupBlockSize:
+ description: The backup block size. 0 means the legacy default size
+ 2MiB, and -1 indicate the block size is invalid.
+ enum:
+ - "-1"
+ - "2097152"
+ - "16777216"
+ format: int64
+ type: string
backupMode:
description: |-
The backup mode of this backup.
@@ -915,7 +700,6 @@
enum:
- full
- incremental
- - ""
type: string
labels:
additionalProperties:
@@ -1021,23 +805,11 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backuptargets.longhorn.io
spec:
- conversion:
- strategy: Webhook
- webhook:
- clientConfig:
- service:
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
- path: /v1/webhook/conversion
- port: 9501
- conversionReviewVersions:
- - v1beta2
- - v1beta1
group: longhorn.io
names:
kind: BackupTarget
@@ -1069,61 +841,6 @@
jsonPath: .status.lastSyncedAt
name: LastSyncedAt
type: string
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 BackupTarget is deprecated; use longhorn.io/v1beta2
- BackupTarget instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: BackupTarget is where Longhorn stores backup target object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: The backup target URL
- jsonPath: .spec.backupTargetURL
- name: URL
- type: string
- - description: The backup target credential secret
- jsonPath: .spec.credentialSecret
- name: Credential
- type: string
- - description: The backup target poll interval
- jsonPath: .spec.pollInterval
- name: LastBackupAt
- type: string
- - description: Indicate whether the backup target is available or not
- jsonPath: .status.available
- name: Available
- type: boolean
- - description: The backup target last synced time
- jsonPath: .status.lastSyncedAt
- name: LastSyncedAt
- type: string
name: v1beta2
schema:
openAPIV3Schema:
@@ -1225,7 +942,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: backupvolumes.longhorn.io
@@ -1241,57 +958,6 @@
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The backup volume creation time
- jsonPath: .status.createdAt
- name: CreatedAt
- type: string
- - description: The backup volume last backup name
- jsonPath: .status.lastBackupName
- name: LastBackupName
- type: string
- - description: The backup volume last backup time
- jsonPath: .status.lastBackupAt
- name: LastBackupAt
- type: string
- - description: The backup volume last synced time
- jsonPath: .status.lastSyncedAt
- name: LastSyncedAt
- type: string
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 BackupVolume is deprecated; use longhorn.io/v1beta2
- BackupVolume instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: BackupVolume is where Longhorn stores backup volume object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The backup target name
jsonPath: .spec.backupTargetName
name: BackupTarget
@@ -1418,61 +1084,46 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
- name: engineimages.longhorn.io
+ name: enginefrontends.longhorn.io
spec:
- conversion:
- strategy: Webhook
- webhook:
- clientConfig:
- service:
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
- path: /v1/webhook/conversion
- port: 9501
- conversionReviewVersions:
- - v1beta2
- - v1beta1
group: longhorn.io
names:
- kind: EngineImage
- listKind: EngineImageList
- plural: engineimages
+ kind: EngineFrontend
+ listKind: EngineFrontendList
+ plural: enginefrontends
shortNames:
- - lhei
- singular: engineimage
- preserveUnknownFields: false
+ - lhef
+ singular: enginefrontend
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: State of the engine image
- jsonPath: .status.state
+ - description: The data engine of the engine frontend
+ jsonPath: .spec.dataEngine
+ name: Data Engine
+ type: string
+ - description: The current state of the engine frontend
+ jsonPath: .status.currentState
name: State
type: string
- - description: The Longhorn engine image
- jsonPath: .spec.image
- name: Image
+ - description: The node that the engine frontend is on
+ jsonPath: .spec.nodeID
+ name: Node
type: string
- - description: Number of resources using the engine image
- jsonPath: .status.refCount
- name: RefCount
- type: integer
- - description: The build date of the engine image
- jsonPath: .status.buildDate
- name: BuildDate
- type: date
+ - description: The instance manager of the engine frontend
+ jsonPath: .status.instanceManagerName
+ name: InstanceManager
+ type: string
- jsonPath: .metadata.creationTimestamp
name: Age
type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 EngineImage is deprecated; use longhorn.io/v1beta2
- EngineImage instead
- name: v1beta1
+ name: v1beta2
schema:
openAPIV3Schema:
- description: EngineImage is where Longhorn stores engine image object.
+ description: EngineFrontend is where Longhorn stores engine frontend object
+ for v2 data engine initiator.
properties:
apiVersion:
description: |-
@@ -1492,14 +1143,200 @@
metadata:
type: object
spec:
- x-kubernetes-preserve-unknown-fields: true
+ description: EngineFrontendSpec defines the desired state of the Longhorn
+ engine frontend (v2 initiator)
+ properties:
+ active:
+ type: boolean
+ dataEngine:
+ enum:
+ - v1
+ - v2
+ type: string
+ desireState:
+ type: string
+ disableFrontend:
+ type: boolean
+ engineName:
+ description: EngineName is the name of the v2 engine target (required
+ for EngineFrontend instance creation)
+ type: string
+ frontend:
+ enum:
+ - blockdev
+ - iscsi
+ - nvmf
+ - ublk
+ - ""
+ type: string
+ image:
+ type: string
+ logRequested:
+ type: boolean
+ nodeID:
+ type: string
+ salvageRequested:
+ type: boolean
+ size:
+ description: |-
+ Size is the desired size of the frontend device in bytes, as requested
+ by the volume owner. The EngineFrontend controller drives the frontend
+ device toward this size independently of the engine's target size.
+ format: int64
+ type: string
+ targetIP:
+ description: TargetIP is the IP address of the v2 engine target
+ type: string
+ targetPort:
+ description: TargetPort is the port of the v2 engine target
+ type: integer
+ ublkNumberOfQueue:
+ description: ublkNumberOfQueue controls the number of queues for ublk
+ frontend.
+ type: integer
+ ublkQueueDepth:
+ description: ublkQueueDepth controls the depth of each queue for ublk
+ frontend.
+ type: integer
+ volumeName:
+ type: string
+ volumeSize:
+ format: int64
+ type: string
+ type: object
status:
- x-kubernetes-preserve-unknown-fields: true
+ description: EngineFrontendStatus defines the observed state of the Longhorn
+ engine frontend
+ properties:
+ activePath:
+ description: ActivePath is the currently active frontend path address.
+ type: string
+ conditions:
+ items:
+ properties:
+ lastProbeTime:
+ description: Last time we probed the condition.
+ type: string
+ lastTransitionTime:
+ description: Last time the condition transitioned from one status
+ to another.
+ type: string
+ message:
+ description: Human-readable message indicating details about
+ last transition.
+ type: string
+ reason:
+ description: Unique, one-word, CamelCase reason for the condition's
+ last transition.
+ type: string
+ status:
+ description: |-
+ Status is the status of the condition.
+ Can be True, False, Unknown.
+ type: string
+ type:
+ description: Type is the type of the condition.
+ type: string
+ type: object
+ nullable: true
+ type: array
+ currentImage:
+ type: string
+ currentSize:
+ description: |-
+ CurrentSize is the current size of the frontend device in bytes, as
+ observed from the data plane. It is 0 while the engine frontend is not
+ running.
+ format: int64
+ type: string
+ currentState:
+ type: string
+ endpoint:
+ description: Endpoint is the initiator endpoint (e.g., /dev/longhorn/vol-name)
+ type: string
+ instanceManagerName:
+ type: string
+ ip:
+ type: string
+ logFetched:
+ type: boolean
+ ownerID:
+ type: string
+ paths:
+ description: Paths describes the currently known frontend multipath
+ state.
+ items:
+ properties:
+ anaState:
+ type: string
+ engineName:
+ type: string
+ nguid:
+ type: string
+ nqn:
+ type: string
+ targetIP:
+ type: string
+ targetPort:
+ type: integer
+ type: object
+ type: array
+ port:
+ type: integer
+ preferredPath:
+ description: PreferredPath is the preferred frontend path address.
+ type: string
+ salvageExecuted:
+ type: boolean
+ started:
+ type: boolean
+ starting:
+ type: boolean
+ storageIP:
+ type: string
+ switchoverPhase:
+ description: SwitchoverPhase is the last completed switchover phase
+ reported by the data plane.
+ type: string
+ targetIP:
+ description: TargetIP is the currently connected IP address of the
+ v2 engine target
+ type: string
+ targetPort:
+ description: TargetPort is the currently connected port of the v2
+ engine target
+ type: integer
+ ublkID:
+ format: int32
+ type: integer
+ uuid:
+ type: string
+ type: object
type: object
- served: false
- storage: false
+ served: true
+ storage: true
subresources:
status: {}
+---
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+ annotations:
+ controller-gen.kubebuilder.io/version: v0.19.0
+ labels: {{- include "longhorn.labels" . | nindent 4 }}
+ longhorn-manager: ""
+ name: engineimages.longhorn.io
+spec:
+ group: longhorn.io
+ names:
+ kind: EngineImage
+ listKind: EngineImageList
+ plural: engineimages
+ shortNames:
+ - lhei
+ singular: engineimage
+ scope: Namespaced
+ versions:
- additionalPrinterColumns:
- description: Compatibility of the engine image
jsonPath: .status.incompatible
@@ -1633,7 +1470,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: engines.longhorn.io
@@ -1646,64 +1483,9 @@
shortNames:
- lhe
singular: engine
- preserveUnknownFields: false
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The current state of the engine
- jsonPath: .status.currentState
- name: State
- type: string
- - description: The node that the engine is on
- jsonPath: .spec.nodeID
- name: Node
- type: string
- - description: The instance manager of the engine
- jsonPath: .status.instanceManagerName
- name: InstanceManager
- type: string
- - description: The current image of the engine
- jsonPath: .status.currentImage
- name: Image
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 Engine is deprecated; use longhorn.io/v1beta2
- Engine instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: Engine is where Longhorn stores engine object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The data engine of the engine
jsonPath: .spec.dataEngine
name: Data Engine
@@ -1779,6 +1561,14 @@
type: boolean
nodeID:
type: string
+ rebuildConcurrentSyncLimit:
+ description: |-
+ RebuildConcurrentSyncLimit controls the maximum number of file synchronization operations that can run
+ concurrently during a single replica rebuild.
+ It is determined by the global setting or the volume spec field with the same name.
+ maximum: 5
+ minimum: 0
+ type: integer
replicaAddressMap:
additionalProperties:
type: string
@@ -1796,6 +1586,14 @@
snapshotMaxSize:
format: int64
type: string
+ ublkNumberOfQueue:
+ description: ublkNumberOfQueue controls the number of queues for ublk
+ frontend.
+ type: integer
+ ublkQueueDepth:
+ description: ublkQueueDepth controls the depth of each queue for ublk
+ frontend.
+ type: integer
unmapMarkSnapChainRemovedEnabled:
type: boolean
upgradedReplicaAddressMap:
@@ -1922,13 +1720,29 @@
type: object
nullable: true
type: object
+ rebuildConcurrentSyncLimit:
+ description: |-
+ RebuildConcurrentSyncLimit controls the maximum number of file synchronization operations that can run
+ concurrently during a single replica rebuild.
+ It is determined by the global setting or the volume spec field with the same name.
+ minimum: 0
+ type: integer
rebuildStatus:
additionalProperties:
properties:
+ appliedRebuildingMBps:
+ format: int64
+ type: integer
error:
type: string
fromReplicaAddress:
+ description: Deprecated. We are now using FromReplicaAddressList
+ to list all source replicas.
type: string
+ fromReplicaAddressList:
+ items:
+ type: string
+ type: array
isRebuilding:
type: boolean
progress:
@@ -2012,6 +1826,8 @@
type: string
started:
type: boolean
+ starting:
+ type: boolean
storageIP:
type: string
ublkID:
@@ -2032,7 +1848,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: instancemanagers.longhorn.io
@@ -2045,60 +1861,9 @@
shortNames:
- lhim
singular: instancemanager
- preserveUnknownFields: false
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The state of the instance manager
- jsonPath: .status.currentState
- name: State
- type: string
- - description: The type of the instance manager (engine or replica)
- jsonPath: .spec.type
- name: Type
- type: string
- - description: The node that the instance manager is running on
- jsonPath: .spec.nodeID
- name: Node
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 InstanceManager is deprecated; use longhorn.io/v1beta2
- InstanceManager instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: InstanceManager is where Longhorn stores instance manager object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The data engine of the instance manager
jsonPath: .spec.dataEngine
name: Data Engine
@@ -2196,6 +1961,35 @@
type: object
nullable: true
type: object
+ conditions:
+ items:
+ properties:
+ lastProbeTime:
+ description: Last time we probed the condition.
+ type: string
+ lastTransitionTime:
+ description: Last time the condition transitioned from one status
+ to another.
+ type: string
+ message:
+ description: Human-readable message indicating details about
+ last transition.
+ type: string
+ reason:
+ description: Unique, one-word, CamelCase reason for the condition's
+ last transition.
+ type: string
+ status:
+ description: |-
+ Status is the status of the condition.
+ Can be True, False, Unknown.
+ type: string
+ type:
+ description: Type is the type of the condition.
+ type: string
+ type: object
+ nullable: true
+ type: array
currentState:
type: string
dataEngineStatus:
@@ -2204,8 +1998,92 @@
properties:
cpuMask:
type: string
+ interruptModeEnabled:
+ description: |-
+ InterruptModeEnabled indicates whether the V2 data engine is running in
+ interrupt mode (true) or polling mode (false). Set by Longhorn manager;
+ read-only to users.
+ enum:
+ - ""
+ - "true"
+ - "false"
+ type: string
type: object
type: object
+ instanceEngineFrontends:
+ additionalProperties:
+ properties:
+ spec:
+ properties:
+ dataEngine:
+ type: string
+ name:
+ type: string
+ type: object
+ status:
+ properties:
+ activePath:
+ type: string
+ conditions:
+ additionalProperties:
+ type: boolean
+ nullable: true
+ type: object
+ endpoint:
+ type: string
+ errorMsg:
+ type: string
+ frontend:
+ type: string
+ listen:
+ type: string
+ paths:
+ items:
+ properties:
+ anaState:
+ type: string
+ engineName:
+ type: string
+ nguid:
+ type: string
+ nqn:
+ type: string
+ targetIP:
+ type: string
+ targetPort:
+ type: integer
+ type: object
+ type: array
+ portEnd:
+ format: int32
+ type: integer
+ portStart:
+ format: int32
+ type: integer
+ preferredPath:
+ type: string
+ resourceVersion:
+ format: int64
+ type: integer
+ state:
+ type: string
+ targetPortEnd:
+ format: int32
+ type: integer
+ targetPortStart:
+ format: int32
+ type: integer
+ type:
+ type: string
+ ublkID:
+ format: int32
+ type: integer
+ uuid:
+ type: string
+ type: object
+ type: object
+ nullable: true
+ type: object
instanceEngines:
additionalProperties:
properties:
@@ -2218,6 +2096,8 @@
type: object
status:
properties:
+ activePath:
+ type: string
conditions:
additionalProperties:
type: boolean
@@ -2227,14 +2107,35 @@
type: string
errorMsg:
type: string
+ frontend:
+ type: string
listen:
type: string
+ paths:
+ items:
+ properties:
+ anaState:
+ type: string
+ engineName:
+ type: string
+ nguid:
+ type: string
+ nqn:
+ type: string
+ targetIP:
+ type: string
+ targetPort:
+ type: integer
+ type: object
+ type: array
portEnd:
format: int32
type: integer
portStart:
format: int32
type: integer
+ preferredPath:
+ type: string
resourceVersion:
format: int64
type: integer
@@ -2269,6 +2170,8 @@
type: object
status:
properties:
+ activePath:
+ type: string
conditions:
additionalProperties:
type: boolean
@@ -2278,14 +2181,35 @@
type: string
errorMsg:
type: string
+ frontend:
+ type: string
listen:
type: string
+ paths:
+ items:
+ properties:
+ anaState:
+ type: string
+ engineName:
+ type: string
+ nguid:
+ type: string
+ nqn:
+ type: string
+ targetIP:
+ type: string
+ targetPort:
+ type: integer
+ type: object
+ type: array
portEnd:
format: int32
type: integer
portStart:
format: int32
type: integer
+ preferredPath:
+ type: string
resourceVersion:
format: int64
type: integer
@@ -2308,58 +2232,6 @@
type: object
nullable: true
type: object
- instances:
- additionalProperties:
- properties:
- spec:
- properties:
- dataEngine:
- type: string
- name:
- type: string
- type: object
- status:
- properties:
- conditions:
- additionalProperties:
- type: boolean
- nullable: true
- type: object
- endpoint:
- type: string
- errorMsg:
- type: string
- listen:
- type: string
- portEnd:
- format: int32
- type: integer
- portStart:
- format: int32
- type: integer
- resourceVersion:
- format: int64
- type: integer
- state:
- type: string
- targetPortEnd:
- format: int32
- type: integer
- targetPortStart:
- format: int32
- type: integer
- type:
- type: string
- ublkID:
- format: int32
- type: integer
- uuid:
- type: string
- type: object
- type: object
- description: 'Deprecated: Replaced by InstanceEngines and InstanceReplicas'
- nullable: true
- type: object
ip:
type: string
ownerID:
@@ -2379,23 +2251,11 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: nodes.longhorn.io
spec:
- conversion:
- strategy: Webhook
- webhook:
- clientConfig:
- service:
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
- path: /v1/webhook/conversion
- port: 9501
- conversionReviewVersions:
- - v1beta2
- - v1beta1
group: longhorn.io
names:
kind: Node
@@ -2404,62 +2264,10 @@
shortNames:
- lhn
singular: node
- preserveUnknownFields: false
scope: Namespaced
versions:
- additionalPrinterColumns:
- description: Indicate whether the node is ready
- jsonPath: .status.conditions['Ready']['status']
- name: Ready
- type: string
- - description: Indicate whether the user disabled/enabled replica scheduling for
- the node
- jsonPath: .spec.allowScheduling
- name: AllowScheduling
- type: boolean
- - description: Indicate whether Longhorn can schedule replicas on the node
- jsonPath: .status.conditions['Schedulable']['status']
- name: Schedulable
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 Node is deprecated; use longhorn.io/v1beta2
- Node instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: Node is where Longhorn stores Longhorn node object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: Indicate whether the node is ready
jsonPath: .status.conditions[?(@.type=='Ready')].status
name: Ready
type: string
@@ -2512,6 +2320,7 @@
- ""
- auto
- aio
+ - nvme
type: string
diskType:
enum:
@@ -2620,6 +2429,63 @@
type: string
filesystemType:
type: string
+ healthData:
+ additionalProperties:
+ properties:
+ attributes:
+ items:
+ properties:
+ id:
+ type: integer
+ name:
+ type: string
+ rawString:
+ type: string
+ rawValue:
+ format: int64
+ type: integer
+ threshold:
+ type: integer
+ value:
+ type: integer
+ whenFailed:
+ type: string
+ worst:
+ type: integer
+ type: object
+ type: array
+ capacity:
+ format: int64
+ type: integer
+ diskName:
+ type: string
+ diskType:
+ type: string
+ firmwareVersion:
+ type: string
+ healthStatus:
+ enum:
+ - FAILED
+ - PASSED
+ - UNKNOWN
+ - WARNING
+ type: string
+ modelName:
+ type: string
+ serialNumber:
+ type: string
+ source:
+ enum:
+ - SMART
+ - SPDK
+ type: string
+ temperature:
+ type: integer
+ type: object
+ type: object
+ healthDataLastCollectedAt:
+ format: date-time
+ type: string
instanceManagerName:
type: string
scheduledBackingImage:
@@ -2667,7 +2533,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: orphans.longhorn.io
@@ -2786,7 +2652,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: recurringjobs.longhorn.io
@@ -2807,69 +2673,6 @@
jsonPath: .spec.groups
name: Groups
type: string
- - description: Should be one of "backup" or "snapshot"
- jsonPath: .spec.task
- name: Task
- type: string
- - description: The cron expression represents recurring job scheduling
- jsonPath: .spec.cron
- name: Cron
- type: string
- - description: The number of snapshots/backups to keep for the volume
- jsonPath: .spec.retain
- name: Retain
- type: integer
- - description: The concurrent job to run by each cron job
- jsonPath: .spec.concurrency
- name: Concurrency
- type: integer
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- - description: Specify the labels
- jsonPath: .spec.labels
- name: Labels
- type: string
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 RecurringJob is deprecated; use longhorn.io/v1beta2
- RecurringJob instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: RecurringJob is where Longhorn stores recurring job object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: Sets groupings to the jobs. When set to "default" group will be
- added to the volume label when no other job label exist in volume
- jsonPath: .spec.groups
- name: Groups
- type: string
- description: Should be one of "snapshot", "snapshot-force-create", "snapshot-cleanup",
"snapshot-delete", "backup", "backup-force-create", "filesystem-trim" or "system-backup"
jsonPath: .spec.task
@@ -2986,7 +2789,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: replicas.longhorn.io
@@ -2999,68 +2802,9 @@
shortNames:
- lhr
singular: replica
- preserveUnknownFields: false
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The current state of the replica
- jsonPath: .status.currentState
- name: State
- type: string
- - description: The node that the replica is on
- jsonPath: .spec.nodeID
- name: Node
- type: string
- - description: The disk that the replica is on
- jsonPath: .spec.diskID
- name: Disk
- type: string
- - description: The instance manager of the replica
- jsonPath: .status.instanceManagerName
- name: InstanceManager
- type: string
- - description: The current image of the replica
- jsonPath: .status.currentImage
- name: Image
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 Replica is deprecated; use longhorn.io/v1beta2
- Replica instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: Replica is where Longhorn stores replica object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The data engine of the replica
jsonPath: .spec.dataEngine
name: Data Engine
@@ -3238,9 +2982,6 @@
type: string
currentState:
type: string
- evictionRequested:
- description: 'Deprecated: Replaced by field `spec.evictionRequested`.'
- type: boolean
instanceManagerName:
type: string
ip:
@@ -3255,6 +2996,8 @@
type: boolean
started:
type: boolean
+ starting:
+ type: boolean
storageIP:
type: string
ublkID:
@@ -3273,7 +3016,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: settings.longhorn.io
@@ -3286,7 +3029,6 @@
shortNames:
- lhs
singular: setting
- preserveUnknownFields: false
scope: Namespaced
versions:
- additionalPrinterColumns:
@@ -3294,48 +3036,6 @@
jsonPath: .value
name: Value
type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 Setting is deprecated; use longhorn.io/v1beta2
- Setting instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: Setting is where Longhorn stores setting object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- value:
- type: string
- required:
- - value
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: The value of the setting
- jsonPath: .value
- name: Value
- type: string
- description: The setting is applied
jsonPath: .status.applied
name: Applied
@@ -3375,7 +3075,10 @@
- applied
type: object
value:
- description: The value of the setting.
+ description: |-
+ The value of the setting.
+ - It can be a non-JSON formatted string that is applied to all the applicable data engines listed in the setting definition.
+ - It can be a JSON formatted string that contains values for applicable data engines listed in the setting definition's Default.
type: string
required:
- value
@@ -3389,7 +3092,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: sharemanagers.longhorn.io
@@ -3413,51 +3116,9 @@
jsonPath: .status.ownerID
name: Node
type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 ShareManager is deprecated; use longhorn.io/v1beta2
- ShareManager instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: ShareManager is where Longhorn stores share manager object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- - description: The state of the share manager
- jsonPath: .status.state
- name: State
- type: string
- - description: The node that the share manager is owned by
- jsonPath: .status.ownerID
- name: Node
+ - description: The current image of the share manager
+ jsonPath: .status.currentImage
+ name: Image
type: string
- jsonPath: .metadata.creationTimestamp
name: Age
@@ -3497,6 +3158,9 @@
description: ShareManagerStatus defines the observed state of the Longhorn
share manager
properties:
+ currentImage:
+ description: The image currently used by the share manager pod
+ type: string
endpoint:
description: NFS endpoint that can access the mounted filesystem of
the volume
@@ -3519,7 +3183,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: snapshots.longhorn.io
@@ -3607,6 +3271,11 @@
properties:
checksum:
type: string
+ checksumCalculatedAt:
+ description: |-
+ ChecksumCalculatedAt is the RFC3339 timestamp indicating when the checksum
+ for this snapshot was last calculated or updated.
+ type: string
children:
additionalProperties:
type: boolean
@@ -3629,6 +3298,8 @@
type: string
readyToUse:
type: boolean
+ requestedTime:
+ type: string
restoreSize:
format: int64
type: integer
@@ -3648,7 +3319,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: supportbundles.longhorn.io
@@ -3779,7 +3450,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: systembackups.longhorn.io
@@ -3916,7 +3587,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: systemrestores.longhorn.io
@@ -4025,7 +3696,7 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: volumeattachments.longhorn.io
@@ -4169,23 +3840,11 @@
kind: CustomResourceDefinition
metadata:
annotations:
- controller-gen.kubebuilder.io/version: v0.17.1
+ controller-gen.kubebuilder.io/version: v0.19.0
labels: {{- include "longhorn.labels" . | nindent 4 }}
longhorn-manager: ""
name: volumes.longhorn.io
spec:
- conversion:
- strategy: Webhook
- webhook:
- clientConfig:
- service:
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
- path: /v1/webhook/conversion
- port: 9501
- conversionReviewVersions:
- - v1beta2
- - v1beta1
group: longhorn.io
names:
kind: Volume
@@ -4194,68 +3853,9 @@
shortNames:
- lhv
singular: volume
- preserveUnknownFields: false
scope: Namespaced
versions:
- additionalPrinterColumns:
- - description: The state of the volume
- jsonPath: .status.state
- name: State
- type: string
- - description: The robustness of the volume
- jsonPath: .status.robustness
- name: Robustness
- type: string
- - description: The scheduled condition of the volume
- jsonPath: .status.conditions['scheduled']['status']
- name: Scheduled
- type: string
- - description: The size of the volume
- jsonPath: .spec.size
- name: Size
- type: string
- - description: The node that the volume is currently attaching to
- jsonPath: .status.currentNodeID
- name: Node
- type: string
- - jsonPath: .metadata.creationTimestamp
- name: Age
- type: date
- deprecated: true
- deprecationWarning: longhorn.io/v1beta1 Volume is deprecated; use longhorn.io/v1beta2
- Volume instead
- name: v1beta1
- schema:
- openAPIV3Schema:
- description: Volume is where Longhorn stores volume object.
- properties:
- apiVersion:
- description: |-
- APIVersion defines the versioned schema of this representation of an object.
- Servers should convert recognized schemas to the latest internal value, and
- may reject unrecognized values.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
- type: string
- kind:
- description: |-
- Kind is a string value representing the REST resource this object represents.
- Servers may infer this from the endpoint the client submits requests to.
- Cannot be updated.
- In CamelCase.
- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- type: string
- metadata:
- type: object
- spec:
- x-kubernetes-preserve-unknown-fields: true
- status:
- x-kubernetes-preserve-unknown-fields: true
- type: object
- served: false
- storage: false
- subresources:
- status: {}
- - additionalPrinterColumns:
- description: The data engine of the volume
jsonPath: .spec.dataEngine
name: Data Engine
@@ -4280,6 +3880,11 @@
jsonPath: .status.currentNodeID
name: Node
type: string
+ - description: The engine switchover state
+ jsonPath: .status.switchoverState
+ name: Switchover
+ priority: 1
+ type: string
- jsonPath: .metadata.creationTimestamp
name: Age
type: date
@@ -4313,10 +3918,22 @@
accessMode:
enum:
- rwo
+ - rwop
- rwx
type: string
backingImage:
type: string
+ x-kubernetes-validations:
+ - message: BackingImage is immutable
+ rule: self == oldSelf
+ backupBlockSize:
+ description: BackupBlockSize indicate the block size to create backups.
+ The block size is immutable.
+ enum:
+ - "2097152"
+ - "16777216"
+ format: int64
+ type: string
backupCompressionMethod:
enum:
- none
@@ -4327,6 +3944,12 @@
description: The backup target name that the volume will be backed
up to or is synced.
type: string
+ cloneMode:
+ enum:
+ - ""
+ - full-copy
+ - linked-clone
+ type: string
dataEngine:
enum:
- v1
@@ -4348,6 +3971,14 @@
type: array
encrypted:
type: boolean
+ x-kubernetes-validations:
+ - message: Encrypted is immutable
+ rule: self == oldSelf
+ engineNodeID:
+ description: |-
+ engineNodeID defines the node where the backend engine (target) runs.
+ If empty, falls back to NodeID.
+ type: string
freezeFilesystemForSnapshot:
description: Setting that freezes the filesystem on the root partition
before a snapshot is created.
@@ -4375,6 +4006,8 @@
migrationNodeID:
type: string
nodeID:
+ description: nodeID defines the node where the volume is attached
+ (where the frontend initiator runs).
type: string
nodeSelector:
items:
@@ -4393,6 +4026,14 @@
- disabled
- enabled
type: string
+ rebuildConcurrentSyncLimit:
+ description: |-
+ RebuildConcurrentSyncLimit controls the maximum number of file synchronization operations that can run
+ concurrently during a single replica rebuild.
+ When set to 0, it means following the global setting.
+ maximum: 5
+ minimum: 0
+ type: integer
replicaAutoBalance:
enum:
- ignored
@@ -4408,6 +4049,14 @@
- enabled
- disabled
type: string
+ replicaRebuildingBandwidthLimit:
+ description: ReplicaRebuildingBandwidthLimit controls the maximum
+ write bandwidth (in megabytes per second) allowed on the destination
+ replica during the rebuilding process. Set this value to 0 to disable
+ bandwidth limiting.
+ format: int64
+ minimum: 0
+ type: integer
replicaSoftAntiAffinity:
description: Replica soft anti affinity of the volume. Set enabled
to allow replicas to be scheduled on the same node.
@@ -4442,6 +4091,15 @@
- enabled
- fast-check
type: string
+ snapshotHashingRequestedAt:
+ description: |-
+ SnapshotHashingRequestedAt is the RFC3339 timestamp (e.g., "2026-03-16T10:30:00Z") when an on-demand snapshot checksum calculation is requested.
+ When this value is set and is later than LastOnDemandSnapshotHashingCompleteAt, the system will calculate checksums
+ for all user snapshots.
+
+ If SnapshotHashingRequestedAt differs from LastOnDemandSnapshotHashingCompleteAt, it indicates that a hashing request
+ is still in progress, and a new request will be rejected.
+ type: string
snapshotMaxCount:
type: integer
snapshotMaxSize:
@@ -4449,6 +4107,14 @@
type: string
staleReplicaTimeout:
type: integer
+ ublkNumberOfQueue:
+ description: ublkNumberOfQueue controls the number of queues for ublk
+ frontend.
+ type: integer
+ ublkQueueDepth:
+ description: ublkQueueDepth controls the depth of each queue for ublk
+ frontend.
+ type: integer
unmapMarkSnapChainRemoved:
enum:
- ignored
@@ -4504,6 +4170,10 @@
type: object
nullable: true
type: array
+ currentEngineNodeID:
+ description: the node that the engine (target) is currently running
+ on.
+ type: string
currentImage:
type: string
currentMigrationNodeID:
@@ -4548,12 +4218,20 @@
nullable: true
type: array
type: object
+ lastAutoSalvagedAt:
+ type: string
lastBackup:
type: string
lastBackupAt:
type: string
lastDegradedAt:
type: string
+ lastOnDemandSnapshotHashingCompleteAt:
+ description: |-
+ LastOnDemandSnapshotHashingCompleteAt is the RFC3339 timestamp (e.g., "2026-03-16T10:30:00Z") when the
+ most recent on-demand snapshot checksum calculation completed.
+ When this value matches SnapshotHashingRequestedAt, the requested on-demand checksum calculation is considered complete.
+ type: string
ownerID:
type: string
remountRequestedAt:
@@ -4570,6 +4248,11 @@
type: string
state:
type: string
+ switchoverState:
+ description: |-
+ SwitchoverState describes the current progress of a v2 engine live switchover.
+ Empty when no switchover is in progress.
+ type: string
type: object
type: object
served: true
diff --git a/charts/longhorn/templates/daemonset-sa.yaml b/charts/longhorn/templates/daemonset-sa.yaml
index 0bba120..c1c0ae9 100644
--- a/charts/longhorn/templates/daemonset-sa.yaml
+++ b/charts/longhorn/templates/daemonset-sa.yaml
@@ -20,7 +20,7 @@
spec:
containers:
- name: longhorn-manager
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
imagePullPolicy: {{ .Values.image.pullPolicy }}
securityContext:
privileged: true
@@ -32,17 +32,17 @@
{{- end }}
- daemon
- --engine-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.engine.repository }}:{{ .Values.image.longhorn.engine.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.engine.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.engine.repository }}:{{ .Values.image.longhorn.engine.tag }}"
- --instance-manager-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.instanceManager.repository }}:{{ .Values.image.longhorn.instanceManager.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.instanceManager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.instanceManager.repository }}:{{ .Values.image.longhorn.instanceManager.tag }}"
- --share-manager-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.shareManager.repository }}:{{ .Values.image.longhorn.shareManager.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.shareManager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.shareManager.repository }}:{{ .Values.image.longhorn.shareManager.tag }}"
- --backing-image-manager-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.backingImageManager.repository }}:{{ .Values.image.longhorn.backingImageManager.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.backingImageManager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.backingImageManager.repository }}:{{ .Values.image.longhorn.backingImageManager.tag }}"
- --support-bundle-manager-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.supportBundleKit.repository }}:{{ .Values.image.longhorn.supportBundleKit.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.supportBundleKit.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.supportBundleKit.repository }}:{{ .Values.image.longhorn.supportBundleKit.tag }}"
- --manager-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}"
- --service-account
- longhorn-service-account
{{- if .Values.preUpgradeChecker.upgradeVersionCheck}}
@@ -51,8 +51,6 @@
ports:
- containerPort: 9500
name: manager
- - containerPort: 9501
- name: conversion-wh
- containerPort: 9502
name: admission-wh
- containerPort: 9503
@@ -60,7 +58,7 @@
readinessProbe:
httpGet:
path: /v1/healthz
- port: 9501
+ port: 9502
scheme: HTTPS
volumeMounts:
- name: boot
@@ -100,13 +98,22 @@
valueFrom:
fieldRef:
fieldPath: spec.nodeName
+ {{- if .Values.longhornManager.distro }}
+ - name: LONGHORN_DISTRO
+ value: {{ .Values.longhornManager.distro | quote }}
+ {{- end }}
{{- if .Values.enableGoCoverDir }}
- name: GOCOVERDIR
value: /go-cover-dir/
{{- end }}
+ {{- include "longhorn.timezoneEnv" . | nindent 8 }}
+ {{- with .Values.longhornManager.resources }}
+ resources:
+ {{- toYaml . | nindent 10 }}
+ {{- end }}
- name: pre-pull-share-manager-image
imagePullPolicy: {{ .Values.image.pullPolicy }}
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.shareManager.repository }}:{{ .Values.image.longhorn.shareManager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.shareManager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.shareManager.repository }}:{{ .Values.image.longhorn.shareManager.tag }}
command: ["sh", "-c", "echo share-manager image pulled && sleep infinity"]
volumes:
- name: boot
@@ -134,9 +141,21 @@
secret:
secretName: longhorn-grpc-tls
optional: true
- {{- if .Values.privateRegistry.registrySecret }}
+ {{- with (coalesce .Values.global.imagePullSecrets .Values.privateRegistry.registrySecret) }}
imagePullSecrets:
- - name: {{ .Values.privateRegistry.registrySecret }}
+ {{- $imagePullSecrets := list }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- range . }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- $imagePullSecrets = append $imagePullSecrets . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- toYaml $imagePullSecrets | nindent 8 }}
{{- end }}
{{- if .Values.longhornManager.priorityClass }}
priorityClassName: {{ .Values.longhornManager.priorityClass | quote }}
@@ -161,14 +180,16 @@
{{- end }}
serviceAccountName: longhorn-service-account
updateStrategy:
- rollingUpdate:
- maxUnavailable: "100%"
+{{ toYaml .Values.longhornManager.updateStrategy | indent 4 }}
---
apiVersion: v1
kind: Service
metadata:
labels: {{- include "longhorn.labels" . | nindent 4 }}
app: longhorn-manager
+ {{- with .Values.longhornManager.serviceLabels }}
+ {{- toYaml . | nindent 4 }}
+ {{- end }}
name: longhorn-backend
namespace: {{ include "release_namespace" . }}
{{- if .Values.longhornManager.serviceAnnotations }}
diff --git a/charts/longhorn/templates/default-setting.yaml b/charts/longhorn/templates/default-setting.yaml
index cfe8eb8..11dcf1f 100644
--- a/charts/longhorn/templates/default-setting.yaml
+++ b/charts/longhorn/templates/default-setting.yaml
@@ -13,58 +13,61 @@
create-default-disk-labeled-nodes: {{ .Values.defaultSettings.createDefaultDiskLabeledNodes }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.defaultDataPath) }}
- default-data-path: {{ .Values.defaultSettings.defaultDataPath }}
+ default-data-path: {{ .Values.defaultSettings.defaultDataPath | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.replicaSoftAntiAffinity) }}
replica-soft-anti-affinity: {{ .Values.defaultSettings.replicaSoftAntiAffinity }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.replicaAutoBalance) }}
- replica-auto-balance: {{ .Values.defaultSettings.replicaAutoBalance }}
+ replica-auto-balance: {{ .Values.defaultSettings.replicaAutoBalance | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.storageOverProvisioningPercentage) }}
- storage-over-provisioning-percentage: {{ .Values.defaultSettings.storageOverProvisioningPercentage }}
+ storage-over-provisioning-percentage: {{ .Values.defaultSettings.storageOverProvisioningPercentage | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.storageMinimalAvailablePercentage) }}
- storage-minimal-available-percentage: {{ .Values.defaultSettings.storageMinimalAvailablePercentage }}
+ storage-minimal-available-percentage: {{ .Values.defaultSettings.storageMinimalAvailablePercentage | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.storageReservedPercentageForDefaultDisk) }}
- storage-reserved-percentage-for-default-disk: {{ .Values.defaultSettings.storageReservedPercentageForDefaultDisk }}
+ storage-reserved-percentage-for-default-disk: {{ .Values.defaultSettings.storageReservedPercentageForDefaultDisk | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.upgradeChecker) }}
upgrade-checker: {{ .Values.defaultSettings.upgradeChecker }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.upgradeResponderURL) }}
- upgrade-responder-url: {{ .Values.defaultSettings.upgradeResponderURL }}
+ upgrade-responder-url: {{ .Values.defaultSettings.upgradeResponderURL | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.managerUrl) }}
+ manager-url: {{ .Values.defaultSettings.managerUrl | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.defaultReplicaCount) }}
- default-replica-count: {{ .Values.defaultSettings.defaultReplicaCount }}
+ default-replica-count: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.defaultReplicaCount }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.defaultDataLocality) }}
- default-data-locality: {{ .Values.defaultSettings.defaultDataLocality }}
+ default-data-locality: {{ .Values.defaultSettings.defaultDataLocality | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.defaultLonghornStaticStorageClass) }}
- default-longhorn-static-storage-class: {{ .Values.defaultSettings.defaultLonghornStaticStorageClass }}
+ default-longhorn-static-storage-class: {{ .Values.defaultSettings.defaultLonghornStaticStorageClass | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.failedBackupTTL) }}
- failed-backup-ttl: {{ .Values.defaultSettings.failedBackupTTL }}
+ failed-backup-ttl: {{ .Values.defaultSettings.failedBackupTTL | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.backupExecutionTimeout) }}
- backup-execution-timeout: {{ .Values.defaultSettings.backupExecutionTimeout }}
+ backup-execution-timeout: {{ .Values.defaultSettings.backupExecutionTimeout | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.restoreVolumeRecurringJobs) }}
restore-volume-recurring-jobs: {{ .Values.defaultSettings.restoreVolumeRecurringJobs }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.recurringSuccessfulJobsHistoryLimit) }}
- recurring-successful-jobs-history-limit: {{ .Values.defaultSettings.recurringSuccessfulJobsHistoryLimit }}
+ recurring-successful-jobs-history-limit: {{ .Values.defaultSettings.recurringSuccessfulJobsHistoryLimit | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.recurringJobMaxRetention) }}
- recurring-job-max-retention: {{ .Values.defaultSettings.recurringJobMaxRetention }}
+ recurring-job-max-retention: {{ .Values.defaultSettings.recurringJobMaxRetention | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.recurringFailedJobsHistoryLimit) }}
- recurring-failed-jobs-history-limit: {{ .Values.defaultSettings.recurringFailedJobsHistoryLimit }}
+ recurring-failed-jobs-history-limit: {{ .Values.defaultSettings.recurringFailedJobsHistoryLimit | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.supportBundleFailedHistoryLimit) }}
- support-bundle-failed-history-limit: {{ .Values.defaultSettings.supportBundleFailedHistoryLimit }}
+ support-bundle-failed-history-limit: {{ .Values.defaultSettings.supportBundleFailedHistoryLimit | quote }}
{{- end }}
{{- if or (not (kindIs "invalid" .Values.defaultSettings.taintToleration)) (.Values.global.cattle.windowsCluster.enabled) }}
taint-toleration: {{ $windowsDefaultSettingTaintToleration := list }}{{ $defaultSettingTaintToleration := list -}}
@@ -74,7 +77,7 @@
{{- if not (kindIs "invalid" .Values.defaultSettings.taintToleration) -}}
{{- $defaultSettingTaintToleration = .Values.defaultSettings.taintToleration -}}
{{- end -}}
- {{- $taintToleration := list $windowsDefaultSettingTaintToleration $defaultSettingTaintToleration }}{{ join ";" (compact $taintToleration) -}}
+ {{- $taintToleration := list $windowsDefaultSettingTaintToleration $defaultSettingTaintToleration }}{{ join ";" (compact $taintToleration) | quote -}}
{{- end }}
{{- if or (not (kindIs "invalid" .Values.defaultSettings.systemManagedComponentsNodeSelector)) (.Values.global.cattle.windowsCluster.enabled) }}
system-managed-components-node-selector: {{ $windowsDefaultSettingNodeSelector := list }}{{ $defaultSettingNodeSelector := list -}}
@@ -84,10 +87,13 @@
{{- if not (kindIs "invalid" .Values.defaultSettings.systemManagedComponentsNodeSelector) -}}
{{- $defaultSettingNodeSelector = .Values.defaultSettings.systemManagedComponentsNodeSelector -}}
{{- end -}}
- {{- $nodeSelector := list $windowsDefaultSettingNodeSelector $defaultSettingNodeSelector }}{{ join ";" (compact $nodeSelector) -}}
+ {{- $nodeSelector := list $windowsDefaultSettingNodeSelector $defaultSettingNodeSelector }}{{ join ";" (compact $nodeSelector) | quote -}}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.systemManagedCSIComponentsResourceLimits) }}
+ system-managed-csi-components-resource-limits: {{ .Values.defaultSettings.systemManagedCSIComponentsResourceLimits | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.priorityClass) }}
- priority-class: {{ .Values.defaultSettings.priorityClass }}
+ priority-class: {{ .Values.defaultSettings.priorityClass | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.autoSalvage) }}
auto-salvage: {{ .Values.defaultSettings.autoSalvage }}
@@ -95,6 +101,9 @@
{{- if not (kindIs "invalid" .Values.defaultSettings.autoDeletePodWhenVolumeDetachedUnexpectedly) }}
auto-delete-pod-when-volume-detached-unexpectedly: {{ .Values.defaultSettings.autoDeletePodWhenVolumeDetachedUnexpectedly }}
{{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly) }}
+ blacklist-for-auto-delete-pod-when-volume-detached-unexpectedly: {{ .Values.defaultSettings.blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly }}
+ {{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.disableSchedulingOnCordonedNode) }}
disable-scheduling-on-cordoned-node: {{ .Values.defaultSettings.disableSchedulingOnCordonedNode }}
{{- end }}
@@ -105,28 +114,31 @@
replica-disk-soft-anti-affinity: {{ .Values.defaultSettings.replicaDiskSoftAntiAffinity }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.nodeDownPodDeletionPolicy) }}
- node-down-pod-deletion-policy: {{ .Values.defaultSettings.nodeDownPodDeletionPolicy }}
+ node-down-pod-deletion-policy: {{ .Values.defaultSettings.nodeDownPodDeletionPolicy | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.nodeDrainPolicy) }}
- node-drain-policy: {{ .Values.defaultSettings.nodeDrainPolicy }}
+ node-drain-policy: {{ .Values.defaultSettings.nodeDrainPolicy | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.detachManuallyAttachedVolumesWhenCordoned) }}
detach-manually-attached-volumes-when-cordoned: {{ .Values.defaultSettings.detachManuallyAttachedVolumesWhenCordoned }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.replicaReplenishmentWaitInterval) }}
- replica-replenishment-wait-interval: {{ .Values.defaultSettings.replicaReplenishmentWaitInterval }}
+ replica-replenishment-wait-interval: {{ .Values.defaultSettings.replicaReplenishmentWaitInterval | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.concurrentReplicaRebuildPerNodeLimit) }}
- concurrent-replica-rebuild-per-node-limit: {{ .Values.defaultSettings.concurrentReplicaRebuildPerNodeLimit }}
+ concurrent-replica-rebuild-per-node-limit: {{ .Values.defaultSettings.concurrentReplicaRebuildPerNodeLimit | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.rebuildConcurrentSyncLimit) }}
+ rebuild-concurrent-sync-limit: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.rebuildConcurrentSyncLimit }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.concurrentVolumeBackupRestorePerNodeLimit) }}
- concurrent-volume-backup-restore-per-node-limit: {{ .Values.defaultSettings.concurrentVolumeBackupRestorePerNodeLimit }}
+ concurrent-volume-backup-restore-per-node-limit: {{ .Values.defaultSettings.concurrentVolumeBackupRestorePerNodeLimit | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.disableRevisionCounter) }}
- disable-revision-counter: {{ .Values.defaultSettings.disableRevisionCounter }}
+ disable-revision-counter: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.disableRevisionCounter }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.systemManagedPodsImagePullPolicy) }}
- system-managed-pods-image-pull-policy: {{ .Values.defaultSettings.systemManagedPodsImagePullPolicy }}
+ system-managed-pods-image-pull-policy: {{ .Values.defaultSettings.systemManagedPodsImagePullPolicy | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.allowVolumeCreationWithDegradedAvailability) }}
allow-volume-creation-with-degraded-availability: {{ .Values.defaultSettings.allowVolumeCreationWithDegradedAvailability }}
@@ -138,67 +150,76 @@
auto-cleanup-recurring-job-backup-snapshot: {{ .Values.defaultSettings.autoCleanupRecurringJobBackupSnapshot }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.concurrentAutomaticEngineUpgradePerNodeLimit) }}
- concurrent-automatic-engine-upgrade-per-node-limit: {{ .Values.defaultSettings.concurrentAutomaticEngineUpgradePerNodeLimit }}
+ concurrent-automatic-engine-upgrade-per-node-limit: {{ .Values.defaultSettings.concurrentAutomaticEngineUpgradePerNodeLimit | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.backingImageCleanupWaitInterval) }}
- backing-image-cleanup-wait-interval: {{ .Values.defaultSettings.backingImageCleanupWaitInterval }}
+ backing-image-cleanup-wait-interval: {{ .Values.defaultSettings.backingImageCleanupWaitInterval | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.backingImageRecoveryWaitInterval) }}
- backing-image-recovery-wait-interval: {{ .Values.defaultSettings.backingImageRecoveryWaitInterval }}
+ backing-image-recovery-wait-interval: {{ .Values.defaultSettings.backingImageRecoveryWaitInterval | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.guaranteedInstanceManagerCPU) }}
- guaranteed-instance-manager-cpu: {{ .Values.defaultSettings.guaranteedInstanceManagerCPU }}
+ guaranteed-instance-manager-cpu: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.guaranteedInstanceManagerCPU }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.kubernetesClusterAutoscalerEnabled) }}
kubernetes-cluster-autoscaler-enabled: {{ .Values.defaultSettings.kubernetesClusterAutoscalerEnabled }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.orphanResourceAutoDeletion) }}
- orphan-resource-auto-deletion: {{ .Values.defaultSettings.orphanResourceAutoDeletion }}
+ orphan-resource-auto-deletion: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.orphanResourceAutoDeletion }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.orphanResourceAutoDeletionGracePeriod) }}
- orphan-resource-auto-deletion-grace-period: {{ .Values.defaultSettings.orphanResourceAutoDeletionGracePeriod }}
+ orphan-resource-auto-deletion-grace-period: {{ .Values.defaultSettings.orphanResourceAutoDeletionGracePeriod | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.storageNetwork) }}
- storage-network: {{ .Values.defaultSettings.storageNetwork }}
+ storage-network: {{ .Values.defaultSettings.storageNetwork | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.endpointNetworkForRWXVolume) }}
+ endpoint-network-for-rwx-volume: {{ .Values.defaultSettings.endpointNetworkForRWXVolume | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.deletingConfirmationFlag) }}
deleting-confirmation-flag: {{ .Values.defaultSettings.deletingConfirmationFlag }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.engineReplicaTimeout) }}
- engine-replica-timeout: {{ .Values.defaultSettings.engineReplicaTimeout }}
+ engine-replica-timeout: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.engineReplicaTimeout }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.snapshotDataIntegrity) }}
- snapshot-data-integrity: {{ .Values.defaultSettings.snapshotDataIntegrity }}
+ snapshot-data-integrity: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.snapshotDataIntegrity }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.snapshotDataIntegrityImmediateCheckAfterSnapshotCreation) }}
- snapshot-data-integrity-immediate-check-after-snapshot-creation: {{ .Values.defaultSettings.snapshotDataIntegrityImmediateCheckAfterSnapshotCreation }}
+ snapshot-data-integrity-immediate-check-after-snapshot-creation: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.snapshotDataIntegrityImmediateCheckAfterSnapshotCreation }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.snapshotDataIntegrityCronjob) }}
- snapshot-data-integrity-cronjob: {{ .Values.defaultSettings.snapshotDataIntegrityCronjob }}
+ snapshot-data-integrity-cronjob: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.snapshotDataIntegrityCronjob }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.removeSnapshotsDuringFilesystemTrim) }}
remove-snapshots-during-filesystem-trim: {{ .Values.defaultSettings.removeSnapshotsDuringFilesystemTrim }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.fastReplicaRebuildEnabled) }}
- fast-replica-rebuild-enabled: {{ .Values.defaultSettings.fastReplicaRebuildEnabled }}
+ fast-replica-rebuild-enabled: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.fastReplicaRebuildEnabled }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.replicaFileSyncHttpClientTimeout) }}
- replica-file-sync-http-client-timeout: {{ .Values.defaultSettings.replicaFileSyncHttpClientTimeout }}
+ replica-file-sync-http-client-timeout: {{ .Values.defaultSettings.replicaFileSyncHttpClientTimeout | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.longGRPCTimeOut) }}
- long-grpc-timeout: {{ .Values.defaultSettings.longGRPCTimeOut }}
+ long-grpc-timeout: {{ .Values.defaultSettings.longGRPCTimeOut | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.logLevel) }}
- log-level: {{ .Values.defaultSettings.logLevel }}
+ log-level: {{ .Values.defaultSettings.logLevel | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.logPath) }}
+ log-path: {{ .Values.defaultSettings.logPath | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.backupCompressionMethod) }}
- backup-compression-method: {{ .Values.defaultSettings.backupCompressionMethod }}
+ backup-compression-method: {{ .Values.defaultSettings.backupCompressionMethod | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.backupConcurrentLimit) }}
- backup-concurrent-limit: {{ .Values.defaultSettings.backupConcurrentLimit }}
+ backup-concurrent-limit: {{ .Values.defaultSettings.backupConcurrentLimit | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.restoreConcurrentLimit) }}
- restore-concurrent-limit: {{ .Values.defaultSettings.restoreConcurrentLimit }}
+ restore-concurrent-limit: {{ .Values.defaultSettings.restoreConcurrentLimit | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.defaultBackupBlockSize) }}
+ default-backup-block-size: {{ .Values.defaultSettings.defaultBackupBlockSize | quote }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.v1DataEngine) }}
v1-data-engine: {{ .Values.defaultSettings.v1DataEngine }}
@@ -206,8 +227,11 @@
{{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngine) }}
v2-data-engine: {{ .Values.defaultSettings.v2DataEngine }}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngineHugepageLimit) }}
- v2-data-engine-hugepage-limit: {{ .Values.defaultSettings.v2DataEngineHugepageLimit }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.dataEngineHugepageEnabled) }}
+ data-engine-hugepage-enabled: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.dataEngineHugepageEnabled }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.dataEngineMemorySize) }}
+ data-engine-memory-size: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.dataEngineMemorySize }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.allowEmptyNodeSelectorVolume) }}
allow-empty-node-selector-volume: {{ .Values.defaultSettings.allowEmptyNodeSelectorVolume }}
@@ -221,23 +245,20 @@
{{- if not (kindIs "invalid" .Values.defaultSettings.disableSnapshotPurge) }}
disable-snapshot-purge: {{ .Values.defaultSettings.disableSnapshotPurge }}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngineGuaranteedInstanceManagerCPU) }}
- v2-data-engine-guaranteed-instance-manager-cpu: {{ .Values.defaultSettings.v2DataEngineGuaranteedInstanceManagerCPU }}
- {{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.snapshotMaxCount) }}
- snapshot-max-count: {{ .Values.defaultSettings.snapshotMaxCount }}
+ snapshot-max-count: {{ .Values.defaultSettings.snapshotMaxCount | quote }}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngineLogLevel) }}
- v2-data-engine-log-level: {{ .Values.defaultSettings.v2DataEngineLogLevel }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.snapshotCountWarningThreshold) }}
+ snapshot-count-warning-threshold: {{ .Values.defaultSettings.snapshotCountWarningThreshold | quote }}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngineLogFlags) }}
- v2-data-engine-log-flags: {{ .Values.defaultSettings.v2DataEngineLogFlags }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.dataEngineLogLevel) }}
+ data-engine-log-level: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.dataEngineLogLevel }}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngineSnapshotDataIntegrity) }}
- v2-data-engine-snapshot-data-integrity: {{ .Values.defaultSettings.v2DataEngineSnapshotDataIntegrity }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.dataEngineLogFlags) }}
+ data-engine-log-flags: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.dataEngineLogFlags }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.freezeFilesystemForSnapshot) }}
- freeze-filesystem-for-snapshot: {{ .Values.defaultSettings.freezeFilesystemForSnapshot }}
+ freeze-filesystem-for-snapshot: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.freezeFilesystemForSnapshot }}
{{- end }}
{{- if not (kindIs "invalid" .Values.defaultSettings.autoCleanupSnapshotWhenDeleteBackup) }}
auto-cleanup-when-delete-backup: {{ .Values.defaultSettings.autoCleanupSnapshotWhenDeleteBackup }}
@@ -248,9 +269,45 @@
{{- if not (kindIs "invalid" .Values.defaultSettings.rwxVolumeFastFailover) }}
rwx-volume-fast-failover: {{ .Values.defaultSettings.rwxVolumeFastFailover}}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.offlineRelicaRebuilding) }}
- offline-replica-rebuilding: {{ .Values.defaultSettings.offlineRelicaRebuilding}}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.offlineReplicaRebuilding) }}
+ offline-replica-rebuilding: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.offlineReplicaRebuilding }}
{{- end }}
- {{- if not (kindIs "invalid" .Values.defaultSettings.v2DataEngineCPUMask) }}
- v2-data-engine-cpu-mask: {{ .Values.defaultSettings.v2DataEngineCPUMask }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.dataEngineCPUMask) }}
+ data-engine-cpu-mask: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.dataEngineCPUMask }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.replicaRebuildingBandwidthLimit) }}
+ replica-rebuilding-bandwidth-limit: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.replicaRebuildingBandwidthLimit }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.defaultUblkQueueDepth) }}
+ default-ublk-queue-depth: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.defaultUblkQueueDepth }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.defaultUblkNumberOfQueue) }}
+ default-ublk-number-of-queue: {{ include "longhorn.multiTypeSetting" .Values.defaultSettings.defaultUblkNumberOfQueue }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.engineImagePodLivenessProbePeriod) }}
+ engine-image-pod-liveness-probe-period: {{ .Values.defaultSettings.engineImagePodLivenessProbePeriod | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.engineImagePodLivenessProbeTimeout) }}
+ engine-image-pod-liveness-probe-timeout: {{ .Values.defaultSettings.engineImagePodLivenessProbeTimeout | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.engineImagePodLivenessProbeFailureThreshold) }}
+ engine-image-pod-liveness-probe-failure-threshold: {{ .Values.defaultSettings.engineImagePodLivenessProbeFailureThreshold | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.instanceManagerPodLivenessProbeTimeout) }}
+ instance-manager-pod-liveness-probe-timeout: {{ .Values.defaultSettings.instanceManagerPodLivenessProbeTimeout | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.snapshotHeavyTaskConcurrentLimit) }}
+ snapshot-heavy-task-concurrent-limit: {{ .Values.defaultSettings.snapshotHeavyTaskConcurrentLimit | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.nodeDiskHealthMonitoring) }}
+ node-disk-health-monitoring: {{ .Values.defaultSettings.nodeDiskHealthMonitoring }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.csiAllowedTopologyKeys) }}
+ csi-allowed-topology-keys: {{ .Values.defaultSettings.csiAllowedTopologyKeys | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.csiStorageCapacityTracking) }}
+ csi-storage-capacity-tracking: {{ .Values.defaultSettings.csiStorageCapacityTracking | quote }}
+ {{- end }}
+ {{- if not (kindIs "invalid" .Values.defaultSettings.kubernetesMetricsServerMetricsEnabled) }}
+ kubernetes-metrics-server-metrics-enabled: {{ .Values.defaultSettings.kubernetesMetricsServerMetricsEnabled }}
{{- end }}
diff --git a/charts/longhorn/templates/deployment-driver.yaml b/charts/longhorn/templates/deployment-driver.yaml
index 5683c75..d9beeaa 100644
--- a/charts/longhorn/templates/deployment-driver.yaml
+++ b/charts/longhorn/templates/deployment-driver.yaml
@@ -16,11 +16,11 @@
spec:
initContainers:
- name: wait-longhorn-manager
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
command: ['sh', '-c', 'while [ $(curl -m 1 -s -o /dev/null -w "%{http_code}" http://longhorn-backend:9500/v1) != "200" ]; do echo waiting; sleep 2; done']
containers:
- name: longhorn-driver-deployer
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
imagePullPolicy: {{ .Values.image.pullPolicy }}
command:
- longhorn-manager
@@ -30,7 +30,7 @@
{{- end }}
- deploy-driver
- --manager-image
- - "{{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}"
+ - "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}"
- --manager-url
- http://longhorn-backend:9500/v1
env:
@@ -50,29 +50,33 @@
- name: KUBELET_ROOT_DIR
value: {{ .Values.csi.kubeletRootDir }}
{{- end }}
+ {{- if .Values.csi.podAntiAffinityPreset }}
+ - name: CSI_POD_ANTI_AFFINITY_PRESET
+ value: {{ .Values.csi.podAntiAffinityPreset }}
+ {{- end }}
{{- if and .Values.image.csi.attacher.repository .Values.image.csi.attacher.tag }}
- name: CSI_ATTACHER_IMAGE
- value: "{{ template "registry_url" . }}{{ .Values.image.csi.attacher.repository }}:{{ .Values.image.csi.attacher.tag }}"
+ value: "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.csi.attacher.registry) }}{{ . }}/{{ end }}{{ .Values.image.csi.attacher.repository }}:{{ .Values.image.csi.attacher.tag }}"
{{- end }}
{{- if and .Values.image.csi.provisioner.repository .Values.image.csi.provisioner.tag }}
- name: CSI_PROVISIONER_IMAGE
- value: "{{ template "registry_url" . }}{{ .Values.image.csi.provisioner.repository }}:{{ .Values.image.csi.provisioner.tag }}"
+ value: "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.csi.provisioner.registry) }}{{ . }}/{{ end }}{{ .Values.image.csi.provisioner.repository }}:{{ .Values.image.csi.provisioner.tag }}"
{{- end }}
{{- if and .Values.image.csi.nodeDriverRegistrar.repository .Values.image.csi.nodeDriverRegistrar.tag }}
- name: CSI_NODE_DRIVER_REGISTRAR_IMAGE
- value: "{{ template "registry_url" . }}{{ .Values.image.csi.nodeDriverRegistrar.repository }}:{{ .Values.image.csi.nodeDriverRegistrar.tag }}"
+ value: "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.csi.nodeDriverRegistrar.registry) }}{{ . }}/{{ end }}{{ .Values.image.csi.nodeDriverRegistrar.repository }}:{{ .Values.image.csi.nodeDriverRegistrar.tag }}"
{{- end }}
{{- if and .Values.image.csi.resizer.repository .Values.image.csi.resizer.tag }}
- name: CSI_RESIZER_IMAGE
- value: "{{ template "registry_url" . }}{{ .Values.image.csi.resizer.repository }}:{{ .Values.image.csi.resizer.tag }}"
+ value: "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.csi.resizer.registry) }}{{ . }}/{{ end }}{{ .Values.image.csi.resizer.repository }}:{{ .Values.image.csi.resizer.tag }}"
{{- end }}
{{- if and .Values.image.csi.snapshotter.repository .Values.image.csi.snapshotter.tag }}
- name: CSI_SNAPSHOTTER_IMAGE
- value: "{{ template "registry_url" . }}{{ .Values.image.csi.snapshotter.repository }}:{{ .Values.image.csi.snapshotter.tag }}"
+ value: "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.csi.snapshotter.registry) }}{{ . }}/{{ end }}{{ .Values.image.csi.snapshotter.repository }}:{{ .Values.image.csi.snapshotter.tag }}"
{{- end }}
{{- if and .Values.image.csi.livenessProbe.repository .Values.image.csi.livenessProbe.tag }}
- name: CSI_LIVENESS_PROBE_IMAGE
- value: "{{ template "registry_url" . }}{{ .Values.image.csi.livenessProbe.repository }}:{{ .Values.image.csi.livenessProbe.tag }}"
+ value: "{{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.csi.livenessProbe.registry) }}{{ . }}/{{ end }}{{ .Values.image.csi.livenessProbe.repository }}:{{ .Values.image.csi.livenessProbe.tag }}"
{{- end }}
{{- if .Values.csi.attacherReplicaCount }}
- name: CSI_ATTACHER_REPLICA_COUNT
@@ -97,10 +101,23 @@
- name: go-cover-dir
mountPath: /go-cover-dir/
{{- end }}
+ {{- include "longhorn.timezoneEnv" . | nindent 10 }}
- {{- if .Values.privateRegistry.registrySecret }}
+ {{- with (coalesce .Values.global.imagePullSecrets .Values.privateRegistry.registrySecret) }}
imagePullSecrets:
- - name: {{ .Values.privateRegistry.registrySecret }}
+ {{- $imagePullSecrets := list }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- range . }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- $imagePullSecrets = append $imagePullSecrets . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- toYaml $imagePullSecrets | nindent 8 }}
{{- end }}
{{- if .Values.longhornDriver.priorityClass }}
priorityClassName: {{ .Values.longhornDriver.priorityClass | quote }}
diff --git a/charts/longhorn/templates/deployment-ui.yaml b/charts/longhorn/templates/deployment-ui.yaml
index 76b80f2..a0c2c47 100644
--- a/charts/longhorn/templates/deployment-ui.yaml
+++ b/charts/longhorn/templates/deployment-ui.yaml
@@ -61,7 +61,7 @@
{{- if .Values.openshift.ui.route }}
- name: oauth-proxy
{{- if .Values.image.openshift.oauthProxy.repository }}
- image: {{ template "registry_url" . }}{{ .Values.image.openshift.oauthProxy.repository }}:{{ .Values.image.openshift.oauthProxy.tag }}
+ image: {{ with (coalesce .Values.image.openshift.oauthProxy.registry .Values.global.imageRegistry (include "registry_url" .)) }}{{ . }}/{{ end }}{{ .Values.image.openshift.oauthProxy.repository }}:{{ .Values.image.openshift.oauthProxy.tag }}
{{- else }}
image: ""
{{- end }}
@@ -84,7 +84,7 @@
{{- end }}
{{- end }}
- name: longhorn-ui
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.ui.repository }}:{{ .Values.image.longhorn.ui.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.ui.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.ui.repository }}:{{ .Values.image.longhorn.ui.tag }}
imagePullPolicy: {{ .Values.image.pullPolicy }}
volumeMounts:
- name: nginx-cache
@@ -101,6 +101,7 @@
value: "http://longhorn-backend:9500"
- name: LONGHORN_UI_PORT
value: "8000"
+ {{- include "longhorn.timezoneEnv" . | nindent 10 }}
volumes:
{{- if .Values.openshift.enabled }}
{{- if .Values.openshift.ui.route }}
@@ -115,9 +116,21 @@
name: nginx-config
- emptyDir: {}
name: var-run
- {{- if .Values.privateRegistry.registrySecret }}
+ {{- with (coalesce .Values.global.imagePullSecrets .Values.privateRegistry.registrySecret) }}
imagePullSecrets:
- - name: {{ .Values.privateRegistry.registrySecret }}
+ {{- $imagePullSecrets := list }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- range . }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- $imagePullSecrets = append $imagePullSecrets . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- toYaml $imagePullSecrets | nindent 8 }}
{{- end }}
{{- if .Values.longhornUI.priorityClass }}
priorityClassName: {{ .Values.longhornUI.priorityClass | quote }}
@@ -149,8 +162,15 @@
{{- if eq .Values.service.ui.type "Rancher-Proxy" }}
kubernetes.io/cluster-service: "true"
{{- end }}
+ {{- with .Values.service.ui.labels }}
+ {{- toYaml . | nindent 4 }}
+ {{- end }}
name: longhorn-frontend
namespace: {{ include "release_namespace" . }}
+ {{- with .Values.service.ui.annotations }}
+ annotations:
+ {{- toYaml . | nindent 4 }}
+ {{- end }}
spec:
{{- if eq .Values.service.ui.type "Rancher-Proxy" }}
type: ClusterIP
@@ -163,6 +183,9 @@
{{- if and (eq .Values.service.ui.type "LoadBalancer") .Values.service.ui.loadBalancerSourceRanges }}
loadBalancerSourceRanges: {{- toYaml .Values.service.ui.loadBalancerSourceRanges | nindent 4 }}
{{- end }}
+ {{- if and (eq .Values.service.ui.type "LoadBalancer") .Values.service.ui.loadBalancerClass }}
+ loadBalancerClass: {{ .Values.service.ui.loadBalancerClass }}
+ {{- end }}
selector:
app: longhorn-ui
ports:
diff --git a/charts/longhorn/templates/httproute.yaml b/charts/longhorn/templates/httproute.yaml
new file mode 100644
index 0000000..c80c469
--- /dev/null
+++ b/charts/longhorn/templates/httproute.yaml
@@ -0,0 +1,42 @@
+{{- if .Values.httproute.enabled -}}
+apiVersion: gateway.networking.k8s.io/v1
+kind: HTTPRoute
+metadata:
+ name: longhorn-httproute
+ namespace: {{ include "release_namespace" . }}
+ labels: {{- include "longhorn.labels" . | nindent 4 }}
+ app: longhorn-httproute
+ {{- with .Values.httproute.annotations }}
+ annotations:
+ {{- toYaml . | nindent 4 }}
+ {{- end }}
+spec:
+ {{- with .Values.httproute.parentRefs }}
+ parentRefs:
+ {{- range . }}
+ - group: {{ .group | default "gateway.networking.k8s.io" }}
+ kind: {{ .kind | default "Gateway" }}
+ name: {{ .name }}
+ {{- with .namespace }}
+ namespace: {{ . }}
+ {{- end }}
+ {{- with .sectionName }}
+ sectionName: {{ . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- with .Values.httproute.hostnames }}
+ hostnames:
+ {{- range . }}
+ - {{ . | quote }}
+ {{- end }}
+ {{- end }}
+ rules:
+ - matches:
+ - path:
+ type: {{ .Values.httproute.pathType | default "PathPrefix" }}
+ value: {{ .Values.httproute.path | default "/" }}
+ backendRefs:
+ - name: longhorn-frontend
+ port: 80
+{{- end }}
diff --git a/charts/longhorn/templates/ingress.yaml b/charts/longhorn/templates/ingress.yaml
index 61175e8..a8a2702 100644
--- a/charts/longhorn/templates/ingress.yaml
+++ b/charts/longhorn/templates/ingress.yaml
@@ -28,10 +28,25 @@
name: longhorn-frontend
port:
number: 80
+{{- range .Values.ingress.extraHosts }}
+ - host: {{ . }}
+ http:
+ paths:
+ - path: {{ default "" $.Values.ingress.path }}
+ pathType: {{ default "ImplementationSpecific" $.Values.ingress.pathType }}
+ backend:
+ service:
+ name: longhorn-frontend
+ port:
+ number: 80
+{{- end }}
{{- if .Values.ingress.tls }}
tls:
- hosts:
- {{ .Values.ingress.host }}
+ {{- range .Values.ingress.extraHosts }}
+ - {{ . }}
+ {{- end }}
secretName: {{ .Values.ingress.tlsSecret }}
{{- end }}
{{- end }}
diff --git a/charts/longhorn/templates/network-policies/webhook-network-policy.yaml b/charts/longhorn/templates/network-policies/webhook-network-policy.yaml
index 3812e0f..39d4ec2 100644
--- a/charts/longhorn/templates/network-policies/webhook-network-policy.yaml
+++ b/charts/longhorn/templates/network-policies/webhook-network-policy.yaml
@@ -2,22 +2,6 @@
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
-spec:
- podSelector:
- matchLabels:
- longhorn.io/conversion-webhook: longhorn-conversion-webhook
- policyTypes:
- - Ingress
- ingress:
- - ports:
- - protocol: TCP
- port: 9501
----
-apiVersion: networking.k8s.io/v1
-kind: NetworkPolicy
-metadata:
name: longhorn-admission-webhook
namespace: {{ include "release_namespace" . }}
spec:
diff --git a/charts/longhorn/templates/postupgrade-job.yaml b/charts/longhorn/templates/postupgrade-job.yaml
index 56efd38..d504dbd 100644
--- a/charts/longhorn/templates/postupgrade-job.yaml
+++ b/charts/longhorn/templates/postupgrade-job.yaml
@@ -17,7 +17,7 @@
spec:
containers:
- name: longhorn-post-upgrade
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
imagePullPolicy: {{ .Values.image.pullPolicy }}
command:
- longhorn-manager
@@ -27,10 +27,23 @@
valueFrom:
fieldRef:
fieldPath: metadata.namespace
+ {{- include "longhorn.timezoneEnv" . | nindent 8 }}
restartPolicy: OnFailure
- {{- if .Values.privateRegistry.registrySecret }}
+ {{- with (coalesce .Values.global.imagePullSecrets .Values.privateRegistry.registrySecret) }}
imagePullSecrets:
- - name: {{ .Values.privateRegistry.registrySecret }}
+ {{- $imagePullSecrets := list }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- range . }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- $imagePullSecrets = append $imagePullSecrets . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- toYaml $imagePullSecrets | nindent 8 }}
{{- end }}
{{- if .Values.longhornManager.priorityClass }}
priorityClassName: {{ .Values.longhornManager.priorityClass | quote }}
diff --git a/charts/longhorn/templates/preupgrade-job.yaml b/charts/longhorn/templates/preupgrade-job.yaml
index 9f7a8a6..4e4e77f 100644
--- a/charts/longhorn/templates/preupgrade-job.yaml
+++ b/charts/longhorn/templates/preupgrade-job.yaml
@@ -18,7 +18,7 @@
spec:
containers:
- name: longhorn-pre-upgrade
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
imagePullPolicy: {{ .Values.image.pullPolicy }}
securityContext:
privileged: true
@@ -29,18 +29,35 @@
- name: proc
mountPath: /host/proc/
env:
+ {{- if .Values.longhornManager.distro }}
+ - name: LONGHORN_DISTRO
+ value: {{ .Values.longhornManager.distro | quote }}
+ {{- end }}
- name: POD_NAMESPACE
valueFrom:
fieldRef:
fieldPath: metadata.namespace
+ {{- include "longhorn.timezoneEnv" . | nindent 8 }}
volumes:
- name: proc
hostPath:
path: /proc/
restartPolicy: OnFailure
- {{- if .Values.privateRegistry.registrySecret }}
+ {{- with (coalesce .Values.global.imagePullSecrets .Values.privateRegistry.registrySecret) }}
imagePullSecrets:
- - name: {{ .Values.privateRegistry.registrySecret }}
+ {{- $imagePullSecrets := list }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- range . }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- $imagePullSecrets = append $imagePullSecrets . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- toYaml $imagePullSecrets | nindent 8 }}
{{- end }}
serviceAccountName: longhorn-service-account
{{- if or .Values.global.tolerations .Values.longhornManager.tolerations .Values.global.cattle.windowsCluster.enabled }}
diff --git a/charts/longhorn/templates/registry-secret.yaml b/charts/longhorn/templates/registry-secret.yaml
index 3c6b1dc..1eaaac4 100644
--- a/charts/longhorn/templates/registry-secret.yaml
+++ b/charts/longhorn/templates/registry-secret.yaml
@@ -1,5 +1,8 @@
{{- if .Values.privateRegistry.createSecret }}
{{- if .Values.privateRegistry.registrySecret }}
+{{- if not (kindIs "string" .Values.privateRegistry.registrySecret) }}
+{{- fail "The privateRegistry.registrySecret value must be a string" }}
+{{- end }}
apiVersion: v1
kind: Secret
metadata:
@@ -10,4 +13,4 @@
data:
.dockerconfigjson: {{ template "secret" . }}
{{- end }}
-{{- end }}
\ No newline at end of file
+{{- end }}
diff --git a/charts/longhorn/templates/role.yaml b/charts/longhorn/templates/role.yaml
new file mode 100644
index 0000000..3e377b8
--- /dev/null
+++ b/charts/longhorn/templates/role.yaml
@@ -0,0 +1,29 @@
+apiVersion: rbac.authorization.k8s.io/v1
+kind: Role
+metadata:
+ name: {{ include "longhorn.name" . }}
+ namespace: {{ include "release_namespace" . }}
+ labels:
+ {{- include "longhorn.labels" . | nindent 4 }}
+rules:
+- apiGroups: [""]
+ resources: ["pods", "pods/log", "events", "secrets", "services", "endpoints", "configmaps", "serviceaccounts", "persistentvolumeclaims", "persistentvolumeclaims/status"]
+ verbs: ["*"]
+- apiGroups: ["apps"]
+ resources: ["daemonsets", "deployments", "statefulsets", "replicasets"]
+ verbs: ["*"]
+- apiGroups: ["batch"]
+ resources: ["jobs", "cronjobs"]
+ verbs: ["*"]
+- apiGroups: ["policy"]
+ resources: ["poddisruptionbudgets"]
+ verbs: ["*"]
+- apiGroups: ["coordination.k8s.io"]
+ resources: ["leases"]
+ verbs: ["*"]
+- apiGroups: ["rbac.authorization.k8s.io"]
+ resources: ["roles", "rolebindings"]
+ verbs: ["*"]
+- apiGroups: ["discovery.k8s.io"]
+ resources: ["endpointslices"]
+ verbs: ["*"]
diff --git a/charts/longhorn/templates/rolebinding.yaml b/charts/longhorn/templates/rolebinding.yaml
new file mode 100644
index 0000000..40c6cbc
--- /dev/null
+++ b/charts/longhorn/templates/rolebinding.yaml
@@ -0,0 +1,13 @@
+apiVersion: rbac.authorization.k8s.io/v1
+kind: RoleBinding
+metadata:
+ name: {{ include "longhorn.name" . }}
+ namespace: {{ include "release_namespace" . }}
+roleRef:
+ apiGroup: rbac.authorization.k8s.io
+ kind: Role
+ name: {{ include "longhorn.name" . }}
+subjects:
+- kind: ServiceAccount
+ name: longhorn-service-account
+ namespace: {{ include "release_namespace" . }}
diff --git a/charts/longhorn/templates/servicemonitor.yaml b/charts/longhorn/templates/servicemonitor.yaml
index 3f32961..df98bd6 100644
--- a/charts/longhorn/templates/servicemonitor.yaml
+++ b/charts/longhorn/templates/servicemonitor.yaml
@@ -15,6 +15,9 @@
{{- toYaml . | nindent 4 }}
{{- end }}
spec:
+ {{- with .Values.metrics.serviceMonitor.sampleLimit }}
+ sampleLimit: {{ . }}
+ {{- end }}
selector:
matchLabels:
app: longhorn-manager
diff --git a/charts/longhorn/templates/services.yaml b/charts/longhorn/templates/services.yaml
index 4c8c6bc..efe0123 100644
--- a/charts/longhorn/templates/services.yaml
+++ b/charts/longhorn/templates/services.yaml
@@ -2,22 +2,6 @@
kind: Service
metadata:
labels: {{- include "longhorn.labels" . | nindent 4 }}
- app: longhorn-conversion-webhook
- name: longhorn-conversion-webhook
- namespace: {{ include "release_namespace" . }}
-spec:
- type: ClusterIP
- selector:
- longhorn.io/conversion-webhook: longhorn-conversion-webhook
- ports:
- - name: conversion-webhook
- port: 9501
- targetPort: conversion-wh
----
-apiVersion: v1
-kind: Service
-metadata:
- labels: {{- include "longhorn.labels" . | nindent 4 }}
app: longhorn-admission-webhook
name: longhorn-admission-webhook
namespace: {{ include "release_namespace" . }}
diff --git a/charts/longhorn/templates/storageclass.yaml b/charts/longhorn/templates/storageclass.yaml
index 34723a4..c901003 100644
--- a/charts/longhorn/templates/storageclass.yaml
+++ b/charts/longhorn/templates/storageclass.yaml
@@ -1,3 +1,4 @@
+{{- if .Values.persistence.createStorageClass }}
apiVersion: v1
kind: ConfigMap
metadata:
@@ -12,6 +13,9 @@
name: longhorn
annotations:
storageclass.kubernetes.io/is-default-class: {{ .Values.persistence.defaultClass | quote }}
+ {{- range $key, $value := .Values.persistence.annotations }}
+ {{ $key }}: {{ $value | quote }}
+ {{- end }}
provisioner: driver.longhorn.io
allowVolumeExpansion: true
reclaimPolicy: "{{ .Values.persistence.reclaimPolicy }}"
@@ -48,8 +52,14 @@
{{- if .Values.persistence.defaultNodeSelector.enable }}
nodeSelector: "{{ .Values.persistence.defaultNodeSelector.selector }}"
{{- end }}
- {{- if .Values.persistence.removeSnapshotsDuringFilesystemTrim }}
- unmapMarkSnapChainRemoved: "{{ .Values.persistence.removeSnapshotsDuringFilesystemTrim }}"
+ {{- if .Values.persistence.shareManagerNodeSelector.enable }}
+ shareManagerNodeSelector: "{{ .Values.persistence.shareManagerNodeSelector.selector }}"
+ {{- end }}
+ {{- if .Values.persistence.shareManagerTolerations.enable }}
+ shareManagerTolerations: "{{ .Values.persistence.shareManagerTolerations.tolerations }}"
+ {{- end }}
+ {{- if .Values.persistence.unmapMarkSnapChainRemoved }}
+ unmapMarkSnapChainRemoved: "{{ .Values.persistence.unmapMarkSnapChainRemoved }}"
{{- end }}
{{- if .Values.persistence.disableRevisionCounter }}
disableRevisionCounter: "{{ .Values.persistence.disableRevisionCounter }}"
@@ -58,3 +68,4 @@
{{- if .Values.persistence.backupTargetName }}
backupTargetName: "{{ .Values.persistence.backupTargetName }}"
{{- end }}
+{{- end }}
diff --git a/charts/longhorn/templates/uninstall-job.yaml b/charts/longhorn/templates/uninstall-job.yaml
index 1ab4620..de660e1 100644
--- a/charts/longhorn/templates/uninstall-job.yaml
+++ b/charts/longhorn/templates/uninstall-job.yaml
@@ -17,7 +17,7 @@
spec:
containers:
- name: longhorn-uninstall
- image: {{ template "registry_url" . }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
+ image: {{ with (coalesce .Values.global.imageRegistry (include "registry_url" .) .Values.image.longhorn.manager.registry) }}{{ . }}/{{ end }}{{ .Values.image.longhorn.manager.repository }}:{{ .Values.image.longhorn.manager.tag }}
imagePullPolicy: {{ .Values.image.pullPolicy }}
command:
- longhorn-manager
@@ -28,10 +28,23 @@
valueFrom:
fieldRef:
fieldPath: metadata.namespace
+ {{- include "longhorn.timezoneEnv" . | nindent 8 }}
restartPolicy: Never
- {{- if .Values.privateRegistry.registrySecret }}
+ {{- with (coalesce .Values.global.imagePullSecrets .Values.privateRegistry.registrySecret) }}
imagePullSecrets:
- - name: {{ .Values.privateRegistry.registrySecret }}
+ {{- $imagePullSecrets := list }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- range . }}
+ {{- if kindIs "string" . }}
+ {{- $imagePullSecrets = append $imagePullSecrets (dict "name" .) }}
+ {{- else }}
+ {{- $imagePullSecrets = append $imagePullSecrets . }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+ {{- toYaml $imagePullSecrets | nindent 8 }}
{{- end }}
{{- if .Values.longhornManager.priorityClass }}
priorityClassName: {{ .Values.longhornManager.priorityClass | quote }}
diff --git a/charts/longhorn/values.yaml b/charts/longhorn/values.yaml
index 32d9ed0..a74987b 100644
--- a/charts/longhorn/values.yaml
+++ b/charts/longhorn/values.yaml
@@ -2,6 +2,12 @@
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.
global:
+ # -- Global override for container image registry.
+ imageRegistry: ""
+ # -- Global override for image pull secrets for container registry.
+ imagePullSecrets: []
+ # -- Set container timezone (TZ env) for all Longhorn workloads. Leave empty to use container default.
+ timezone: ""
# -- Toleration for nodes allowed to run user-deployed components such as Longhorn Manager, Longhorn UI, and Longhorn Driver Deployer.
tolerations: []
# -- Node selector for nodes allowed to run user-deployed components such as Longhorn Manager, Longhorn UI, and Longhorn Driver Deployer.
@@ -34,76 +40,104 @@
image:
longhorn:
engine:
+ # -- Registry for the Longhorn Engine image.
+ registry: ""
# -- Repository for the Longhorn Engine image.
repository: longhornio/longhorn-engine
# -- Tag for the Longhorn Engine image.
- tag: v1.9.0
+ tag: v1.12.0
manager:
+ # -- Registry for the Longhorn Manager image.
+ registry: ""
# -- Repository for the Longhorn Manager image.
repository: longhornio/longhorn-manager
# -- Tag for the Longhorn Manager image.
- tag: v1.9.0
+ tag: v1.12.0
ui:
+ # -- Registry for the Longhorn UI image.
+ registry: ""
# -- Repository for the Longhorn UI image.
repository: longhornio/longhorn-ui
# -- Tag for the Longhorn UI image.
- tag: v1.9.0
+ tag: v1.12.0
instanceManager:
+ # -- Registry for the Longhorn Instance Manager image.
+ registry: ""
# -- Repository for the Longhorn Instance Manager image.
repository: longhornio/longhorn-instance-manager
# -- Tag for the Longhorn Instance Manager image.
- tag: v1.9.0
+ tag: v1.12.0
shareManager:
+ # -- Registry for the Longhorn Share Manager image.
+ registry: ""
# -- Repository for the Longhorn Share Manager image.
repository: longhornio/longhorn-share-manager
# -- Tag for the Longhorn Share Manager image.
- tag: v1.9.0
+ tag: v1.12.0
backingImageManager:
+ # -- Registry for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
repository: longhornio/backing-image-manager
# -- Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
- tag: v1.9.0
+ tag: v1.12.0
supportBundleKit:
+ # -- Registry for the Longhorn Support Bundle Manager image.
+ registry: ""
# -- Repository for the Longhorn Support Bundle Manager image.
repository: longhornio/support-bundle-kit
# -- Tag for the Longhorn Support Bundle Manager image.
- tag: v0.0.55
+ tag: v0.0.86
csi:
attacher:
+ # -- Registry for the CSI attacher image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the CSI attacher image. When unspecified, Longhorn uses the default value.
repository: longhornio/csi-attacher
# -- Tag for the CSI attacher image. When unspecified, Longhorn uses the default value.
- tag: v4.8.1
+ tag: v4.12.0
provisioner:
+ # -- Registry for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
repository: longhornio/csi-provisioner
# -- Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
- tag: v5.2.0
+ tag: v5.3.0-20260514
nodeDriverRegistrar:
+ # -- Registry for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
repository: longhornio/csi-node-driver-registrar
# -- Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
- tag: v2.13.0
+ tag: v2.17.0
resizer:
+ # -- Registry for the CSI Resizer image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the CSI Resizer image. When unspecified, Longhorn uses the default value.
repository: longhornio/csi-resizer
# -- Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value.
- tag: v1.13.2
+ tag: v2.1.0-20260514
snapshotter:
+ # -- Registry for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
repository: longhornio/csi-snapshotter
# -- Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
- tag: v8.2.0
+ tag: v8.5.0-20260514
livenessProbe:
+ # -- Registry for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
+ registry: ""
# -- Repository for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
repository: longhornio/livenessprobe
# -- Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
- tag: v2.15.0
+ tag: v2.19.0
openshift:
oauthProxy:
+ # -- Registry for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users.
+ registry: ""
# -- Repository for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users.
repository: ""
- # -- Tag for the OAuth Proxy image. Specify OCP/OKD version 4.1 or later (including version 4.15, which is available at quay.io/openshift/origin-oauth-proxy:4.15). This setting applies only to OpenShift users.
+ # -- Tag for the OAuth Proxy image. Specify OCP/OKD version 4.1 or later (including version 4.18, which is available at quay.io/openshift/origin-oauth-proxy:4.18). This setting applies only to OpenShift users.
tag: ""
# -- Image pull policy that applies to all user-deployed Longhorn components, such as Longhorn Manager, Longhorn driver, and Longhorn UI.
pullPolicy: IfNotPresent
@@ -113,12 +147,27 @@
type: ClusterIP
# -- NodePort port number for Longhorn UI. When unspecified, Longhorn selects a free port between 30000 and 32767.
nodePort: null
+ # -- Class of a load balancer implementation
+ loadBalancerClass: ""
+ # -- Annotation for the Longhorn UI service.
+ annotations: {}
+ ## If you want to set annotations for the Longhorn UI service, delete the `{}` in the line above
+ ## and uncomment this example block
+ # annotation-key1: "annotation-value1"
+ # annotation-key2: "annotation-value2"
+ labels: {}
+ ## If you want to set additional labels for the Longhorn UI service, delete the `{}` in the line above
+ ## and uncomment this example block
+ # label-key1: "label-value1"
+ # label-key2: "label-value2"
manager:
# -- Service type for Longhorn Manager.
type: ClusterIP
# -- NodePort port number for Longhorn Manager. When unspecified, Longhorn selects a free port between 30000 and 32767.
nodePort: ""
persistence:
+ # -- Setting that allows you to create the default Longhorn StorageClass ConfigMap. Set to false to skip StorageClass creation.
+ createStorageClass: true
# -- Setting that allows you to specify the default Longhorn StorageClass.
defaultClass: true
# -- Filesystem type of the default Longhorn StorageClass.
@@ -168,12 +217,24 @@
enable: false
# -- Node selector for the default Longhorn StorageClass. Longhorn uses only nodes with the specified tags for storing volume data. (Examples: "storage,fast")
selector: ""
+ shareManagerNodeSelector:
+ # -- Setting that allows you to enable the share manager node selector for the default Longhorn StorageClass.
+ enable: false
+ # -- Node selector for the share manager pods of the default Longhorn StorageClass. Longhorn schedules share manager pods only on nodes with the specified tags. (Examples: "storage,fast")
+ selector: ""
+ shareManagerTolerations:
+ # -- Setting that allows you to enable the share manager tolerations for the default Longhorn StorageClass.
+ enable: false
+ # -- Tolerations for the share manager pods of the default Longhorn StorageClass. Specify values using a semicolon-separated list in `kubectl taint` syntax. (Example: "key1=value1:effect; key2=value2:effect")
+ tolerations: ""
# -- Setting that allows you to enable automatic snapshot removal during filesystem trim for a Longhorn StorageClass. (Options: "ignored", "enabled", "disabled")
- removeSnapshotsDuringFilesystemTrim: ignored
+ unmapMarkSnapChainRemoved: ignored
# -- Setting that allows you to specify the data engine version for the default Longhorn StorageClass. (Options: "v1", "v2")
dataEngine: v1
# -- Setting that allows you to specify the backup target for the default Longhorn StorageClass.
backupTargetName: default
+ # -- Setting that allows to set the annotations of the default Longhorn StorageClass.
+ annotations: {}
preUpgradeChecker:
# -- Setting that allows Longhorn to perform pre-upgrade checks. Disable this setting when installing Longhorn using Argo CD or other GitOps solutions.
jobEnabled: true
@@ -182,6 +243,8 @@
csi:
# -- kubelet root directory. When unspecified, Longhorn uses the default value.
kubeletRootDir: ~
+ # -- Configures Pod anti-affinity to prevent multiple instances on the same node. Use soft (tries to separate) or hard (must separate). When unspecified, Longhorn uses the default value ("soft").
+ podAntiAffinityPreset: ~
# -- Replica count of the CSI Attacher. When unspecified, Longhorn uses the default value ("3").
attacherReplicaCount: ~
# -- Replica count of the CSI Provisioner. When unspecified, Longhorn uses the default value ("3").
@@ -195,7 +258,7 @@
allowRecurringJobWhileVolumeDetached: ~
# -- Setting that allows Longhorn to automatically create a default disk only on nodes with the label "node.longhorn.io/create-default-disk=true" (if no other disks exist). When this setting is disabled, Longhorn creates a default disk on each node that is added to the cluster.
createDefaultDiskLabeledNodes: ~
- # -- Default path for storing data on a host. The default value is "/var/lib/longhorn/".
+ # -- Default path to use for storing data on a host. An absolute directory path indicates a filesystem-type disk used by the V1 Data Engine, while a path to a block device indicates a block-type disk used by the V2 Data Engine. The default value is "/var/lib/longhorn/".
defaultDataPath: ~
# -- Default data locality. A Longhorn volume has data locality if a local replica of the volume exists on the same node as the pod that is using the volume.
defaultDataLocality: ~
@@ -213,7 +276,9 @@
upgradeChecker: ~
# -- The Upgrade Responder sends a notification whenever a new Longhorn version that you can upgrade to becomes available. The default value is https://longhorn-upgrade-responder.rancher.io/v1/checkupgrade.
upgradeResponderURL: ~
- # -- Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass. The default value is "3".
+ # -- URL prefix embedded in Longhorn Manager API response links (the "actions" and "links" fields). When set, internal components such as longhorn-driver-deployer and longhorn-csi-plugin will follow links using this URL, so it must be reachable from within the cluster without authentication. Setting this to an externally-facing URL that is protected by auth middleware (e.g. OAuth2 proxy, ingress auth) will cause internal components to receive an HTML redirect instead of JSON, resulting in "invalid character '<'" errors and CSI driver deployment failure. Use this setting only when the URL is accessible unauthenticated from inside the cluster. Format: scheme://host[:port] (for example, http://longhorn.example.com). Leave empty to use the default behavior (internal pod IP). Note: this value is persisted in the manager-url Setting CR; removing it from Helm values does not automatically clear the CR. To reset, manually set the manager-url Setting CR value to empty via the Longhorn UI or kubectl.
+ managerUrl: ~
+ # -- Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass. The default value is "{"v1":"3","v2":"3"}".
defaultReplicaCount: ~
# -- Default name of Longhorn static StorageClass. "storageClassName" is assigned to PVs and PVCs that are created for an existing Longhorn volume. "storageClassName" can also be used as a label, so it is possible to use a Longhorn StorageClass to bind a workload to an existing PV without creating a Kubernetes StorageClass object. "storageClassName" needs to be an existing StorageClass. The default value is "longhorn-static".
defaultLonghornStaticStorageClass: ~
@@ -236,6 +301,11 @@
taintToleration: ~
# -- Node selector for system-managed Longhorn components.
systemManagedComponentsNodeSelector: ~
+ # -- Resource limits for system-managed CSI components.
+ # This setting allows you to configure CPU and memory requests/limits for CSI attacher, provisioner, resizer, snapshotter, and plugin components.
+ # Supported components: csi-attacher, csi-provisioner, csi-resizer, csi-snapshotter, longhorn-csi-plugin, node-driver-registrar, longhorn-liveness-probe.
+ # Notice that changing resource limits will cause CSI components to restart, which may temporarily affect volume provisioning and attach/detach operations until the components are ready. The value should be a JSON object with component names as keys and ResourceRequirements as values.
+ systemManagedCSIComponentsResourceLimits: ~
# -- PriorityClass for system-managed Longhorn components.
# This setting can help prevent Longhorn components from being evicted under Node Pressure.
# Notice that this will be applied to Longhorn user-deployed components by default if there are no priority class values set yet, such as `longhornManager.priorityClass`.
@@ -244,6 +314,8 @@
autoSalvage: ~
# -- Setting that allows Longhorn to automatically delete a workload pod that is managed by a controller (for example, daemonset) whenever a Longhorn volume is detached unexpectedly (for example, during Kubernetes upgrades). After deletion, the controller restarts the pod and then Kubernetes handles volume reattachment and remounting.
autoDeletePodWhenVolumeDetachedUnexpectedly: ~
+ # -- Blacklist of controller api/kind values for the setting Automatically Delete Workload Pod when the Volume Is Detached Unexpectedly. If a workload pod is managed by a controller whose api/kind is listed in this blacklist, Longhorn will not automatically delete the pod when its volume is unexpectedly detached. Multiple controller api/kind entries can be specified, separated by semicolons. For example: `apps/StatefulSet;apps/DaemonSet`. Note that the controller api/kind is case sensitive and must exactly match the api/kind in the workload pod's owner reference.
+ blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly: ~
# -- Setting that prevents Longhorn Manager from scheduling replicas on a cordoned Kubernetes node. This setting is enabled by default.
disableSchedulingOnCordonedNode: ~
# -- Setting that allows Longhorn to schedule new replicas of a volume to nodes in the same zone as existing healthy replicas. Nodes that do not belong to any zone are treated as existing in the zone that contains healthy replicas. When identifying zones, Longhorn relies on the label "topology.kubernetes.io/zone=<Zone name of the node>" in the Kubernetes node object.
@@ -260,10 +332,12 @@
replicaReplenishmentWaitInterval: ~
# -- Maximum number of replicas that can be concurrently rebuilt on each node.
concurrentReplicaRebuildPerNodeLimit: ~
+ # -- Maximum number of file synchronization operations that can run concurrently during a single replica rebuild. Right now, it's for v1 data engine only.
+ rebuildConcurrentSyncLimit: ~
# -- Maximum number of volumes that can be concurrently restored on each node using a backup. When the value is "0", restoration of volumes using a backup is disabled.
concurrentVolumeBackupRestorePerNodeLimit: ~
# -- Setting that disables the revision counter and thereby prevents Longhorn from tracking all write operations to a volume. When salvaging a volume, Longhorn uses properties of the "volume-head-xxx.img" file (the last file size and the last time the file was modified) to select the replica to be used for volume recovery. This setting applies only to volumes created using the Longhorn UI.
- disableRevisionCounter: "true"
+ disableRevisionCounter: '{"v1":"true"}'
# -- Image pull policy for system-managed pods, such as Instance Manager, engine images, and CSI Driver. Changes to the image pull policy are applied only after the system-managed pods restart.
systemManagedPodsImagePullPolicy: ~
# -- Setting that allows you to create and attach a volume without having all replicas scheduled at the time of creation.
@@ -278,11 +352,11 @@
backingImageCleanupWaitInterval: ~
# -- Number of seconds that Longhorn waits before downloading a backing image file again when the status of all image disk files changes to "failed" or "unknown".
backingImageRecoveryWaitInterval: ~
- # -- Percentage of the total allocatable CPU resources on each node to be reserved for each instance manager pod when the V1 Data Engine is enabled. The default value is "12".
+ # -- Percentage of the total allocatable CPU resources on each node to be reserved for each instance manager pod. The default value is {"v1":"12","v2":"12"}.
guaranteedInstanceManagerCPU: ~
# -- Setting that notifies Longhorn that the cluster is using the Kubernetes Cluster Autoscaler.
kubernetesClusterAutoscalerEnabled: ~
- # -- Enables Longhorn to automatically delete orphaned resources and their associated data or processes (e.g., stale replicas). Orphaned resources on failed or unknown nodes are not automatically cleaned up.
+ # -- Enables Longhorn to automatically delete orphaned resources and their associated data or processes (e.g., stale replicas). Orphaned resources on failed or unknown nodes are not automatically cleaned up.
# You need to specify the resource types to be deleted using a semicolon-separated list (e.g., `replica-data;instance`). Available items are: `replica-data`, `instance`.
orphanResourceAutoDeletion: ~
# -- Specifies the wait time, in seconds, before Longhorn automatically deletes an orphaned Custom Resource (CR) and its associated resources.
@@ -290,6 +364,8 @@
orphanResourceAutoDeletionGracePeriod: ~
# -- Storage network for in-cluster traffic. When unspecified, Longhorn uses the Kubernetes cluster network.
storageNetwork: ~
+ # -- Specifies a dedicated network for mounting RWX (ReadWriteMany) volumes. Leave this blank to use the default Kubernetes cluster network. **Caution**: This setting should change after all RWX volumes are detached because some Longhorn component pods must be recreated to apply the setting. You cannot modify this setting while RWX volumes are still attached.
+ endpointNetworkForRWXVolume: ~
# -- Flag that prevents accidental uninstallation of Longhorn.
deletingConfirmationFlag: ~
# -- Timeout between the Longhorn Engine and replicas. Specify a value between "8" and "30" seconds. The default value is "8".
@@ -300,6 +376,8 @@
snapshotDataIntegrityImmediateCheckAfterSnapshotCreation: ~
# -- Setting that defines when Longhorn checks the integrity of data in snapshot disk files. You must use the Unix cron expression format.
snapshotDataIntegrityCronjob: ~
+ # -- Setting that controls how many snapshot heavy task operations (such as purge and clone) can run concurrently per node. This is a best-effort mechanism: due to the distributed nature of the system, temporary oversubscription may occur. The limiter reduces worst-case overload but does not guarantee perfect enforcement.
+ snapshotHeavyTaskConcurrentLimit: ~
# -- Setting that allows Longhorn to automatically mark the latest snapshot and its parent files as removed during a filesystem trim. Longhorn does not remove snapshots containing multiple child files.
removeSnapshotsDuringFilesystemTrim: ~
# -- Setting that allows fast rebuilding of replicas using the checksum of snapshot disk files. Before enabling this setting, you must set the snapshot-data-integrity value to "enable" or "fast-check".
@@ -310,22 +388,40 @@
longGRPCTimeOut: ~
# -- Log levels that indicate the type and severity of logs in Longhorn Manager. The default value is "Info". (Options: "Panic", "Fatal", "Error", "Warn", "Info", "Debug", "Trace")
logLevel: ~
+ # -- Specifies the directory on the host where Longhorn stores log files for the instance manager pod. Currently, it is only used for instance manager pods in the v2 data engine.
+ logPath: ~
# -- Setting that allows you to specify a backup compression method.
backupCompressionMethod: ~
# -- Maximum number of worker threads that can concurrently run for each backup.
backupConcurrentLimit: ~
+ # -- Specifies the default backup block size, in MiB, used when creating a new volume. Supported values are 2 or 16.
+ defaultBackupBlockSize: ~
# -- Maximum number of worker threads that can concurrently run for each restore operation.
restoreConcurrentLimit: ~
# -- Setting that allows you to enable the V1 Data Engine.
v1DataEngine: ~
# -- Setting that allows you to enable the V2 Data Engine, which is based on the Storage Performance Development Kit (SPDK). The V2 Data Engine is an experimental feature and should not be used in production environments.
v2DataEngine: ~
- # -- Setting that allows you to configure maximum huge page size (in MiB) for the V2 Data Engine.
- v2DataEngineHugepageLimit: ~
- # -- Number of millicpus on each node to be reserved for each Instance Manager pod when the V2 Data Engine is enabled. The default value is "1250".
- v2DataEngineGuaranteedInstanceManagerCPU: ~
- # -- CPU cores on which the Storage Performance Development Kit (SPDK) target daemon should run. The SPDK target daemon is located in each Instance Manager pod. Ensure that the number of cores is less than or equal to the guaranteed Instance Manager CPUs for the V2 Data Engine. The default value is "0x1".
- v2DataEngineCPUMask: ~
+ # -- Applies only to the V2 Data Engine. Enables hugepages for the Storage Performance Development Kit (SPDK) target daemon. If disabled, legacy memory is used. Allocation size is set via the Data Engine Memory Size setting.
+ dataEngineHugepageEnabled: ~
+ # -- Applies only to the V2 Data Engine. Specifies the hugepage size, in MiB, for the Storage Performance Development Kit (SPDK) target daemon. The default value is "{"v2":"2048"}"
+ dataEngineMemorySize: ~
+ # -- Applies only to the V2 Data Engine. Specifies the CPU cores on which the Storage Performance Development Kit (SPDK) target daemon runs. The daemon is deployed in each Instance Manager pod. Ensure that the assigned CPU cores do not exceed the guaranteed CPUs allocated to the V2 Data Engine Instance Manager. A minimum of 2 CPU cores is recommended. SPDK uses a busy-polling reactor model where the master reactor handles both I/O polling and management RPCs. When only a single core is assigned, heavy I/O workloads can delay or starve RPC processing, resulting in increased latency, timeout events, and operational instability. Assigning 2 or more cores allows I/O and management tasks to run on separate reactors, improving responsiveness and operational stability. Accepts either hexadecimal CPU masks (for example, 0x3 or 0xff) or CPU list format (for example, 0-1,2,5). CPU lists are automatically converted to hexadecimal masks. The default value is 0x3.
+ dataEngineCPUMask: ~
+ # -- This setting specifies the default write bandwidth limit (in megabytes per second) for volume replica rebuilding when using the v2 data engine (SPDK). If this value is set to 0, there will be no write bandwidth limitation. Individual volumes can override this setting by specifying their own rebuilding bandwidth limit.
+ replicaRebuildingBandwidthLimit: ~
+ # -- This setting specifies the default depth of each queue for Ublk frontend. This setting applies to volumes using the V2 Data Engine with Ublk front end. Individual volumes can override this setting by specifying their own Ublk queue depth.
+ defaultUblkQueueDepth: ~
+ # -- This setting specifies the default the number of queues for ublk frontend. This setting applies to volumes using the V2 Data Engine with Ublk front end. Individual volumes can override this setting by specifying their own number of queues for ublk.
+ defaultUblkNumberOfQueue: ~
+ # -- In seconds. The setting specifies the interval between liveness probes for engine image pods. The default value is 5 seconds.
+ engineImagePodLivenessProbePeriod: ~
+ # -- In seconds. The setting specifies the timeout for the engine image pod liveness probe. The default value is 4 seconds.
+ engineImagePodLivenessProbeTimeout: ~
+ # -- The setting specifies the number of consecutive failed liveness probes before an engine image pod is restarted. The default value is 3.
+ engineImagePodLivenessProbeFailureThreshold: ~
+ # -- In seconds. The setting specifies the timeout for the instance manager pod liveness probe. The default value is 10 seconds.
+ instanceManagerPodLivenessProbeTimeout: ~
# -- Setting that allows scheduling of empty node selector volumes to any node.
allowEmptyNodeSelectorVolume: ~
# -- Setting that allows scheduling of empty disk selector volumes to any disk.
@@ -336,12 +432,12 @@
disableSnapshotPurge: ~
# -- Maximum snapshot count for a volume. The value should be between 2 to 250
snapshotMaxCount: ~
- # -- Setting that allows you to configure the log level of the SPDK target daemon (spdk_tgt) of the V2 Data Engine.
- v2DataEngineLogLevel: ~
- # -- Setting that allows you to configure the log flags of the SPDK target daemon (spdk_tgt) of the V2 Data Engine.
- v2DataEngineLogFlags: ~
- # -- Setting allows you to enable or disable snapshot hashing and data integrity checking for the V2 Data Engine.
- v2DataEngineSnapshotDataIntegrity: ~
+ # -- Warning threshold for the count-based TooManySnapshots volume condition. The value should be between 2 to 250. Default is 100.
+ snapshotCountWarningThreshold: ~
+ # -- Applies only to the V2 Data Engine. Specifies the log level for the Storage Performance Development Kit (SPDK) target daemon. Supported values are: Error, Warning, Notice, Info, and Debug. The default is Notice.
+ dataEngineLogLevel: ~
+ # -- Applies only to the V2 Data Engine. Specifies the log flags for the Storage Performance Development Kit (SPDK) target daemon.
+ dataEngineLogFlags: ~
# -- Setting that freezes the filesystem on the root partition before a snapshot is created.
freezeFilesystemForSnapshot: ~
# -- Setting that automatically cleans up the snapshot when the backup is deleted.
@@ -351,7 +447,15 @@
# -- Setting that allows Longhorn to detect node failure and immediately migrate affected RWX volumes.
rwxVolumeFastFailover: ~
# -- Enables automatic rebuilding of degraded replicas while the volume is detached. This setting only takes effect if the individual volume setting is set to `ignored` or `enabled`.
- offlineRelicaRebuilding: ~
+ offlineReplicaRebuilding: ~
+ # -- Controls whether Longhorn monitors and records health information for node disks. When disabled, disk health checks and status updates are skipped.
+ nodeDiskHealthMonitoring: ~
+ # -- Comma-separated list of topology keys that the Longhorn CSI driver is allowed to pass through. When empty (default), no topology keys are passed through, and PVs will have no nodeAffinity. When configured (e.g., "topology.kubernetes.io/zone,topology.kubernetes.io/region"), only the specified keys are kept in topology segments. All other keys are filtered out from both CreateVolumeResponse.AccessibleTopology and NodeGetInfo topology.
+ csiAllowedTopologyKeys: ~
+ # -- Setting that controls CSI storage capacity tracking, which allows the kube-scheduler to filter nodes that cannot fit the requested volume.
+ csiStorageCapacityTracking: ~
+ # -- Setting that allows Longhorn to query the Kubernetes Metrics Server ('metrics.k8s.io') for pod and node resource usage.
+ kubernetesMetricsServerMetricsEnabled: ~
# -- Setting that allows you to update the default backupstore.
defaultBackupStore:
# -- Endpoint used to access the default backupstore. (Options: "NFS", "CIFS", "AWS", "GCP", "AZURE")
@@ -361,7 +465,7 @@
# -- Number of seconds that Longhorn waits before checking the default backupstore for new backups. The default value is "300". When the value is "0", polling is disabled.
pollInterval: ~
privateRegistry:
- # -- Setting that allows you to create a private registry secret.
+ # -- Set to `true` to automatically create a new private registry secret.
createSecret: ~
# -- URL of a private registry. When unspecified, Longhorn uses the default system registry.
registryUrl: ~
@@ -369,12 +473,14 @@
registryUser: ~
# -- Password for authenticating with a private registry.
registryPasswd: ~
- # -- Kubernetes secret that allows you to pull images from a private registry. This setting applies only when creation of private registry secrets is enabled. You must include the private registry name in the secret name.
+ # -- If create a new private registry secret is true, create a Kubernetes secret with this name; else use the existing secret of this name. Use it to pull images from your private registry.
registrySecret: ~
longhornManager:
log:
# -- Format of Longhorn Manager logs. (Options: "plain", "json")
format: plain
+ # -- Optional distro identifier used for upgrade responder reporting.
+ distro: "longhorn"
# -- PriorityClass for Longhorn Manager.
priorityClass: *defaultPriorityClassNameRef
# -- Toleration for Longhorn Manager on nodes allowed to run Longhorn components.
@@ -385,6 +491,8 @@
# operator: "Equal"
# value: "value"
# effect: "NoSchedule"
+ # -- Resource requests and limits for Longhorn Manager pods.
+ resources: ~
# -- Node selector for Longhorn Manager. Specify the nodes allowed to run Longhorn Manager.
nodeSelector: {}
## If you want to set node selector for Longhorn Manager DaemonSet, delete the `{}` in the line above
@@ -397,6 +505,17 @@
## and uncomment this example block
# annotation-key1: "annotation-value1"
# annotation-key2: "annotation-value2"
+ serviceLabels: {}
+ ## If you want to set labels for the Longhorn Manager service, delete the `{}` in the line above
+ ## and uncomment this example block
+ # label-key1: "label-value1"
+ # label-key2: "label-value2"
+ ## DaemonSet update strategy. Default "100% unavailable" matches the upgrade
+ ## flow (old managers removed before new start); override for rolling updates
+ ## if you prefer that behavior.
+ updateStrategy:
+ rollingUpdate:
+ maxUnavailable: "100%"
longhornDriver:
log:
# -- Format of longhorn-driver logs. (Options: "plain", "json")
@@ -457,6 +576,12 @@
ingressClassName: ~
# -- Hostname of the Layer 7 load balancer.
host: sslip.io
+ # -- Extra hostnames for TLS (Subject Alternative Names - SAN). Used when you need multiple FQDNs for the same ingress.
+ # Example:
+ # extraHosts:
+ # - longhorn.example.com
+ # - longhorn-ui.internal.local
+ extraHosts: []
# -- Setting that allows you to enable TLS on ingress records.
tls: false
# -- Setting that allows you to enable secure connections to the Longhorn UI service via port 443.
@@ -475,7 +600,7 @@
##
## If tls is set to true, annotation ingress.kubernetes.io/secure-backends: "true" will automatically be set
# -- Ingress annotations in the form of key-value pairs.
- annotations:
+ annotations: {}
# kubernetes.io/ingress.class: nginx
# kubernetes.io/tls-acme: true
@@ -493,6 +618,31 @@
# - name: longhorn.local-tls
# key:
# certificate:
+httproute:
+ # -- Setting that allows Longhorn to generate HTTPRoute records for the Longhorn UI service using Gateway API.
+ enabled: false
+ # -- Gateway references for HTTPRoute. Specify which Gateway(s) should handle this route.
+ parentRefs: []
+ ## Example:
+ # - name: gateway-name
+ # namespace: gateway-namespace
+ # # Optional fields with defaults:
+ # # group: gateway.networking.k8s.io # default
+ # # kind: Gateway # default
+ # # sectionName: https # optional, targets a specific listener
+ # -- List of hostnames for the HTTPRoute. Multiple hostnames are supported.
+ hostnames: []
+ ## Example:
+ # - longhorn.example.com
+ # - longhorn.example.org
+ # -- Default path for HTTPRoute. You can access the Longhorn UI by following the full path.
+ path: /
+ # -- Path match type for HTTPRoute. (Options: "Exact", "PathPrefix")
+ pathType: PathPrefix
+ # -- Annotations for the HTTPRoute resource in the form of key-value pairs.
+ annotations: {}
+ ## Example:
+ # annotation-key1: "annotation-value1"
# -- Setting that allows you to enable pod security policies (PSPs) that allow privileged Longhorn pods to start. This setting applies only to clusters running Kubernetes 1.25 and earlier, and with the built-in Pod Security admission controller enabled.
enablePSP: false
# -- Specify override namespace, specifically this is useful for using longhorn as sub-chart and its release namespace is not the `longhorn-system`.
@@ -522,6 +672,8 @@
# documentation](https://prometheus-operator.dev/docs/api-reference/api/#monitoring.coreos.com/v1.Endpoint) for
# formatting details.
metricRelabelings: []
+ # -- Per-scrape sample limit. A value of 0 (default) omits sampleLimit.
+ sampleLimit: 0
## openshift settings
openshift:
# -- Setting that allows Longhorn to integrate with OpenShift.