E2E tests are not located in this repository - all e2e tests are in toolchain-e2e repo, however, it’s still possible to run them locally from this repo - see Running End-to-End Tests.

When there is a change introduced in this repository that should be either covered by e2e tests or requires changes in the already existing tests, then all needed changes should go into the toolchain-e2e repo. The logic that executes tests in openshift-ci automatically tries to pair PR opened for this (host-operator) repository with a branch that potentially exists in the developer’s fork of the toolchain-e2e repo. This pairing is based on a branch name.

For example, if a developer with GH account cooljohn opens a PR (for host-operator repo) from a branch fix-reconcile, then the logic checks if there is a branch fix-reconcile also in the cooljohn/toolchain-e2e fork. If there is, then the logic:

1. clones latest changes from codeready-toolchain/toolchain-e2e

2. fetches the fix-reconcile branch from cooljohn/toolchain-e2e fork

3. merges master branch with the changes from fix-reconcile branch

4. clones latest changes from member-operator repo and builds & deploys the member-operator image out of it

5. builds & deploys the host-operator image from the code that is in the PR

6. runs e2e tests against both operators from the merged branch of the toolchain-e2e repo

If the branch with the same name does not exist, then it only clones the latest changes from toolchain-e2e and runs e2e tests from the master.

If you still don’t know what to do with e2e tests in some use-cases, go to What to do section where all use-cases are covered.

• Make sure you have set the QUAY_NAMESPACE variable: export QUAY_NAMESPACE=<quay-username>

• Log in to the target OpenShift cluster with cluster admin privileges

• The visibility of host-operator repository in quay is set to public (https://quay.io/repository/<your-username>/host-operator?tab=settings)

Although the e2e tests are in the separated repository, it’s still possible to run them from this repo (host-operator) and also against the current code that is at HEAD. There are two Makefile targets that will execute the e2e tests:

• make test-e2e - this target clones latest changes from toolchain-e2e and runs e2e tests for both operators from the master. As deployment for host-operator it uses the current code that is at HEAD.

• make test-e2e-local - this target doesn’t clone anything, but it runs run e2e tests for both operators from the directory ../toolchain-e2e. As deployment for host-operator it uses the current code that is at HEAD.

The tests executed within toolchain-e2e repo will take care of creating all needed namespaces with random names (or see below for enforcing some specific namespace names). It will also create all required CRDs, role and role bindings for the service accounts, build the Docker images for both operators and push them to the OpenShift container registry. Finally, it will deploy the operators and run the tests using the operator-sdk.