1721f992191b1117cd05b66394ae031164e01deb
[it/test.git] / XTesting / kubespray / docs / ci-setup.md
1 # CI Setup
2
3 ## Pipeline
4
5 1. unit-tests: fast jobs for fast feedback (linting, etc...)
6 2. deploy-part1: small number of jobs to test if the PR works with default settings
7 3. deploy-part2: slow jobs testing different platforms, OS, settings, CNI, etc...
8 4. deploy-part3: very slow jobs (upgrades, etc...)
9
10 ## Runners
11
12 Kubespray has 3 types of GitLab runners:
13
14 - packet runners: used for E2E jobs (usually long)
15 - light runners: used for short lived jobs
16 - auto scaling runners: used for on-demand resources, see [GitLab docs](https://docs.gitlab.com/runner/configuration/autoscale.html) for more info
17
18 ## Vagrant
19
20 Vagrant jobs are using the [quay.io/kubespray/vagrant](/test-infra/vagrant-docker/Dockerfile) docker image with `/var/run/libvirt/libvirt-sock` exposed from the host, allowing the container to boot VMs on the host.
21
22 ## CI Variables
23
24 In CI we have a set of overrides we use to ensure greater success of our CI jobs and avoid throttling by various APIs we depend on. See:
25
26 - [Docker mirrors](/tests/common/_docker_hub_registry_mirror.yml)
27 - [Test settings](/tests/common/_kubespray_test_settings.yml)