This repo contains example kustomize configs used to installed openshift features required for CNF workloads and a e2e functional test suite used to verify CNF related features.
All kustomize configs should be entirely declarative in nature. This means no bash plugin modules performing imperative tasks. Features should be installed simply by posting manifests to the cluster. After posting manifests, determining when the cluster has converged on those manifests successully should be observable.
- You need a running OCP 4.4 (or later) cluster and a valid KUBECONFIG.
- You need at least one node with the
node-role.kubernetes.io/worker-cnf=""
label and aMachineConfigPool
matchingworker-cnf
machine configurations - You need to install
jq
(a command line tool for parsing JSON) on the local machine.
You can run make setup-test-cluster
to have the first two (or the first in case of only one) workers labeled as worker-cnf
and to have the MachineConfigPool
created.
All the Makefile rules depend on two environment variable, either for deploying, waiting and choosing what tests to run.
e.g. FEATURES="sctp ptp sriov"
, drives what features are going to be deployed using kustomize, and what tests are going to be run.
The current default values is "sctp performance"
i.e. FEATURES_ENVIRONMENT=demo
determines the kustomization layer that will be used to deploy the choosen features.
The current default value is e2e-gcp
For each feature choosen via FEATURES
we expect to have a layer either in feature-configs/deploy or in feature-configs/$FEATURES_ENVIRONMENT.
- run
FEATURES_ENVIRONMENT=demo make feature-deploy
.
This will try to apply all manifests in a loop until all deployments succeeded, or until it runs into a timeout. - optionally run
FEATURES_ENVIRONMENT=demo make feature-wait
to be notified of when the features are deployed.
We expect to have a section of the test suite named after each feature we want to test (for example sctp named after the sctp feature).
External tests are consumed as dependencies and ran as part of this same suite.
Verifies behavior of an OCP cluster by running remote tests against the cluster API that exercise functionality. These tests may be disruptive.
Running a dockerized version of origin-tests from quay.io/openshift/origin-tests. The full test suite can be found at https://github.com/openshift/openshift-tests.
-
run
ORIGIN_TESTS_FILTER=openshift/conformance/serial make origin-tests
. The current default values isopenshift/conformance/parallel
-
optionally set
ORIGIN_TESTS_IN_DISCONNECTED_ENVIRONMENT=true
andORIGIN_TESTS_REPOSITORY=test.repository.com:5000/origin-tests
to run origin-tests in a disconnected environment. -
optionally run
ORIGIN_TESTS_REPOSITORY=test.repository.com:5000/origin-tests make mirror-origin-tests
to mirror all the required test images to a container image repository. -
optionally run
ORIGIN_TESTS_REPOSITORY=test.repository.com:5000/origin-tests make origin-tests-disconnected-environment
to mirror all the required test images to a container image repository and source required test images from your repository when running origin-tests in a disconnected environment.
The custom RPMs utility allows to install RPMs from an external source on an OCP node.
RPMS_SRC (RPMs download source URL) must be provided.
REMOVE_PACKAGES should be set when installing RT kernel RPMs to override the installed kernel packages.
RPMS_NODE_ROLE is optional and defaults to node-role.kubernetes.io/worker
.
-
run
RPMS_SRC="http://test.download.com/example1.rpm http://test.download.com/example2.rpm" make custom-rpms
.
This will install all the RPMs listed in RPMS_SRC on the selected nodes. -
optionally run
RPMS_SRC="http://test.download.com/rt-kernel-package1.rpm http://test.download.com/rt-kernel-package1.rpm http://test.download.com/rt-kernel-package3.rpm" REMOVE_PACKAGES="kernel kernel-core kernel-modules kernel-modules-extra" make custom-rpms
to install RT kernel RPMs listed in RPMS_SRC on the selected nodes and override the installed kernel packages listed in REMOVE_PACKAGES.
A dockerized version of CNF tests is available at quay.io/openshift-kni/cnf-tests. For more details on how to use it, please check the corresponding docs.
An example RAN profile is provided in feature-configs/cn-ran-overlays