Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[RFE] Add documentation on running the test suite locally #1189

Open
t-lo opened this issue Sep 26, 2023 · 0 comments
Open

[RFE] Add documentation on running the test suite locally #1189

t-lo opened this issue Sep 26, 2023 · 0 comments
Labels
area/tests good first issue Get started with Flatcar contribution with this issue. help wanted kind/docs kind/feature A feature request

Comments

@t-lo
Copy link
Member

t-lo commented Sep 26, 2023

Current situation

Running the qemu test suite locally is pretty straightforward for knowledgeable maintainers. Since it is undocumented it's nigh impossible for the uninitiated to leverage Flatcar's ci automation to run test though.

Impact

Users and contributors don't know that running tests locally is actually very easy.

Ideal future situation

Running tests is documented in https://github.com/flatcar/flatcar-docs .

Implementation options

  • cover ci automation testing
  • cover manual kola runs (advanced testing)

Additional information

Some hints on running tests locally using the ci automation scripts can be taken from https://github.com/flatcar/scripts/blob/main/.github/workflows/run-kola-tests.yaml#L198.

Running individual tests with plain kola is documented here: https://github.com/flatcar/mantle/tree/flatcar-master#kola-run .

Some tests (devcontainer, torcx, etc) will fail, but the tl;dr is

source ci-automation/ci_automation_common.sh
source sdk_container/.repo/manifests/version.txt
# adjust to higher or lower value depending on system RAM
export PARALLEL_TESTS=4
export QEMU_KOLA_SKIP_MANGLE=true

test_run amd64 qemu_uefi
@t-lo t-lo added kind/feature A feature request kind/docs good first issue Get started with Flatcar contribution with this issue. help wanted labels Sep 26, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/tests good first issue Get started with Flatcar contribution with this issue. help wanted kind/docs kind/feature A feature request
Projects
Development

No branches or pull requests

2 participants