A Central Scheduler Load Balancer (CSLB) for PromoxVE (PVE)
Identifies nodes with resource surpluses and deficits (presently only CPU and memory) and migrates workloads around to balance things out. Takes inspiration from, and expands upon, ideas in this oft-cited paper from 2012.
The defaults are reasonable. Config file is optional. Command line arguments are optional unless you want to use a config file. Follows 12-factor conventions and configurable from environment variables ("CSLB_" namespace).
API endpoint and credentials with read and migrate permissions are required.
$ ./pve-cslb.py --exclude-node firefly -v --help
usage: pve-cslb [-h] [-c FILE] [-v] [-q] [-d] [--proxmox-node NODE] [--proxmox-port PORT]
[--proxmox-user USER] [--proxmox-pass PASS] [-m NUM] [--percent-cpu %]
[--percent-mem %] [--exclude-node EXCLUDE_NODE]
[--exclude-vmid EXCLUDE_VMID] [--exclude-type EXCLUDE_TYPE]
[--include-node INCLUDE_NODE] [--include-vmid INCLUDE_VMID]
[--include-type INCLUDE_TYPE]
pve-cslb 1.0.3 - A workload balancing engine for ProxmoxPVE. Identifies nodes with
imbalanced loads and migrates workloads around to even things out.
options:
-h, --help show this help message and exit
-c FILE, --config-file FILE
YAML configuration file (default: None)
-v, --verbose Increase verbosity (default: False)
-q, --quiet Only output errors (default: False)
-d, --dry-run Perform read-only analysis; no write actions. (default: False)
--proxmox-node NODE Proxmox node (default: localhost)
--proxmox-port PORT Proxmox port (default: 8006)
--proxmox-user USER Proxmox user (default: root@pam)
--proxmox-pass PASS Proxmox password (no default)
-m NUM, --max-migrations NUM
Max simultaneous migrations to start (default: 5)
--percent-cpu % Percent priority of CPU rule (p-cpu and p-mem must equal 1.0;
default: 0.4)
--percent-mem % Percent priority of MEM rule (p-cpu and p-mem must equal 1.0;
default: 0.6)
--exclude-node EXCLUDE_NODE
Exclude a node (can be specified multiple times)
--exclude-vmid EXCLUDE_VMID
Exclude a VMID (can be specified multiple times)
--exclude-type EXCLUDE_TYPE
Exclude a workload type ('lxc' or 'qemu'; can be specified multiple
times)
--include-node INCLUDE_NODE
Include a previously excluded node (can be specified multiple times)
--include-vmid INCLUDE_VMID
Include a previously excluded VMID (can be specified multiple times)
--include-type INCLUDE_TYPE
Include a previously excluded workload type (must be 'lxc' or
'qemu'; can be specified multiple times)
Copyright (C) 2024 Travis Wichert <[email protected]>
Env Vars |
---|
CSLB_PROXMOX_NODE |
CSLB_PROXMOX_PORT |
CSLB_PROXMOX_USER |
CSLB_PROXMOX_PASS |
CSLB_PERCENT_CPU |
CLSB_PERCENT_MEM |
CLSB_MAX_MIGRATIONS |
CSLB_VERBOSE |
CSLB_QUIET |
CSLB_DRY_RUN |
pve-cslb tries to avoid moving the same workload multiple times, but an edge-case exists in which lightly loaded clusters with few workloads and many nodes may see more migrations than strictly necessary. Adding more workloads to the cluster will generally cease this behavior.
![]() |
---|
padthaitofuhot |