containers
/
podman
mirror of https://github.com/containers/podman.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #23223 from baude/libkrundoc 

add libkrun test docs
This commit is contained in:
openshift-merge-bot[bot] 2024-07-09 14:45:51 +00:00 committed by GitHub
parent baafdbb151 6f6e0e7126
commit dad2d17e1c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 30 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
pkg/machine/e2e/README.md
View File

@ -1,38 +1,50 @@
# Working README for running the machine tests
# Running the machine tests
This document is a quick how-to run machine tests. Not all dependencies, like
`gvproxy` are documented. You must install `gvproxy` in all cases described below.
## General notes
### Environment must be clean
You must not have any machines defined before running tests. Consider running `podman machine reset` prior to running tests.
### Scoping tests
You can scope tests in the machine suite by adding various incantations of `FOCUS=`. For example, add `FOCUS_FILE=basic_test.go` to only run basic test. Or add `FOCUS="simple init with start"` to only run one test case. For windows, the syntax differs slightly. In windows, executing something like following achieves the same result:
`./winmake localmachine "basic_test.go start_test.go"`
Note: you must not have any machines defined before running tests
## Linux
### QEMU
1. `make localmachine`
`make localmachine`
## Microsoft Windows
### Hyper-V
1. Open a powershell as admin
1. $env:CONTAINERS_MACHINE_PROVIDER="hyperv"
1. `$env:CONTAINERS_MACHINE_PROVIDER="hyperv"`
1. `./winmake localmachine`
Note: To run specific test files, add the test files to the end of the winmake command:
`./winmake localmachine "basic_test.go start_test.go"`
### WSL
1. Open a powershell as a regular user
1. Build and copy win-sshproxy into bin/
1. `./winmake localmachine`
Note: To run specific test files, add the test files to the end of the winmake command:
`./winmake localmachine "basic_test.go start_test.go"`
## macOS
### Apple Hypervisor
1. `make podman-remote`
1. `make localmachine` (Add `FOCUS_FILE=basic_test.go` to only run basic test. Or add `FOCUS="simple init with start"` to only run one test case)
## MacOS
Macs now support two different machine providers: `applehv` and `libkrun`. The `applehv` provider is the default.
Note: On macOS, an error will occur if the path length of `$TMPDIR` is longer than 22 characters. Please set the appropriate path to `$TMPDIR`. Also, if `$TMPDIR` is empty, `/private/tmp` will be set.
### Apple Hypervisor
1. `brew install vfkit`
1. `make podman-remote`
1. `make localmachine`
### [Libkrun](https://github.com/containers/libkrun)
1. `brew install krunkit`
1. `make podman-remote`
1. `export CONTAINERS_MACHINE_PROVIDER="libkrun"`
1. `make localmachine`