starlingx/docs
Code Issues Proposed changes

K8s qat device plugin is not supported (r6,dsR6,dsR7)

Browse Source 
QAT Plugin marked as starlingx only.

Signed-off-by: Elisamara Aoki Goncalves <elisamaraaoki.goncalves@windriver.com>
Change-Id: Ic2ce74d2e86886717abf1de7a79c25ec3477a9d3
This commit is contained in:
Elisamara Aoki Goncalves 2022-08-31 11:33:07 -03:00
parent 126131ce63
commit 64b463c346
2 changed files with 89 additions and 75 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/source/admintasks/kubernetes/index-admintasks-kub-ebc55fefc368.rst
View File

@ -48,6 +48,16 @@ Optimize application performance
kubernetes-cpu-manager-policies kubernetes-cpu-manager-policies
isolating-cpu-cores-to-enhance-application-performance isolating-cpu-cores-to-enhance-application-performance
kubernetes-topology-manager-policies kubernetes-topology-manager-policies
.. only:: starlingx
-----------------
QAT Device Plugin
-----------------
.. toctree::
:maxdepth: 1
k8s_qat_device_plugin k8s_qat_device_plugin

62
doc/source/admintasks/kubernetes/k8s_qat_device_plugin.rst
View File

@ -1,33 +1,37 @@
========================================== .. _k8s_qat_device_plugin:
Kubernetes QAT Device Plugin Configuration
==========================================
Intel® QuickAssist Technology (Intel® QAT) accelerates cryptographic workloads .. only:: starlingx
by offloading the data to hardware capable of optimizing those functions. This
guide describes how to enable and consume the Intel QAT device plugin in
StarlingX.
.. contents:: ==========================================
Kubernetes QAT Device Plugin Configuration
==========================================
Intel® QuickAssist Technology (Intel® QAT) accelerates cryptographic workloads
by offloading the data to hardware capable of optimizing those functions. This
guide describes how to enable and consume the Intel QAT device plugin in
StarlingX.
.. contents::
:local: :local:
:depth: 1 :depth: 1
------------- -------------
Prerequisites Prerequisites
------------- -------------
- Install Intel QuickAssist device on host. - Install Intel QuickAssist device on host.
- Install StarlingX on bare metal with DPDK enabled. Refer to the |_link-inst-book| - Install StarlingX on bare metal with DPDK enabled. Refer to the |_link-inst-book|
for details. for details.
------------------------------ ------------------------------
Enable Intel QAT device plugin Enable Intel QAT device plugin
------------------------------ ------------------------------
The Intel QAT device plugin daemonset is pre-installed in StarlingX. This The Intel QAT device plugin daemonset is pre-installed in StarlingX. This
section describes the steps to enable the Intel QAT device plugin for section describes the steps to enable the Intel QAT device plugin for
discovering and advertising QAT VF resources to Kubernetes host. discovering and advertising QAT VF resources to Kubernetes host.
#. Verify QuickAssist SR-IOV virtual functions are configured on a specified #. Verify QuickAssist SR-IOV virtual functions are configured on a specified
node after StarlingX is installed. This example uses the worker-0 node. node after StarlingX is installed. This example uses the worker-0 node.
:: ::
@ -40,7 +44,7 @@ discovering and advertising QAT VF resources to Kubernetes host.
The Intel QAT device plugin only supports QAT VF resources in the current The Intel QAT device plugin only supports QAT VF resources in the current
release. release.
#. Assign the ``intelqat`` label to the node (worker-0 in this example). #. Assign the ``intelqat`` label to the node (worker-0 in this example).
:: ::
@ -49,20 +53,20 @@ discovering and advertising QAT VF resources to Kubernetes host.
$ system host-label-assign $NODE intelqat=enabled $ system host-label-assign $NODE intelqat=enabled
$ system host-unlock $NODE $ system host-unlock $NODE
#. After the node becomes available, verify the Intel QAT device plugin is #. After the node becomes available, verify the Intel QAT device plugin is
registered. registered.
:: ::
$ kubectl describe node $NODE | grep qat.intel.com/generic $ kubectl describe node $NODE | grep qat.intel.com/generic
qat.intel.com/generic: 10 qat.intel.com/generic: 10
qat.intel.com/generic: 10 .intel.com/generic: 10
------------------------------- -------------------------------
Consume Intel QAT device plugin Consume Intel QAT device plugin
------------------------------- -------------------------------
#. Build the DPDK image. #. Build the DPDK image.
:: ::
@ -72,7 +76,7 @@ Consume Intel QAT device plugin
This command produces a Docker image named ``crypto-perf``. This command produces a Docker image named ``crypto-perf``.
#. Deploy a pod to run an example DPDK application named #. Deploy a pod to run an example DPDK application named
``dpdk-test-crypto-perf``. ``dpdk-test-crypto-perf``.
In the pod specification file, add the container resource request and In the pod specification file, add the container resource request and
@ -98,7 +102,7 @@ Consume Intel QAT device plugin
kubectl since the Kubernetes v1.14 release. kubectl since the Kubernetes v1.14 release.
#. Manually execute the ``dpdk-test-crypto-perf`` application to review the #. Manually execute the ``dpdk-test-crypto-perf`` application to review the
logs. logs.
:: ::