diff options
author | opensource-tnbt <sridhar.rao@spirent.com> | 2020-11-24 12:23:48 +0530 |
---|---|---|
committer | opensource-tnbt <sridhar.rao@spirent.com> | 2020-11-25 12:32:19 +0530 |
commit | 217001d0b4ae6615acb3889bd1dd98572553a8c6 (patch) | |
tree | 8e2d28564b9a50cf22232b46ec900e7607930267 | |
parent | 605102bb6a8a3b48f0c66d817614eec0ef42e017 (diff) |
Docs: Add missing documentation for Jerma.
This patch adds any documentation that is/was not part of the original
patch.
Update-1: Fix Typo
Signed-off-by: Sridhar K. N. Rao <sridhar.rao@spirent.com>
Change-Id: I628f4d4e4d0b423104705d199a176e8a07f411e5
-rw-r--r-- | docs/k8s/index.rst | 40 |
1 files changed, 33 insertions, 7 deletions
diff --git a/docs/k8s/index.rst b/docs/k8s/index.rst index 36ba7609..872a3280 100644 --- a/docs/k8s/index.rst +++ b/docs/k8s/index.rst @@ -1,14 +1,40 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -.. (c) OPNFV, Intel Corporation, AT&T, Red Hat, Spirent, Ixia and others. +.. (c) OPNFV, Spirent, AT&T, Ixia and others. .. OPNFV VSPERF Documentation master file. -************************** -OPNFV VSPERF K8S CNB Guide -************************** +========================================================= +OPNFV VSPERF Kubernetes Container Networking Benchmarking +========================================================= +VSPERF supports testing and benchmarking of kubernetes container networking solution, referred as kubernetes Container Networking Benchmarking (CNB). The process can be broadly classified into following four operations. -============ -Introduction -============ +1. Setting up of Kubernetes Cluster. +2. Deploying container networking solution. +3. Deploying pod(s). +4. Running tests. +First step is achieved through the tool present in *tools/k8s/cluster-deployment* folder. Please refer to the documentation present in that folder for automated kubernetes cluster setup. To perform the remaining steps, the user has to run the following command. + +.. code-block:: console + + vsperf --k8s --conf-file k8s.conf pcp_tput + +************************ +Important Configurations +************************ + +VSPERF has introduced a new configuration parameters, as listed below, for kubernetes CNB. The file *12_k8s.conf*, present in conf folder provides sample values. User has to modify these parameters to suit their environment before running the above command. + +1. K8S_CONFIG_FILEPATH - location of the kubernetes-cluster access file. This will be used to connect to the cluster. +2. PLUGIN - The plugin to use. Allowed values are OvsDPDK, VPP, and SRIOV. +3. NETWORK_ATTACHMENT_FILEPATH - location of the network attachment definition file. +4. CONFIGMAP_FILEPATH - location of the config-map file. This will be used only for SRIOV plugin. +5. POD_MANIFEST_FILEPATH - location of the POD definition file. +6. APP_NAME - Application to run in the pod. Options - l2fwd, testpmd, and l3fwd. + + +********* +Testcases +********* +Kubernetes CNB will be done through new testcases. For Jerma release, only pcp_tput will be supported. This testcase, will be similar to pvp_tput, where VNF is replaced with a pod/container. The pcp_tput testcase, will still use phy2phy as deployment. In future releases, a new deployment model will be added to support more testcases for kubernetes |