mitogen/.ci
Alex Willmer 8362d61462 CI: Remove Azure DevOps pipelines (replaced by GitHub Actions)
fixes #1138
2024-10-07 12:47:29 +01:00
..
soak .ci: import soak scripts. 2019-02-18 18:01:54 +00:00
README.md CI: Remove Azure DevOps pipelines (replaced by GitHub Actions) 2024-10-07 12:47:29 +01:00
ansible_tests.py ci: Extract container registry location into variables 2024-09-26 03:13:22 +01:00
ci_lib.py ci: Extract container registry location into variables 2024-09-26 03:13:22 +01:00
debops_common_install.py ci: Extract container registry location into variables 2024-09-26 03:13:22 +01:00
debops_common_tests.py ci: Extract container registry location into variables 2024-09-26 03:13:22 +01:00
localhost_ansible_tests.py tests: Remove --limit when running Ansible localhost CI 2024-05-10 15:58:17 +02:00
mitogen_py24_install.py ci: Move container registry authentication to an Azure Devops step 2024-09-26 03:13:22 +01:00
mitogen_py24_tests.py issue #477: add mitogen_py24 CI test type. 2019-01-26 22:00:30 +00:00
mitogen_tests.py issue #482: ci: add stray process checks to all jobs 2019-08-09 20:19:16 +01:00

README.md

.ci

This directory contains scripts for Continuous Integration platforms. Currently GitHub Actions, but ideally they will also run on any Debian-like machine.

The scripts are usually split into _install and _test steps. The _install step will damage your machine, the _test step will just run the tests the way CI runs them.

There is a common library, ci_lib.py, which just centralized a bunch of random macros and also environment parsing.

Some of the scripts allow you to pass extra flags through to the component under test, e.g. ../../.ci/ansible_tests.py -vvv will run with verbose.

Hack these scripts until your heart is content. There is no pride to be found here, just necessity.

ci_lib.run_batches()

There are some weird looking functions to extract more paralellism from the build. The above function takes lists of strings, arranging for the strings in each list to run in order, but for the lists to run in parallel. That's great for doing setup.py install while pulling a Docker container, for example.

Environment Variables

  • DISTRO: the mitogen_ tests need a target Docker container distro. This name comes from the Docker Hub mitogen user, i.e. mitogen/$DISTRO-test
  • DISTROS: the ansible_ tests can run against multiple targets simultaneously, which speeds things up. This is a space-separated list of DISTRO names, but additionally, supports:
    • debian-py3: when generating Ansible inventory file, set ansible_python_interpreter to python3, i.e. run a test where the target interpreter is Python 3.
    • debian*16: generate 16 Docker containers running Debian. Also works with -py3.