summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoropensource-tnbt <sridhar.rao@spirent.com>2020-11-24 12:23:48 +0530
committeropensource-tnbt <sridhar.rao@spirent.com>2020-11-25 12:32:19 +0530
commit217001d0b4ae6615acb3889bd1dd98572553a8c6 (patch)
tree8e2d28564b9a50cf22232b46ec900e7607930267
parent605102bb6a8a3b48f0c66d817614eec0ef42e017 (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.rst40
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