Skip to content

Commit 26ad97f

Browse files
committed
docs: Add details on how to run e2e tests
1 parent fc847e4 commit 26ad97f

File tree

2 files changed

+54
-0
lines changed

2 files changed

+54
-0
lines changed

docs/content/contributing/_index.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
+++
2+
title = "Contributing"
3+
weight = 99
4+
icon = "fa-solid fa-gift"
5+
+++
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
+++
2+
title = "End-to-end tests"
3+
+++
4+
5+
This project uses [Ginkgo] to run end-to-end tests. Tests are labelled to make running targeted or specific tests
6+
easier.
7+
8+
To determine what labels are available, run:
9+
10+
```shell
11+
ginkgo --dry-run -v -tags e2e ./test/e2e
12+
```
13+
14+
Tests are currently labelled via infrastructure provider, CNI provider, and addon strategy. Here are some examples to
15+
specify what tests to run.
16+
17+
Run all AWS tests:
18+
19+
```shell
20+
make e2e-test E2E_LABEL='provider:AWS'
21+
```
22+
23+
Run all Cilium tests:
24+
25+
```shell
26+
make e2e-test E2E_LABEL='cni:Cilium'
27+
```
28+
29+
Labels can also be combined.
30+
31+
Run Cilium tests on AWS:
32+
33+
```shell
34+
make e2e-test E2E_LABEL='provider:AWS && cni:Cilium'
35+
```
36+
37+
To make debugging easier, you can retain the e2e test environment, which by default is cleaned up after tests run:
38+
39+
```shell
40+
make e2e-test E2E_LABEL='provider:AWS && cni:Cilium' E2E_SKIP_CLEANUP=true
41+
```
42+
43+
To speed up the development process, if you have only change e2e tests then you can skip rebuilding the whole project:
44+
45+
```shell
46+
make e2e-test E2E_LABEL='provider:AWS && cni:Cilium' SKIP_BUILD=true
47+
```
48+
49+
[Ginkgo]: https://onsi.github.io/ginkgo/

0 commit comments

Comments
 (0)