Accelerating Applications with Onload - Accelerating Applications with Onload - UG1656

Onload Operator for Kubernetes User Guide (UG1656)

Document ID
UG1656
Release Date
2024-04-26
Revision
1.0 English

To accelerate your workload, configure a pod with an AMD Solarflare™ network interface and an amd.com/onload resource:

kind: Pod
metadata:
  annotations:
    k8s.v1.cni.cncf.io/networks: ipvlan-bond0
spec:
  ...
  containers:
  - ...
    resources:
      limits:
        amd.com/onload: 1

where:

k8s.v1.cni.cncf.io/networks: ipvlan-bond0 in metadata.annotations
Tells Kubernetes® to add an IPVLAN interface backed by the Solarflare NIC to this pod so it then can be accelerated.
amd.com/onload: 1 in spec.containers.[0].resource.limits
Requests Onload acceleration for the pod.

The presence of the resource is what requests acceleration. The quantity of the resource is given as 1, but this value is ignored.

Note: You should also define any other appropriate fields in the limits object, such as memory and swap limits.

All applications started within the pod environment are then accelerated due to the LD_PRELOAD environment variable, unless setPreload: false is configured in the Onload CR.