You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: tests/e2e/README.md
+12-28
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ limitations under the License.
20
20
---
21
21
22
22
## 1 Scope & Goals
23
-
This repository contains a **Ginkgo v2 / Gomega** test harness that exercises an
23
+
This folder contains a **Ginkgo v2 / Gomega** test harness that exercises an
24
24
NVIDIA Container Toolkit (CTK) installation on a **remote GPU‑enabled host** via
25
25
SSH. The suite validates that:
26
26
@@ -58,12 +58,13 @@ compatibility runs, and pre‑release validation of new CTK builds.
58
58
59
59
| Variable | Required | Example | Description |
60
60
|----------|----------|---------|-------------|
61
-
|`INSTALL_CTK`| ✖ |`true`| When `true` the test installs CTK on the remote host before running the image. When `false` it assumes CTK is already present. |
62
-
|`TOOLKIT_IMAGE`| ✔ |`nvcr.io/nvidia/cuda:12.4.0-runtime-ubi9`| Image that will be pulled & executed. |
63
-
|`SSH_KEY`| ✔ |`/home/ci/.ssh/id_rsa`| Private key used for authentication. |
64
-
|`SSH_USER`| ✔ |`ubuntu`| Username on the remote host. |
65
-
|`REMOTE_HOST`| ✔ |`gpurunner01.corp.local`| Hostname or IP address of the target node. |
66
-
|`REMOTE_PORT`| ✔ |`22`| SSH port of the target node. |
61
+
|`E2E_INSTALL_CTK`| ✖ |`true`| When `true` the test installs CTK on the remote host before running the image. When `false` it assumes CTK is already present. |
This downloads the image on the remote host, installs CTK (if requested), and
103
-
executes a minimal CUDA‑based workload.
104
-
105
-
---
106
-
107
-
## 7 Internal test flow
91
+
## 6 Internal test flow
108
92
109
93
| Phase | Key function(s) | Notes |
110
94
|-------|-----------------|-------|
@@ -116,7 +100,7 @@ executes a minimal CUDA‑based workload.
116
100
117
101
---
118
102
119
-
## 8 Extending the suite
103
+
## 7 Extending the suite
120
104
121
105
1. Create a new `_test.go` file under `tests/e2e`.
122
106
2. Use the Ginkgo DSL (`Describe`, `When`, `It` …). Each leaf node receives a
@@ -127,14 +111,14 @@ executes a minimal CUDA‑based workload.
127
111
128
112
---
129
113
130
-
## 9 Common issues & fixes
114
+
## 8 Common issues & fixes
131
115
132
116
| Symptom | Likely cause | Fix |
133
117
|---------|--------------|-----|
134
118
| `Permission denied (publickey)` | Wrong `SSH_KEY` or `SSH_USER` | Check variables; ensure key is readable by the CI user. |
135
119
|`docker: Error response from daemon: could not select device driver` | CTK not installed or wrong runtime class | Verify `INSTALL_CTK=true` or confirm CTK installation on the host. |
136
120
| Test hangs at image pull | No outbound internet on remote host | Pre‑load the image or use a local registry mirror. |
137
121
138
-
## 10 License
122
+
## 9 License
139
123
Distributed under the terms of the **Apache License 2.0** (see header).
0 commit comments