Resource policy¶

Allocation automatique des ressources CPU et mémoire aux instances.

Configuration¶

# anklume.yml
resource_policy:
  host_reserve:
    cpu: "20%"            # Réserve hôte
    memory: "20%"
  mode: proportional      # proportional ou equal
  cpu_mode: allowance     # allowance (%) ou count (vCPUs)
  memory_enforce: soft    # soft (ballooning) ou hard (limite stricte)
  overcommit: false       # true = warning au lieu d'erreur

Algorithme¶

flowchart TD
    HW[Détection hardware<br/>CPU + RAM] --> Reserve[Soustraire réserve hôte]
    Reserve --> Explicit[Exclure machines avec config explicite]
    Explicit --> Alloc{Mode ?}
    Alloc -->|proportional| Prop[Allocation par poids<br/>weight]
    Alloc -->|equal| Equal[Parts égales]
    Prop --> Apply[Appliquer dans machine.config]
    Equal --> Apply

    style HW fill:#3b82f6,color:#fff
    style Alloc fill:#6366f1,color:#fff
    style Apply fill:#10b981,color:#fff

Détection hardware¶

incus info --resources --format json (source principale)
Fallback /proc/cpuinfo + /proc/meminfo

Réserve hôte¶

Formats acceptés :

Format	Exemple	Résultat
Pourcentage	`"20%"`	20% du total
CPU absolu	`"4"`	4 threads
Mémoire absolue	`"4GB"`	4 Go (puissances de 1024)

Allocation proportionnelle¶

part[i] = allocatable × weight[i] / sum(weights)

Les machines avec limits.cpu ou limits.memory explicites sont exclues de l'allocation pour la ressource concernée. Leur consommation est déduite du pool.

Modes CPU¶

Mode	Config Incus	Description
`allowance`	`limits.cpu.allowance`	Pourcentage CPU
`count`	`limits.cpu`	Nombre fixe de vCPUs

Modes mémoire¶

Mode	Config Incus	Description
`soft`	`limits.memory.soft`	Ballooning cgroups (élastique)
`hard`	`limits.memory`	Limite stricte (OOM si dépassée)

Valeurs formatées en MB (minimum 64 MB).