blob: b53b0fef244b81ca6487a36f3be5bcd5413995f8 [file] [log] [blame]
gio16bb6382025-05-21 18:42:40 +04001categories:
2- storage
3namespace: longhorn-system
4questions:
5- variable: image.defaultImage
6 default: "true"
7 description: "Use default Longhorn images"
8 label: Use Default Images
9 type: boolean
10 show_subquestion_if: false
11 group: "Longhorn Images"
12 subquestions:
13 - variable: image.longhorn.manager.repository
14 default: longhornio/longhorn-manager
15 description: "Specify Longhorn Manager Image Repository"
16 type: string
17 label: Longhorn Manager Image Repository
18 group: "Longhorn Images Settings"
19 - variable: image.longhorn.manager.tag
20 default: v1.5.2
21 description: "Specify Longhorn Manager Image Tag"
22 type: string
23 label: Longhorn Manager Image Tag
24 group: "Longhorn Images Settings"
25 - variable: image.longhorn.engine.repository
26 default: longhornio/longhorn-engine
27 description: "Specify Longhorn Engine Image Repository"
28 type: string
29 label: Longhorn Engine Image Repository
30 group: "Longhorn Images Settings"
31 - variable: image.longhorn.engine.tag
32 default: v1.5.2
33 description: "Specify Longhorn Engine Image Tag"
34 type: string
35 label: Longhorn Engine Image Tag
36 group: "Longhorn Images Settings"
37 - variable: image.longhorn.ui.repository
38 default: longhornio/longhorn-ui
39 description: "Specify Longhorn UI Image Repository"
40 type: string
41 label: Longhorn UI Image Repository
42 group: "Longhorn Images Settings"
43 - variable: image.longhorn.ui.tag
44 default: v1.5.2
45 description: "Specify Longhorn UI Image Tag"
46 type: string
47 label: Longhorn UI Image Tag
48 group: "Longhorn Images Settings"
49 - variable: image.longhorn.instanceManager.repository
50 default: longhornio/longhorn-instance-manager
51 description: "Specify Longhorn Instance Manager Image Repository"
52 type: string
53 label: Longhorn Instance Manager Image Repository
54 group: "Longhorn Images Settings"
55 - variable: image.longhorn.instanceManager.tag
56 default: v1.5.2
57 description: "Specify Longhorn Instance Manager Image Tag"
58 type: string
59 label: Longhorn Instance Manager Image Tag
60 group: "Longhorn Images Settings"
61 - variable: image.longhorn.shareManager.repository
62 default: longhornio/longhorn-share-manager
63 description: "Specify Longhorn Share Manager Image Repository"
64 type: string
65 label: Longhorn Share Manager Image Repository
66 group: "Longhorn Images Settings"
67 - variable: image.longhorn.shareManager.tag
68 default: v1.5.2
69 description: "Specify Longhorn Share Manager Image Tag"
70 type: string
71 label: Longhorn Share Manager Image Tag
72 group: "Longhorn Images Settings"
73 - variable: image.longhorn.backingImageManager.repository
74 default: longhornio/backing-image-manager
75 description: "Specify Longhorn Backing Image Manager Image Repository"
76 type: string
77 label: Longhorn Backing Image Manager Image Repository
78 group: "Longhorn Images Settings"
79 - variable: image.longhorn.backingImageManager.tag
80 default: v1.5.2
81 description: "Specify Longhorn Backing Image Manager Image Tag"
82 type: string
83 label: Longhorn Backing Image Manager Image Tag
84 group: "Longhorn Images Settings"
85 - variable: image.longhorn.supportBundleKit.repository
86 default: longhornio/support-bundle-kit
87 description: "Specify Longhorn Support Bundle Manager Image Repository"
88 type: string
89 label: Longhorn Support Bundle Kit Image Repository
90 group: "Longhorn Images Settings"
91 - variable: image.longhorn.supportBundleKit.tag
92 default: v0.0.27
93 description: "Specify Longhorn Support Bundle Manager Image Tag"
94 type: string
95 label: Longhorn Support Bundle Kit Image Tag
96 group: "Longhorn Images Settings"
97 - variable: image.csi.attacher.repository
98 default: longhornio/csi-attacher
99 description: "Specify CSI attacher image repository. Leave blank to autodetect."
100 type: string
101 label: Longhorn CSI Attacher Image Repository
102 group: "Longhorn CSI Driver Images"
103 - variable: image.csi.attacher.tag
104 default: v4.2.0
105 description: "Specify CSI attacher image tag. Leave blank to autodetect."
106 type: string
107 label: Longhorn CSI Attacher Image Tag
108 group: "Longhorn CSI Driver Images"
109 - variable: image.csi.provisioner.repository
110 default: longhornio/csi-provisioner
111 description: "Specify CSI provisioner image repository. Leave blank to autodetect."
112 type: string
113 label: Longhorn CSI Provisioner Image Repository
114 group: "Longhorn CSI Driver Images"
115 - variable: image.csi.provisioner.tag
116 default: v3.4.1
117 description: "Specify CSI provisioner image tag. Leave blank to autodetect."
118 type: string
119 label: Longhorn CSI Provisioner Image Tag
120 group: "Longhorn CSI Driver Images"
121 - variable: image.csi.nodeDriverRegistrar.repository
122 default: longhornio/csi-node-driver-registrar
123 description: "Specify CSI Node Driver Registrar image repository. Leave blank to autodetect."
124 type: string
125 label: Longhorn CSI Node Driver Registrar Image Repository
126 group: "Longhorn CSI Driver Images"
127 - variable: image.csi.nodeDriverRegistrar.tag
128 default: v2.7.0
129 description: "Specify CSI Node Driver Registrar image tag. Leave blank to autodetect."
130 type: string
131 label: Longhorn CSI Node Driver Registrar Image Tag
132 group: "Longhorn CSI Driver Images"
133 - variable: image.csi.resizer.repository
134 default: longhornio/csi-resizer
135 description: "Specify CSI Driver Resizer image repository. Leave blank to autodetect."
136 type: string
137 label: Longhorn CSI Driver Resizer Image Repository
138 group: "Longhorn CSI Driver Images"
139 - variable: image.csi.resizer.tag
140 default: v1.7.0
141 description: "Specify CSI Driver Resizer image tag. Leave blank to autodetect."
142 type: string
143 label: Longhorn CSI Driver Resizer Image Tag
144 group: "Longhorn CSI Driver Images"
145 - variable: image.csi.snapshotter.repository
146 default: longhornio/csi-snapshotter
147 description: "Specify CSI Driver Snapshotter image repository. Leave blank to autodetect."
148 type: string
149 label: Longhorn CSI Driver Snapshotter Image Repository
150 group: "Longhorn CSI Driver Images"
151 - variable: image.csi.snapshotter.tag
152 default: v6.2.1
153 description: "Specify CSI Driver Snapshotter image tag. Leave blank to autodetect."
154 type: string
155 label: Longhorn CSI Driver Snapshotter Image Tag
156 group: "Longhorn CSI Driver Images"
157 - variable: image.csi.livenessProbe.repository
158 default: longhornio/livenessprobe
159 description: "Specify CSI liveness probe image repository. Leave blank to autodetect."
160 type: string
161 label: Longhorn CSI Liveness Probe Image Repository
162 group: "Longhorn CSI Driver Images"
163 - variable: image.csi.livenessProbe.tag
164 default: v2.9.0
165 description: "Specify CSI liveness probe image tag. Leave blank to autodetect."
166 type: string
167 label: Longhorn CSI Liveness Probe Image Tag
168 group: "Longhorn CSI Driver Images"
169- variable: privateRegistry.registryUrl
170 label: Private registry URL
171 description: "URL of private registry. Leave blank to apply system default registry."
172 group: "Private Registry Settings"
173 type: string
174 default: ""
175- variable: privateRegistry.registrySecret
176 label: Private registry secret name
177 description: "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."
178 group: "Private Registry Settings"
179 type: string
180 default: ""
181- variable: privateRegistry.createSecret
182 default: "true"
183 description: "Create a new private registry secret"
184 type: boolean
185 group: "Private Registry Settings"
186 label: Create Secret for Private Registry Settings
187 show_subquestion_if: true
188 subquestions:
189 - variable: privateRegistry.registryUser
190 label: Private registry user
191 description: "User used to authenticate to private registry."
192 type: string
193 default: ""
194 - variable: privateRegistry.registryPasswd
195 label: Private registry password
196 description: "Password used to authenticate to private registry."
197 type: password
198 default: ""
199- variable: longhorn.default_setting
200 default: "false"
201 description: "Customize the default settings before installing Longhorn for the first time. This option will only work if the cluster hasn't installed Longhorn."
202 label: "Customize Default Settings"
203 type: boolean
204 show_subquestion_if: true
205 group: "Longhorn Default Settings"
206 subquestions:
207 - variable: csi.kubeletRootDir
208 default:
209 description: "Specify kubelet root-dir. Leave blank to autodetect."
210 type: string
211 label: Kubelet Root Directory
212 group: "Longhorn CSI Driver Settings"
213 - variable: csi.attacherReplicaCount
214 type: int
215 default: 3
216 min: 1
217 max: 10
218 description: "Specify replica count of CSI Attacher. By default 3."
219 label: Longhorn CSI Attacher replica count
220 group: "Longhorn CSI Driver Settings"
221 - variable: csi.provisionerReplicaCount
222 type: int
223 default: 3
224 min: 1
225 max: 10
226 description: "Specify replica count of CSI Provisioner. By default 3."
227 label: Longhorn CSI Provisioner replica count
228 group: "Longhorn CSI Driver Settings"
229 - variable: csi.resizerReplicaCount
230 type: int
231 default: 3
232 min: 1
233 max: 10
234 description: "Specify replica count of CSI Resizer. By default 3."
235 label: Longhorn CSI Resizer replica count
236 group: "Longhorn CSI Driver Settings"
237 - variable: csi.snapshotterReplicaCount
238 type: int
239 default: 3
240 min: 1
241 max: 10
242 description: "Specify replica count of CSI Snapshotter. By default 3."
243 label: Longhorn CSI Snapshotter replica count
244 group: "Longhorn CSI Driver Settings"
245 - variable: defaultSettings.backupTarget
246 label: Backup Target
247 description: "The endpoint used to access the backupstore. NFS and S3 are supported."
248 group: "Longhorn Default Settings"
249 type: string
250 default:
251 - variable: defaultSettings.backupTargetCredentialSecret
252 label: Backup Target Credential Secret
253 description: "The name of the Kubernetes secret associated with the backup target."
254 group: "Longhorn Default Settings"
255 type: string
256 default:
257 - variable: defaultSettings.allowRecurringJobWhileVolumeDetached
258 label: Allow Recurring Job While Volume Is Detached
259 description: 'If this setting is enabled, Longhorn will automatically attaches the volume and takes snapshot/backup when it is the time to do recurring snapshot/backup.
260Note that the volume is not ready for workload during the period when the volume was automatically attached. Workload will have to wait until the recurring job finishes.'
261 group: "Longhorn Default Settings"
262 type: boolean
263 default: "false"
264 - variable: defaultSettings.createDefaultDiskLabeledNodes
265 label: Create Default Disk on Labeled Nodes
266 description: 'Create default Disk automatically only on Nodes with the label "node.longhorn.io/create-default-disk=true" if no other disks exist. If disabled, the default disk will be created on all new nodes when each node is first added.'
267 group: "Longhorn Default Settings"
268 type: boolean
269 default: "false"
270 - variable: defaultSettings.defaultDataPath
271 label: Default Data Path
272 description: 'Default path to use for storing data on a host. By default "/var/lib/longhorn/"'
273 group: "Longhorn Default Settings"
274 type: string
275 default: "/var/lib/longhorn/"
276 - variable: defaultSettings.defaultDataLocality
277 label: Default Data Locality
278 description: 'We say a Longhorn volume has data locality if there is a local replica of the volume on the same node as the pod which is using the volume.
279This setting specifies the default data locality when a volume is created from the Longhorn UI. For Kubernetes configuration, update the `dataLocality` in the StorageClass
280The available modes are:
281- **disabled**. This is the default option. There may or may not be a replica on the same node as the attached volume (workload)
282- **best-effort**. This option instructs Longhorn to try to keep a replica on the same node as the attached volume (workload). Longhorn will not stop the volume, even if it cannot keep a replica local to the attached volume (workload) due to environment limitation, e.g. not enough disk space, incompatible disk tags, etc.'
283 group: "Longhorn Default Settings"
284 type: enum
285 options:
286 - "disabled"
287 - "best-effort"
288 default: "disabled"
289 - variable: defaultSettings.replicaSoftAntiAffinity
290 label: Replica Node Level Soft Anti-Affinity
291 description: 'Allow scheduling on nodes with existing healthy replicas of the same volume. By default false.'
292 group: "Longhorn Default Settings"
293 type: boolean
294 default: "false"
295 - variable: defaultSettings.replicaAutoBalance
296 label: Replica Auto Balance
297 description: 'Enable this setting automatically rebalances replicas when discovered an available node.
298The available global options are:
299- **disabled**. This is the default option. No replica auto-balance will be done.
300- **least-effort**. This option instructs Longhorn to balance replicas for minimal redundancy.
301- **best-effort**. This option instructs Longhorn to balance replicas for even redundancy.
302Longhorn also support individual volume setting. The setting can be specified in volume.spec.replicaAutoBalance, this overrules the global setting.
303The available volume spec options are:
304- **ignored**. This is the default option that instructs Longhorn to inherit from the global setting.
305- **disabled**. This option instructs Longhorn no replica auto-balance should be done.
306- **least-effort**. This option instructs Longhorn to balance replicas for minimal redundancy.
307- **best-effort**. This option instructs Longhorn to balance replicas for even redundancy.'
308 group: "Longhorn Default Settings"
309 type: enum
310 options:
311 - "disabled"
312 - "least-effort"
313 - "best-effort"
314 default: "disabled"
315 - variable: defaultSettings.storageOverProvisioningPercentage
316 label: Storage Over Provisioning Percentage
317 description: "The over-provisioning percentage defines how much storage can be allocated relative to the hard drive's capacity. By default 200."
318 group: "Longhorn Default Settings"
319 type: int
320 min: 0
321 default: 200
322 - variable: defaultSettings.storageMinimalAvailablePercentage
323 label: Storage Minimal Available Percentage
324 description: "If the minimum available disk capacity exceeds the actual percentage of available disk capacity, the disk becomes unschedulable until more space is freed up. By default 25."
325 group: "Longhorn Default Settings"
326 type: int
327 min: 0
328 max: 100
329 default: 25
330 - variable: defaultSettings.storageReservedPercentageForDefaultDisk
331 label: Storage Reserved Percentage For Default Disk
332 description: "The reserved percentage specifies the percentage of disk space that will not be allocated to the default disk on each new Longhorn node."
333 group: "Longhorn Default Settings"
334 type: int
335 min: 0
336 max: 100
337 default: 30
338 - variable: defaultSettings.upgradeChecker
339 label: Enable Upgrade Checker
340 description: 'Upgrade Checker will check for new Longhorn version periodically. When there is a new version available, a notification will appear in the UI. By default true.'
341 group: "Longhorn Default Settings"
342 type: boolean
343 default: "true"
344 - variable: defaultSettings.defaultReplicaCount
345 label: Default Replica Count
346 description: "The default number of replicas when a volume is created from the Longhorn UI. For Kubernetes configuration, update the `numberOfReplicas` in the StorageClass. By default 3."
347 group: "Longhorn Default Settings"
348 type: int
349 min: 1
350 max: 20
351 default: 3
352 - variable: defaultSettings.defaultLonghornStaticStorageClass
353 label: Default Longhorn Static StorageClass Name
354 description: "The 'storageClassName' is given to PVs and PVCs that are created for an existing Longhorn volume. The StorageClass name 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. By default 'longhorn-static'."
355 group: "Longhorn Default Settings"
356 type: string
357 default: "longhorn-static"
358 - variable: defaultSettings.backupstorePollInterval
359 label: Backupstore Poll Interval
360 description: "In seconds. The backupstore poll interval determines how often Longhorn checks the backupstore for new backups. Set to 0 to disable the polling. By default 300."
361 group: "Longhorn Default Settings"
362 type: int
363 min: 0
364 default: 300
365 - variable: defaultSettings.failedBackupTTL
366 label: Failed Backup Time to Live
367 description: "In minutes. This setting determines how long Longhorn will keep the backup resource that was failed. Set to 0 to disable the auto-deletion.
368Failed backups will be checked and cleaned up during backupstore polling which is controlled by **Backupstore Poll Interval** setting.
369Hence this value determines the minimal wait interval of the cleanup. And the actual cleanup interval is multiple of **Backupstore Poll Interval**.
370Disabling **Backupstore Poll Interval** also means to disable failed backup auto-deletion."
371 group: "Longhorn Default Settings"
372 type: int
373 min: 0
374 default: 1440
375 - variable: defaultSettings.restoreVolumeRecurringJobs
376 label: Restore Volume Recurring Jobs
377 description: "Restore recurring jobs from the backup volume on the backup target and create recurring jobs if not exist during a backup restoration.
378Longhorn also supports individual volume setting. The setting can be specified on Backup page when making a backup restoration, this overrules the global setting.
379The available volume setting options are:
380- **ignored**. This is the default option that instructs Longhorn to inherit from the global setting.
381- **enabled**. This option instructs Longhorn to restore recurring jobs/groups from the backup target forcibly.
382- **disabled**. This option instructs Longhorn no restoring recurring jobs/groups should be done."
383 group: "Longhorn Default Settings"
384 type: boolean
385 default: "false"
386 - variable: defaultSettings.recurringSuccessfulJobsHistoryLimit
387 label: Cronjob Successful Jobs History Limit
388 description: "This setting specifies how many successful backup or snapshot job histories should be retained. History will not be retained if the value is 0."
389 group: "Longhorn Default Settings"
390 type: int
391 min: 0
392 default: 1
393 - variable: defaultSettings.recurringFailedJobsHistoryLimit
394 label: Cronjob Failed Jobs History Limit
395 description: "This setting specifies how many failed backup or snapshot job histories should be retained. History will not be retained if the value is 0."
396 group: "Longhorn Default Settings"
397 type: int
398 min: 0
399 default: 1
400 - variable: defaultSettings.supportBundleFailedHistoryLimit
401 label: SupportBundle Failed History Limit
402 description: "This setting specifies how many failed support bundles can exist in the cluster.
403The retained failed support bundle is for analysis purposes and needs to clean up manually.
404Set this value to **0** to have Longhorn automatically purge all failed support bundles."
405 group: "Longhorn Default Settings"
406 type: int
407 min: 0
408 default: 1
409 - variable: defaultSettings.autoSalvage
410 label: Automatic salvage
411 description: "If enabled, volumes will be automatically salvaged when all the replicas become faulty e.g. due to network disconnection. Longhorn will try to figure out which replica(s) are usable, then use them for the volume. By default true."
412 group: "Longhorn Default Settings"
413 type: boolean
414 default: "true"
415 - variable: defaultSettings.autoDeletePodWhenVolumeDetachedUnexpectedly
416 label: Automatically Delete Workload Pod when The Volume Is Detached Unexpectedly
417 description: 'If enabled, Longhorn will automatically delete the workload pod that is managed by a controller (e.g. deployment, statefulset, daemonset, etc...) when Longhorn volume is detached unexpectedly (e.g. during Kubernetes upgrade, Docker reboot, or network disconnect). By deleting the pod, its controller restarts the pod and Kubernetes handles volume reattachment and remount.
418If disabled, Longhorn will not delete the workload pod that is managed by a controller. You will have to manually restart the pod to reattach and remount the volume.
419**Note:** This setting does not apply to the workload pods that do not have a controller. Longhorn never deletes them.'
420 group: "Longhorn Default Settings"
421 type: boolean
422 default: "true"
423 - variable: defaultSettings.disableSchedulingOnCordonedNode
424 label: Disable Scheduling On Cordoned Node
425 description: "Disable Longhorn manager to schedule replica on Kubernetes cordoned node. By default true."
426 group: "Longhorn Default Settings"
427 type: boolean
428 default: "true"
429 - variable: defaultSettings.replicaZoneSoftAntiAffinity
430 label: Replica Zone Level Soft Anti-Affinity
431 description: "Allow scheduling new Replicas of Volume to the Nodes in the same Zone as existing healthy Replicas. Nodes don't belong to any Zone will be treated as in the same Zone. Notice that Longhorn relies on label `topology.kubernetes.io/zone=<Zone name of the node>` in the Kubernetes node object to identify the zone. By default true."
432 group: "Longhorn Default Settings"
433 type: boolean
434 default: "true"
435 - variable: defaultSettings.nodeDownPodDeletionPolicy
436 label: Pod Deletion Policy When Node is Down
437 description: "Defines the Longhorn action when a Volume is stuck with a StatefulSet/Deployment Pod on a node that is down.
438- **do-nothing** is the default Kubernetes behavior of never force deleting StatefulSet/Deployment terminating pods. Since the pod on the node that is down isn't removed, Longhorn volumes are stuck on nodes that are down.
439- **delete-statefulset-pod** Longhorn will force delete StatefulSet terminating pods on nodes that are down to release Longhorn volumes so that Kubernetes can spin up replacement pods.
440- **delete-deployment-pod** Longhorn will force delete Deployment terminating pods on nodes that are down to release Longhorn volumes so that Kubernetes can spin up replacement pods.
441- **delete-both-statefulset-and-deployment-pod** Longhorn will force delete StatefulSet/Deployment terminating pods on nodes that are down to release Longhorn volumes so that Kubernetes can spin up replacement pods."
442 group: "Longhorn Default Settings"
443 type: enum
444 options:
445 - "do-nothing"
446 - "delete-statefulset-pod"
447 - "delete-deployment-pod"
448 - "delete-both-statefulset-and-deployment-pod"
449 default: "do-nothing"
450 - variable: defaultSettings.nodeDrainPolicy
451 label: Node Drain Policy
452 description: "Define the policy to use when a node with the last healthy replica of a volume is drained.
453- **block-if-contains-last-replica** Longhorn will block the drain when the node contains the last healthy replica of a volume.
454- **allow-if-replica-is-stopped** Longhorn will allow the drain when the node contains the last healthy replica of a volume but the replica is stopped. WARNING: possible data loss if the node is removed after draining. Select this option if you want to drain the node and do in-place upgrade/maintenance.
455- **always-allow** Longhorn will allow the drain even though the node contains the last healthy replica of a volume. WARNING: possible data loss if the node is removed after draining. Also possible data corruption if the last replica was running during the draining."
456 group: "Longhorn Default Settings"
457 type: enum
458 options:
459 - "block-if-contains-last-replica"
460 - "allow-if-replica-is-stopped"
461 - "always-allow"
462 default: "block-if-contains-last-replica"
463 - variable: defaultSettings.replicaReplenishmentWaitInterval
464 label: Replica Replenishment Wait Interval
465 description: "In seconds. The interval determines how long Longhorn will wait at least in order to reuse the existing data on a failed replica rather than directly creating a new replica for a degraded volume.
466Warning: This option works only when there is a failed replica in the volume. And this option may block the rebuilding for a while in the case."
467 group: "Longhorn Default Settings"
468 type: int
469 min: 0
470 default: 600
471 - variable: defaultSettings.concurrentReplicaRebuildPerNodeLimit
472 label: Concurrent Replica Rebuild Per Node Limit
473 description: "This setting controls how many replicas on a node can be rebuilt simultaneously.
474Typically, Longhorn can block the replica starting once the current rebuilding count on a node exceeds the limit. But when the value is 0, it means disabling the replica rebuilding.
475WARNING:
476- The old setting \"Disable Replica Rebuild\" is replaced by this setting.
477- Different from relying on replica starting delay to limit the concurrent rebuilding, if the rebuilding is disabled, replica object replenishment will be directly skipped.
478- When the value is 0, the eviction and data locality feature won't work. But this shouldn't have any impact to any current replica rebuild and backup restore."
479 group: "Longhorn Default Settings"
480 type: int
481 min: 0
482 default: 5
483 - variable: defaultSettings.concurrentVolumeBackupRestorePerNodeLimit
484 label: Concurrent Volume Backup Restore Per Node Limit
485 description: "This setting controls how many volumes on a node can restore the backup concurrently.
486Longhorn blocks the backup restore once the restoring volume count exceeds the limit.
487Set the value to **0** to disable backup restore."
488 group: "Longhorn Default Settings"
489 type: int
490 min: 0
491 default: 5
492 - variable: defaultSettings.disableRevisionCounter
493 label: Disable Revision Counter
494 description: "This setting is only for volumes created by UI. By default, this is false meaning there will be a reivision counter file to track every write to the volume. During salvage recovering Longhorn will pick the replica with largest reivision counter as candidate to recover the whole volume. If revision counter is disabled, Longhorn will not track every write to the volume. During the salvage recovering, Longhorn will use the 'volume-head-xxx.img' file last modification time and file size to pick the replica candidate to recover the whole volume."
495 group: "Longhorn Default Settings"
496 type: boolean
497 default: "false"
498 - variable: defaultSettings.systemManagedPodsImagePullPolicy
499 label: System Managed Pod Image Pull Policy
500 description: "This setting defines the Image Pull Policy of Longhorn system managed pods, e.g. instance manager, engine image, CSI driver, etc. The new Image Pull Policy will only apply after the system managed pods restart."
501 group: "Longhorn Default Settings"
502 type: enum
503 options:
504 - "if-not-present"
505 - "always"
506 - "never"
507 default: "if-not-present"
508 - variable: defaultSettings.allowVolumeCreationWithDegradedAvailability
509 label: Allow Volume Creation with Degraded Availability
510 description: "This setting allows user to create and attach a volume that doesn't have all the replicas scheduled at the time of creation."
511 group: "Longhorn Default Settings"
512 type: boolean
513 default: "true"
514 - variable: defaultSettings.autoCleanupSystemGeneratedSnapshot
515 label: Automatically Cleanup System Generated Snapshot
516 description: "This setting enables Longhorn to automatically cleanup the system generated snapshot after replica rebuild is done."
517 group: "Longhorn Default Settings"
518 type: boolean
519 default: "true"
520 - variable: defaultSettings.concurrentAutomaticEngineUpgradePerNodeLimit
521 label: Concurrent Automatic Engine Upgrade Per Node Limit
522 description: "This setting controls how Longhorn automatically upgrades volumes' engines to the new default engine image after upgrading Longhorn manager. The value of this setting specifies the maximum number of engines per node that are allowed to upgrade to the default engine image at the same time. If the value is 0, Longhorn will not automatically upgrade volumes' engines to default version."
523 group: "Longhorn Default Settings"
524 type: int
525 min: 0
526 default: 0
527 - variable: defaultSettings.backingImageCleanupWaitInterval
528 label: Backing Image Cleanup Wait Interval
529 description: "This interval in minutes determines how long Longhorn will wait before cleaning up the backing image file when there is no replica in the disk using it."
530 group: "Longhorn Default Settings"
531 type: int
532 min: 0
533 default: 60
534 - variable: defaultSettings.backingImageRecoveryWaitInterval
535 label: Backing Image Recovery Wait Interval
536 description: "This interval in seconds determines how long Longhorn will wait before re-downloading the backing image file when all disk files of this backing image become failed or unknown.
537 WARNING:
538 - This recovery only works for the backing image of which the creation type is \"download\".
539 - File state \"unknown\" means the related manager pods on the pod is not running or the node itself is down/disconnected."
540 group: "Longhorn Default Settings"
541 type: int
542 min: 0
543 default: 300
544 - variable: defaultSettings.guaranteedInstanceManagerCPU
545 label: Guaranteed Instance Manager CPU
546 description: "This integer value indicates how many percentage of the total allocatable CPU on each node will be reserved for each instance manager Pod. For example, 10 means 10% of the total CPU on a node will be allocated to each instance manager pod on this node. This will help maintain engine and replica stability during high node workload.
547 In order to prevent unexpected volume instance (engine/replica) crash as well as guarantee a relative acceptable IO performance, you can use the following formula to calculate a value for this setting:
548 `Guaranteed Instance Manager CPU = The estimated max Longhorn volume engine and replica count on a node * 0.1 / The total allocatable CPUs on the node * 100`
549 The result of above calculation doesn't mean that's the maximum CPU resources the Longhorn workloads require. To fully exploit the Longhorn volume I/O performance, you can allocate/guarantee more CPU resources via this setting.
550 If it's hard to estimate the usage now, you can leave it with the default value, which is 12%. Then you can tune it when there is no running workload using Longhorn volumes.
551 WARNING:
552 - Value 0 means unsetting CPU requests for instance manager pods.
553 - Considering the possible new instance manager pods in the further system upgrade, this integer value is range from 0 to 40.
554 - One more set of instance manager pods may need to be deployed when the Longhorn system is upgraded. If current available CPUs of the nodes are not enough for the new instance manager pods, you need to detach the volumes using the oldest instance manager pods so that Longhorn can clean up the old pods automatically and release the CPU resources. And the new pods with the latest instance manager image will be launched then.
555 - This global setting will be ignored for a node if the field \"InstanceManagerCPURequest\" on the node is set.
556 - After this setting is changed, all instance manager pods using this global setting on all the nodes will be automatically restarted. In other words, DO NOT CHANGE THIS SETTING WITH ATTACHED VOLUMES."
557 group: "Longhorn Default Settings"
558 type: int
559 min: 0
560 max: 40
561 default: 12
562 - variable: defaultSettings.logLevel
563 label: Log Level
564 description: "The log level Panic, Fatal, Error, Warn, Info, Debug, Trace used in longhorn manager. By default Debug."
565 group: "Longhorn Default Settings"
566 type: string
567 default: "Info"
568- variable: defaultSettings.kubernetesClusterAutoscalerEnabled
569 label: Kubernetes Cluster Autoscaler Enabled (Experimental)
570 description: "Enabling this setting will notify Longhorn that the cluster is using Kubernetes Cluster Autoscaler.
571 Longhorn prevents data loss by only allowing the Cluster Autoscaler to scale down a node that met all conditions:
572 - No volume attached to the node.
573 - Is not the last node containing the replica of any volume.
574 - Is not running backing image components pod.
575 - Is not running share manager components pod."
576 group: "Longhorn Default Settings"
577 type: boolean
578 default: false
579- variable: defaultSettings.orphanAutoDeletion
580 label: Orphaned Data Cleanup
581 description: "This setting allows Longhorn to delete the orphan resource and its corresponding orphaned data automatically like stale replicas. Orphan resources on down or unknown nodes will not be cleaned up automatically."
582 group: "Longhorn Default Settings"
583 type: boolean
584 default: false
585- variable: defaultSettings.storageNetwork
586 label: Storage Network
587 description: "Longhorn uses the storage network for in-cluster data traffic. Leave this blank to use the Kubernetes cluster network.
588 To segregate the storage network, input the pre-existing NetworkAttachmentDefinition in \"<namespace>/<name>\" format.
589 WARNING:
590 - The cluster must have pre-existing Multus installed, and NetworkAttachmentDefinition IPs are reachable between nodes.
591 - DO NOT CHANGE THIS SETTING WITH ATTACHED VOLUMES. Longhorn will try to block this setting update when there are attached volumes.
592 - When applying the setting, Longhorn will restart all manager, instance-manager, and backing-image-manager pods."
593 group: "Longhorn Default Settings"
594 type: string
595 default:
596- variable: defaultSettings.deletingConfirmationFlag
597 label: Deleting Confirmation Flag
598 description: "This flag is designed to prevent Longhorn from being accidentally uninstalled which will lead to data lost.
599 Set this flag to **true** to allow Longhorn uninstallation.
600 If this flag **false**, Longhorn uninstallation job will fail. "
601 group: "Longhorn Default Settings"
602 type: boolean
603 default: "false"
604- variable: defaultSettings.engineReplicaTimeout
605 label: Timeout between Engine and Replica
606 description: "In seconds. The setting specifies the timeout between the engine and replica(s), and the value should be between 8 to 30 seconds. The default value is 8 seconds."
607 group: "Longhorn Default Settings"
608 type: int
609 default: "8"
610- variable: defaultSettings.snapshotDataIntegrity
611 label: Snapshot Data Integrity
612 description: "This setting allows users to enable or disable snapshot hashing and data integrity checking.
613 Available options are
614 - **disabled**: Disable snapshot disk file hashing and data integrity checking.
615 - **enabled**: Enables periodic snapshot disk file hashing and data integrity checking. To detect the filesystem-unaware corruption caused by bit rot or other issues in snapshot disk files, Longhorn system periodically hashes files and finds corrupted ones. Hence, the system performance will be impacted during the periodical checking.
616 - **fast-check**: Enable snapshot disk file hashing and fast data integrity checking. Longhorn system only hashes snapshot disk files if their are not hashed or the modification time are changed. In this mode, filesystem-unaware corruption cannot be detected, but the impact on system performance can be minimized."
617 group: "Longhorn Default Settings"
618 type: string
619 default: "disabled"
620- variable: defaultSettings.snapshotDataIntegrityImmediateCheckAfterSnapshotCreation
621 label: Immediate Snapshot Data Integrity Check After Creating a Snapshot
622 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."
623 group: "Longhorn Default Settings"
624 type: boolean
625 default: "false"
626- variable: defaultSettings.snapshotDataIntegrityCronjob
627 label: Snapshot Data Integrity Check CronJob
628 description: "Unix-cron string format. The setting specifies when Longhorn checks the data integrity of snapshot disk files.
629 Warning: Hashing snapshot disk files impacts the performance of the system. It is recommended to run data integrity checks during off-peak times and to reduce the frequency of checks."
630 group: "Longhorn Default Settings"
631 type: string
632 default: "0 0 */7 * *"
633- variable: defaultSettings.removeSnapshotsDuringFilesystemTrim
634 label: Remove Snapshots During Filesystem Trim
635 description: "This setting allows Longhorn filesystem trim feature to automatically mark the latest snapshot and its ancestors as removed and stops at the snapshot containing multiple children.\n\n
636 Since Longhorn filesystem trim feature can be applied to the volume head and the followed continuous removed or system snapshots only.\n\n
637 Notice that trying to trim a removed files from a valid snapshot will do nothing but the filesystem will discard this kind of in-memory trimmable file info.\n\n
638 Later on if you mark the snapshot as removed and want to retry the trim, you may need to unmount and remount the filesystem so that the filesystem can recollect the trimmable file info."
639 group: "Longhorn Default Settings"
640 type: boolean
641 default: "false"
642- variable: defaultSettings.fastReplicaRebuildEnabled
643 label: Fast Replica Rebuild Enabled
644 description: "This feature supports the fast replica rebuilding. It relies on the checksum of snapshot disk files, so setting the snapshot-data-integrity to **enable** or **fast-check** is a prerequisite."
645 group: "Longhorn Default Settings"
646 type: boolean
647 default: false
648- variable: defaultSettings.replicaFileSyncHttpClientTimeout
649 label: Timeout of HTTP Client to Replica File Sync Server
650 description: "In seconds. The setting specifies the HTTP client timeout to the file sync server."
651 group: "Longhorn Default Settings"
652 type: int
653 default: "30"
654- variable: defaultSettings.backupCompressionMethod
655 label: Backup Compression Method
656 description: "This setting allows users to specify backup compression method.
657 Available options are
658 - **none**: Disable the compression method. Suitable for multimedia data such as encoded images and videos.
659 - **lz4**: Fast compression method. Suitable for flat files.
660 - **gzip**: A bit of higher compression ratio but relatively slow."
661 group: "Longhorn Default Settings"
662 type: string
663 default: "lz4"
664- variable: defaultSettings.backupConcurrentLimit
665 label: Backup Concurrent Limit Per Backup
666 description: "This setting controls how many worker threads per backup concurrently."
667 group: "Longhorn Default Settings"
668 type: int
669 min: 1
670 default: 2
671- variable: defaultSettings.restoreConcurrentLimit
672 label: Restore Concurrent Limit Per Backup
673 description: "This setting controls how many worker threads per restore concurrently."
674 group: "Longhorn Default Settings"
675 type: int
676 min: 1
677 default: 2
678- variable: defaultSettings.v2DataEngine
679 label: V2 Data Engine
680 description: "This allows users to activate v2 data engine based on SPDK. Currently, it is in the preview phase and should not be utilized in a production environment.
681 WARNING:
682 - DO NOT CHANGE THIS SETTING WITH ATTACHED VOLUMES. Longhorn will block this setting update when there are attached volumes.
683 - When applying the setting, Longhorn will restart all instance-manager pods.
684 - When the V2 Data Engine is enabled, each instance-manager pod utilizes 1 CPU core. This high CPU usage is attributed to the spdk_tgt process running within each instance-manager pod. The spdk_tgt process is responsible for handling input/output (IO) operations and requires intensive polling. As a result, it consumes 100% of a dedicated CPU core to efficiently manage and process the IO requests, ensuring optimal performance and responsiveness for storage operations."
685 group: "Longhorn V2 Data Engine (Preview Feature) Settings"
686 type: boolean
687 default: false
688- variable: defaultSettings.offlineReplicaRebuilding
689 label: Offline Replica Rebuilding
690 description: ""This setting allows users to enable the offline replica rebuilding for volumes using v2 data engine."
691 group: "Longhorn V2 Data Engine (Preview Feature) Settings"
692 required: true
693 type: enum
694 options:
695 - "enabled"
696 - "disabled"
697 default: "enabled"
698- variable: persistence.defaultClass
699 default: "true"
700 description: "Set as default StorageClass for Longhorn"
701 label: Default Storage Class
702 group: "Longhorn Storage Class Settings"
703 required: true
704 type: boolean
705- variable: persistence.reclaimPolicy
706 label: Storage Class Retain Policy
707 description: "Define reclaim policy (Retain or Delete)"
708 group: "Longhorn Storage Class Settings"
709 required: true
710 type: enum
711 options:
712 - "Delete"
713 - "Retain"
714 default: "Delete"
715- variable: persistence.defaultClassReplicaCount
716 description: "Set replica count for Longhorn StorageClass"
717 label: Default Storage Class Replica Count
718 group: "Longhorn Storage Class Settings"
719 type: int
720 min: 1
721 max: 10
722 default: 3
723- variable: persistence.defaultDataLocality
724 description: "Set data locality for Longhorn StorageClass"
725 label: Default Storage Class Data Locality
726 group: "Longhorn Storage Class Settings"
727 type: enum
728 options:
729 - "disabled"
730 - "best-effort"
731 default: "disabled"
732- variable: persistence.recurringJobSelector.enable
733 description: "Enable recurring job selector for Longhorn StorageClass"
734 group: "Longhorn Storage Class Settings"
735 label: Enable Storage Class Recurring Job Selector
736 type: boolean
737 default: false
738 show_subquestion_if: true
739 subquestions:
740 - variable: persistence.recurringJobSelector.jobList
741 description: 'Recurring job selector list for Longhorn StorageClass. Please be careful of quotes of input. e.g., [{"name":"backup", "isGroup":true}]'
742 label: Storage Class Recurring Job Selector List
743 group: "Longhorn Storage Class Settings"
744 type: string
745 default:
746- variable: persistence.defaultNodeSelector.enable
747 description: "Enable Node selector for Longhorn StorageClass"
748 group: "Longhorn Storage Class Settings"
749 label: Enable Storage Class Node Selector
750 type: boolean
751 default: false
752 show_subquestion_if: true
753 subquestions:
754 - variable: persistence.defaultNodeSelector.selector
755 label: Storage Class Node Selector
756 description: 'We use NodeSelector when we want to bind PVC via StorageClass into desired mountpoint on the nodes tagged with its value'
757 group: "Longhorn Storage Class Settings"
758 type: string
759 default:
760- variable: persistence.backingImage.enable
761 description: "Set backing image for Longhorn StorageClass"
762 group: "Longhorn Storage Class Settings"
763 label: Default Storage Class Backing Image
764 type: boolean
765 default: false
766 show_subquestion_if: true
767 subquestions:
768 - variable: persistence.backingImage.name
769 description: 'Specify a backing image that will be used by Longhorn volumes in Longhorn StorageClass. If not exists, the backing image data source type and backing image data source parameters should be specified so that Longhorn will create the backing image before using it.'
770 label: Storage Class Backing Image Name
771 group: "Longhorn Storage Class Settings"
772 type: string
773 default:
774 - variable: persistence.backingImage.expectedChecksum
775 description: 'Specify the expected SHA512 checksum of the selected backing image in Longhorn StorageClass.
776 WARNING:
777 - If the backing image name is not specified, setting this field is meaningless.
778 - It is not recommended to set this field if the data source type is \"export-from-volume\".'
779 label: Storage Class Backing Image Expected SHA512 Checksum
780 group: "Longhorn Storage Class Settings"
781 type: string
782 default:
783 - variable: persistence.backingImage.dataSourceType
784 description: 'Specify the data source type for the backing image used in Longhorn StorageClass.
785 If the backing image does not exists, Longhorn will use this field to create a backing image. Otherwise, Longhorn will use it to verify the selected backing image.
786 WARNING:
787 - If the backing image name is not specified, setting this field is meaningless.
788 - As for backing image creation with data source type \"upload\", it is recommended to do it via UI rather than StorageClass here. Uploading requires file data sending to the Longhorn backend after the object creation, which is complicated if you want to handle it manually.'
789 label: Storage Class Backing Image Data Source Type
790 group: "Longhorn Storage Class Settings"
791 type: enum
792 options:
793 - ""
794 - "download"
795 - "upload"
796 - "export-from-volume"
797 default: ""
798 - variable: persistence.backingImage.dataSourceParameters
799 description: "Specify the data source parameters for the backing image used in Longhorn StorageClass.
800 If the backing image does not exists, Longhorn will use this field to create a backing image. Otherwise, Longhorn will use it to verify the selected backing image.
801 This option accepts a json string of a map. e.g., '{\"url\":\"https://backing-image-example.s3-region.amazonaws.com/test-backing-image\"}'.
802 WARNING:
803 - If the backing image name is not specified, setting this field is meaningless.
804 - Be careful of the quotes here."
805 label: Storage Class Backing Image Data Source Parameters
806 group: "Longhorn Storage Class Settings"
807 type: string
808 default:
809- variable: persistence.removeSnapshotsDuringFilesystemTrim
810 description: "Allow automatically removing snapshots during filesystem trim for Longhorn StorageClass"
811 label: Default Storage Class Remove Snapshots During Filesystem Trim
812 group: "Longhorn Storage Class Settings"
813 type: enum
814 options:
815 - "ignored"
816 - "enabled"
817 - "disabled"
818 default: "ignored"
819- variable: ingress.enabled
820 default: "false"
821 description: "Expose app using Layer 7 Load Balancer - ingress"
822 type: boolean
823 group: "Services and Load Balancing"
824 label: Expose app using Layer 7 Load Balancer
825 show_subquestion_if: true
826 subquestions:
827 - variable: ingress.host
828 default: "xip.io"
829 description: "layer 7 Load Balancer hostname"
830 type: hostname
831 required: true
832 label: Layer 7 Load Balancer Hostname
833 - variable: ingress.path
834 default: "/"
835 description: "If ingress is enabled you can set the default ingress path"
836 type: string
837 required: true
838 label: Ingress Path
839- variable: service.ui.type
840 default: "Rancher-Proxy"
841 description: "Define Longhorn UI service type"
842 type: enum
843 options:
844 - "ClusterIP"
845 - "NodePort"
846 - "LoadBalancer"
847 - "Rancher-Proxy"
848 label: Longhorn UI Service
849 show_if: "ingress.enabled=false"
850 group: "Services and Load Balancing"
851 show_subquestion_if: "NodePort"
852 subquestions:
853 - variable: service.ui.nodePort
854 default: ""
855 description: "NodePort port number(to set explicitly, choose port between 30000-32767)"
856 type: int
857 min: 30000
858 max: 32767
859 show_if: "service.ui.type=NodePort||service.ui.type=LoadBalancer"
860 label: UI Service NodePort number
861- variable: enablePSP
862 default: "false"
863 description: "Setup a pod security policy for Longhorn workloads."
864 label: Pod Security Policy
865 type: boolean
866 group: "Other Settings"
867- variable: global.cattle.windowsCluster.enabled
868 default: "false"
869 description: "Enable this to allow Longhorn to run on the Rancher deployed Windows cluster."
870 label: Rancher Windows Cluster
871 type: boolean
872 group: "Other Settings"
873- variable: networkPolicies.enabled
874 description: "Enable NetworkPolicies to limit access to the longhorn pods.
875 Warning: The Rancher Proxy will not work if this feature is enabled and a custom NetworkPolicy must be added."
876 group: "Other Settings"
877 label: Network Policies
878 default: "false"
879 type: boolean
880 subquestions:
881 - variable: networkPolicies.type
882 label: Network Policies for Ingress
883 description: "Create the policy to allow access for the ingress, select the distribution."
884 show_if: "networkPolicies.enabled=true&&ingress.enabled=true"
885 type: enum
886 default: "rke2"
887 options:
888 - "rke1"
889 - "rke2"
890 - "k3s"