Priority Class
The Priority Class setting can be used to set a higher priority on Longhorn workloads in the cluster, preventing them from being the first to be evicted during node pressure situations.
For more information on how pod priority works, refer to the official Kubernetes documentation.
Longhorn consists of user-deployed components (for example, Longhorn Manager, Longhorn Driver, and Longhorn UI) and system-managed components (for example, Instance Manager, CSI Driver, and Engine images). You need to set Priority Class for both types of components. See more details below.
Longhorn creates a Priority Class longhorn-critical
and sets it as default for its user deployed or system managed components if the following actions are not taken.
priority-class
default settingWarning: Longhorn will not start if the Priority Class setting is invalid (such as the Priority Class not existing). You can see if this is the case by checking the status of the longhorn-manager DaemonSet with
kubectl -n longhorn-system describe daemonset.apps/longhorn-manager
. You will need to uninstall Longhorn and restart the installation if this is the case.
Users can update or remove the Priority Class here, but note that this will result in recreation of all the Longhorn system components. The Priority Class setting will reject values that appear to be invalid Priority Classes.
To ensure that your preferred Priority Class settings are immediately applied, stop all workloads and detach all Longhorn volumes before configuring the settings.
Longhorn temporarily becomes unavailable when all components are restarted. Don’t operate the Longhorn system after modifying the Priority Class setting, as the Longhorn components will be restarting.
When all Longhorn volumes are detached, the customized setting is immediately applied to the system-managed components. When one or more Longhorn volumes are still attached, the customized setting is applied to the Instance Manager only when no engines and replica instances are running. You are required to reconfigure the setting after detaching the remaining volumes. Alternatively, you can wait for the next setting synchronization, which will occur in an hour.
Do not delete the Priority Class in use by Longhorn, as this can cause new Longhorn workloads to fail to come online.
Available since v1.0.1
© 2019-2024 Longhorn Authors | Documentation Distributed under CC-BY-4.0
© 2024 The Linux Foundation. All rights reserved. The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Usage page.