Skip to content

Commit

Permalink
Add runtime instructions
Browse files Browse the repository at this point in the history
Adds instructions for installing dependencies and optional environment
variables that might help users.
  • Loading branch information
grisu48 committed Dec 5, 2024
1 parent 75bedb1 commit fa5c241
Showing 1 changed file with 43 additions and 3 deletions.
46 changes: 43 additions & 3 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,31 @@ How can I contribute?
What do I need to contribute?
-----------------------------

* A host with python 3.6+, gcc and the python development header files
* tox
* go
* A host with `python` 3.6+ and `tox`
* docker and/or podman+buildah
* vagrant (optional, can be used to test FIPS mode and registered hosts)

Test setup on openSUSE
^^^^^^^^^^^^^^^^^^^^^^

It is recommended to run BCI tests in its own virtual environment by doing the following:

.. code-block:: shell-session
$ sudo zypper in python3-virtualenv
$ virtualenv .bci_tester
$ source .bci_tester/bin/activate
Once the virtual environment `.bci_tester` has been setup, you only need to run `source .bci_tester/bin/activate` again to activate it.

To setup the test environment on openSUSE Leap 15.6 and Tumbleweed, run the following commands:

.. code-block:: shell-session
$ sudo zypper -n in podman buildah docker git-core python3 python3-pip
$ pip3 --quiet install --upgrade pip
$ pip3 --quiet install tox --ignore-installed six
How can I run the tests?
------------------------

Expand All @@ -43,6 +62,27 @@ How can I run the tests?
will reduce the danger of race conditions when building containers)
4. Run ``tox -e $language_stack -- -n auto``

Environment variables
^^^^^^^^^^^^^^^^^^^^^

You can set the following environment variables to configure the behavior of the BCI-Tests:

.. code-block:: shell-session
$ export OS_VERSION=15.6 # Target SLES version
$ export CONTAINER_RUNTIME=podman # Defaults to podman
$ export TARGET=ibs-cr # Set container to be tested, see below
Available `TARGET` settings are the following:

ibs SUSE:SLE-15-SP*:Update:BCI
ibs-cr Pending ToTest containers
ibs-released Release BCI container
obs devel:BCI:* on OBS
factory-totest Factory
factory-arm-totest Factory for ARM/aarch64
manual Test the container defined by CONTAINER_URL

Technical contributions
-----------------------

Expand Down

0 comments on commit fa5c241

Please sign in to comment.