Skip to content

Commit 778bd57

Browse files
UPSTREAM: <carry>: OTE - How to test locally with OCP instances
1 parent af40962 commit 778bd57

File tree

1 file changed

+32
-2
lines changed

1 file changed

+32
-2
lines changed

openshift/tests-extension/README.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,47 @@ They use the framework: https://github.com/openshift-eng/openshift-tests-extensi
1515
| `./bin/olmv1-tests-ext run-suite olmv1/all` | Runs the full OLMv1 test suite. |
1616
| `./bin/olmv1-tests-ext run-test -n <test-name>` | Runs one specific test. Replace <test-name> with the test's full name. |
1717

18-
## How to Run the Tests locally
18+
19+
## How to Run the Tests Locally
1920

2021
The tests can be run locally using the `olmv1-tests-ext` binary against an OpenShift cluster or a vanilla Kubernetes cluster.
2122
Features and checks which are OpenShift-specific will be skipped when running against a vanilla Kubernetes cluster.
2223

23-
Use the environment variable `KUBECONFIG` to point to your cluster configuration file.
24+
Use the environment variable `KUBECONFIG` to point to your cluster configuration file such as:
2425

2526
```shell
2627
KUBECONFIG=path/to/kubeconfig ./bin/olmv1-tests-ext run-test -n <test-name>
2728
```
2829

30+
To run tests that include tech preview features,
31+
you need a cluster with OLMv1 installed and those features enabled.
32+
33+
### Local Test using OLMv1 and OCP
34+
35+
1. Use the `Cluster Bot` to create an OpenShift cluster with OLMv1 installed.
36+
37+
**Example:**
38+
39+
```shell
40+
launch 4.20 gcp,techpreview
41+
```
42+
43+
2. Set the `KUBECONFIG` environment variable to point to your OpenShift cluster configuration file.
44+
45+
**Example:**
46+
47+
```shell
48+
mv ~/Downloads/cluster-bot-2025-08-06-082741.kubeconfig ~/.kube/cluster-bot.kubeconfig
49+
export KUBECONFIG=~/.kube/cluster-bot.kubeconfig
50+
```
51+
52+
3. Run the tests using the `olmv1-tests-ext` binary.
53+
54+
**Example:**
55+
```shell
56+
./bin/olmv1-tests-ext run-suite olmv1/all
57+
```
58+
2959
### Local Test using OLMv1 and Kind
3060

3161
**Prerequisites:**

0 commit comments

Comments
 (0)