README
¶
Ecosystem Edge Core Team - CNF Network
Overview
Network tests are used for the testing of network operators and their features. Eco-gotests is a test framework utilizing a container test image with auxiliary resources for network testing.
Prerequisites for running these tests:
Eco-gotest suite is designed to test an OCP cluster version 4.13 and higher with the following pre-installed components:
- Machine config pool to define/collect configurations for labeled nodes
- SR-IOV operator
- MetalLB operator
- VRAN acceleration operator
- Performance Addon Operator
- SCTP via machine config
Container images used for network test cases:
Test suites:
| Name | Description |
|---|---|
| cni | Tests that are run on corresponding operators |
| day1day2 | Tests are run on the sriov operator and existing sriov interfaces |
| dpdk | Tests are run on the sriov operator and existing sriov interfaces |
| metallb | Tests are run with metallb operator and frr container image |
| policy | Tests that are run on corresponding operators |
| sriov | Tests are run with sriov operator and existing sriov interfaces |
Internal pkgs
| Name | Description |
|---|---|
| cmd | Commands used to run on the test containers |
| define | Defines network attachment definitions for test containers |
| netconfig | Configures environmental variables with default values |
| netenv | Verifies cluster configuration and support for sriov |
| netinittools | Provides an APIClient for access to cluster |
| netnmstate | Commands to creates or recreates the new NMState instance and waits until its running |
| netparam | Tests are run with sriov operator and existing sriov interfaces |
Eco-goinfra pkgs
The eco-goinfra project contains a collection of generic packages that can be used across various test projects. Utilizing the expertise of each team and to decrease the duplication of coding efforts. Eco-infra project requires golang v1.19.x.
Inputs
Environment variables to change test image locations and worker labels:
ECO_CNF_CORE_NET_TEST_CONTAINER: controls the location of the CNF test image.ECO_CNF_CORE_NET_DPDK_TEST_CONTAINER: controls the location of the DPDK test image.ECO_CNF_CORE_NET_FRR_IMAGE: controls the location of the FRR test image.ECO_CNF_CORE_NET_CNF_MCP_LABEL: variable used to identify the worker node label.
Please refer to the project README for a list of global inputs - How to run All network environmental variables can be found 'tests/cnf/core/network/internal/netconfig/config.go'
Running Network Test Suites
# export KUBECONFIG=</path/to/hub/kubeconfig>
# export ECO_TEST_FEATURES=network
# export ECO_TEST_LABELS=net
# export ECO_TEST_VERBOSE='true'
# export ECO_VERBOSE_LEVEL=100
# export ECO_CNF_CORE_NET_VLAN=VLAN_ID
# export ECO_CNF_CORE_NET_SRIOV_INTERFACE_LIST=List SR-IOV interfaces under test # example "eno1,eno2"
# export ECO_CNF_CORE_NET_MLB_ADDR_LIST=LIST of ip addresses # example 10.66.66.88,10.66.66.89,10.66.66.90,2666:66:0:2e51::88,2666:66:0:2e51::89,2666:66:0:2e51::90
# export ECO_CNF_CORE_NET_SWITCH_IP="switch_ip_address"
# export ECO_CNF_CORE_NET_SWITCH_INTERFACES=LIST of switch interfaces # example et-3/0/33,et-3/0/34,et-3/0/35,et-3/0/36
# export ECO_CNF_CORE_NET_SWITCH_USER="username"
# export ECO_CNF_CORE_NET_SWITCH_PASS='password'
# make run-tests
Running Metallb Test Suites
# export KUBECONFIG=</path/to/hub/kubeconfig>
# export ECO_TEST_FEATURES=metallb
# export ECO_TEST_VERBOSE=true
# export ECO_VERBOSE_LEVEL=100
# export ECO_CNF_CORE_NET_MLB_ADDR_LIST=LIST of ip addresses # example 10.66.66.88,10.66.66.89,10.66.66.90,2666:66:0:2e51::88,2666:66:0:2e51::89,2666:66:0:2e51::90
# make run-tests
Additional Information
Lab Infrastructure:
The dedicated lab infrastructure needed for the execution of this test suite. The test cases are developed with this specific network environment in mind.
Two SRIOV interfaces are connected to a managed lab switch. All non tagged packets are tagged with the native-vlan-id and two trunk VLANs. VLANs may change between clusters.
- Switch configuration example
interfaces et-3/0/33
native-vlan-id 333;
mtu 9192;
unit 0 {
family ethernet-switching {
interface-mode trunk;
vlan {
members [ vlan333 vlan334 vlan335 ];
}
- Hypervisor Master node
- Bare metal worker nodes
- SR-IOV NICs per worker nodes
- Managed switch connecting the SRIOV ports
- Jumbo frame support and configuration
Directories