Runtime

CPUPartitionConfig

CPUPartitionConfig is a CPU partition config document. CPUPartitionConfig declares the host CPUs each fixed Talos workload root may run on.

The roots are init, system, podruntime, kubepods, taloscontainers and virtualMachines. A root left out of the document is unrestricted; a root listed in the document must name at least one CPU. Roots may overlap each other.

The document does not require virtual machines: omit virtualMachines to partition the host services and Kubernetes pods of an ordinary node.

The virtual machine root may be divided into named, pairwise disjoint slices. An exclusive slice must not overlap any other root, and every other root must then be bounded explicitly.

In container mode the document is validated but declares no policy.

apiVersion: v1alpha1
kind: CPUPartitionConfig
# Host CPUs for machined and the early boot services.
init:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for Talos system services (apid, trustd, udevd, ...).
system:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for the Kubernetes runtime components (containerd, the kubelet, etcd).
podruntime:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for Kubernetes pods.
kubepods:
    cpus: 2-7 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.

apiVersion: v1alpha1
kind: CPUPartitionConfig
# Host CPUs for machined and the early boot services.
init:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for Talos system services (apid, trustd, udevd, ...).
system:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for the Kubernetes runtime components (containerd, the kubelet, etcd).
podruntime:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for Kubernetes pods.
kubepods:
    cpus: 2-3 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for containers declared via `ContainerConfig`.
taloscontainers:
    cpus: 0-1 # Host CPUs as a Linux CPU list, e.g. `0-1` or `0,2-3`.
# Host CPUs for virtual machines, optionally divided into named slices.
virtualMachines:
    cpus: 4-7 # Host CPUs of the virtual machine root, as a Linux CPU list.
    # Named, pairwise disjoint subsets of `cpus`.
    slices:
        - name: database # Unique slice name: 1 to 63 ASCII letters, digits and hyphens. `shared` is reserved.
          cpus: 6-7 # Host CPUs of the slice, as a Linux CPU list within the virtual machine root.
          exclusive: true # Keep the slice's CPUs out of every other root.

Field	Type	Description
`init`	CPUPartitionRoot	Host CPUs for machined and the early boot services.
`system`	CPUPartitionRoot	Host CPUs for Talos system services (apid, trustd, udevd, …).
`podruntime`	CPUPartitionRoot	Host CPUs for the Kubernetes runtime components (containerd, the kubelet, etcd).
`kubepods`	CPUPartitionRoot	Host CPUs for Kubernetes pods.
`taloscontainers`	CPUPartitionRoot	Host CPUs for containers declared via `ContainerConfig`.
`virtualMachines`	CPUPartitionVirtualMachines	Host CPUs for virtual machines, optionally divided into named slices.