Getting started
Red Hat associate
If you are a Red Hat associate getting started on the CKI team, start with the internal onboarding documentation.
Development setup
Linux distribution
To start contributing, you don’t need any specific Linux distribution. While we encourage everyone to develop on Fedora Workstation or Fedora Silverblue, this is not a requirement. Where Fedora/RHEL-specific software is needed, container-based alternative workflows are provided.
Install dependencies
Install direnv and tox. Both should be packaged for most distributions and be installable with something like
sudo yum install tox direnv
Cloning CKI repositories and creating forks
For both GitLab instances, create api
GitLab personal access tokens. The
tokens are going to be stored in the COM_GITLAB_TOKEN_PERSONAL
and
CEE_GITLAB_TOKEN_PERSONAL
environment variables below.
The following bash commands temporarily bootstrap cki-tools, and then use the
included repo-manager
module to clone all repositories including forks and
setup pip:
mkdir ~/git-temp ~/git-cki
cd ~/git-temp
echo "export GITLAB_TOKENS='{\"gitlab.com\":\"COM_GITLAB_TOKEN_PERSONAL\", \"gitlab.cee.redhat.com\":\"CEE_GITLAB_TOKEN_PERSONAL\"}'" > .envrc
echo 'export COM_GITLAB_TOKEN_PERSONAL="your-secret-token-from-gitlab-com"' >> .envrc
echo 'export CEE_GITLAB_TOKEN_PERSONAL="your-secret-token-from-gitlab-cee"' >> .envrc
cp .envrc ~/git-cki/
git clone git@gitlab.com:cki-project/cki-tools
cd cki-tools
printf 'layout python3\nsource_up\n' > .envrc
direnv allow
pip install -e .
python3 -m cki.cki_tools.repo_manager --directory ~/git-cki --fork fork --venv --force
cd ~/git-cki
rm -rf ~/git-temp
Linting and tests
Python-based projects
Linting, unit tests and code coverage checks are implemented in cki_lint.sh and can be invoked in a clean environment by running
tox
To run tox with a different Python version, explicitly specify the Python interpreter via
python3.9 -m tox
In the case of host problems, e.g. if no venv is available, the Python version is too old or certificates are not setup correctly, tox can also be run in a container via
podman run --rm --workdir /code --volume .:/code \
registry.gitlab.com/cki-project/cki-tools/cki-tools:production \
tox --workdir .tox-container
Individual tests can also be run directly on the host via any of
python3 -m unittest tests.test_module
python3 -m unittest tests/test_file_name.py
pytest tests/test_file_name.py
The cki-lib README.md file contains the parameters for correct editor integration of linters/fixers for CKI code.
Pipeline code
In com/pipeline-definition, the linting and testing can be invoked locally via
./lint.sh
./tests.sh
or in a container via
podman run --rm --workdir /code --volume .:/code \
registry.gitlab.com/cki-project/cki-tools/cki-tools:production \
./lint.sh
podman run --rm --workdir /code --volume .:/code \
registry.gitlab.com/cki-project/containers/builder-fedora:latest \
./tests.sh