mirror of
https://github.com/podman-container-tools/podman.git
synced 2026-08-05 00:15:44 +00:00
docs(test): document hack/ci/ci.sh lima workflow
Add a copy-paste-friendly section to test/README.md covering how to run the hack/ci/ci.sh workflow under Lima, including templatized ci.sh usage, so contributors can reproduce the CI environment locally. Drop the contradictory machine bullet. Fixes #28947 Signed-off-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
This commit is contained in:
parent
ecf88ebdb3
commit
ad09a77141
1 changed files with 42 additions and 0 deletions
|
|
@ -232,3 +232,45 @@ For usage run:
|
||||||
```
|
```
|
||||||
hack/bats --help
|
hack/bats --help
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Reproducing CI failures locally with Lima
|
||||||
|
|
||||||
|
CI jobs whose names end in `/ lima` run inside a Lima VM. To reproduce one,
|
||||||
|
copy the job name before `/ lima` and pass it to `hack/ci/ci.sh`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hack/ci/ci.sh TEST MODE PRIV DISTRO
|
||||||
|
```
|
||||||
|
|
||||||
|
For example, `sys remote rootless fedora-current / lima` becomes:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hack/ci/ci.sh sys remote rootless fedora-current
|
||||||
|
```
|
||||||
|
|
||||||
|
Jobs without the `/ lima` suffix cannot be reproduced this way, including
|
||||||
|
machine tests and Windows and macOS jobs.
|
||||||
|
|
||||||
|
`TEST` is the suite, one of:
|
||||||
|
|
||||||
|
- `build` builds Podman and its documentation
|
||||||
|
- `apiv2` runs API v2 tests
|
||||||
|
- `bindings` runs bindings tests
|
||||||
|
- `bud` runs Buildah bud tests
|
||||||
|
- `compose_v2` runs Docker Compose v2 tests
|
||||||
|
- `docker_py` runs Docker SDK for Python tests
|
||||||
|
- `unit` runs unit tests
|
||||||
|
- `upgrade` runs upgrade tests
|
||||||
|
- `int` runs integration tests
|
||||||
|
- `sys` runs system tests
|
||||||
|
|
||||||
|
`MODE` is `local` or `remote` and defaults to `local`. `PRIV` is `root` or
|
||||||
|
`rootless` and defaults to `rootless`. `DISTRO` is `fedora-current`,
|
||||||
|
`fedora-prior`, `fedora-rawhide`, or `debian-sid`.
|
||||||
|
|
||||||
|
For the `upgrade` suite, `MODE` is the version to upgrade from (for example,
|
||||||
|
`v5.3.1`) instead of `local` or `remote`.
|
||||||
|
|
||||||
|
The script requires [Lima](https://lima-vm.io/docs/installation/). It starts a
|
||||||
|
nested-virtualization VM with 8 GB of memory, copies this repository into it,
|
||||||
|
and runs `hack/ci/runner.sh`, so the host distribution does not matter.
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue