| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 1 | # Continuous Integration Scripts |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 2 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 3 | ## Environment Variables |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 4 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 5 | - `ID`: lower-case string that identifies the operating system, for example: `ID=ubuntu`, |
| 6 | `ID=centos`. See [os-release(5)] for more information. On macOS, where `os-release` is |
| 7 | not available, we emulate it by setting `ID=macos`. |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 8 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 9 | - `ID_LIKE`: space-separated list of operating system identifiers that are closely related |
| 10 | to the running OS. See [os-release(5)] for more information. The listed values are used |
| 11 | by the CI scripts to select the proper behavior for different platforms and OS flavors. |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 12 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 13 | Examples: |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 14 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 15 | - On CentOS, `ID_LIKE="centos rhel fedora linux"` |
| 16 | - On Ubuntu, `ID_LIKE="ubuntu debian linux"` |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 17 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 18 | - `VERSION_ID`: identifies the operating system version, excluding any release code names. |
| 19 | See [os-release(5)] for more information. Examples: `VERSION_ID=42`, `VERSION_ID=22.04`. |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 20 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 21 | - `JOB_NAME`: defines the type of the current CI job. Depending on the job type, the CI |
| 22 | scripts can perform different tasks. |
| 23 | |
| 24 | Supported values: |
| Joao Pereira | ef326da | 2015-05-27 18:27:40 -0400 | [diff] [blame] | 25 | |
| Davide Pesavento | d839882 | 2020-03-29 18:46:19 -0400 | [diff] [blame] | 26 | - empty: default build task |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 27 | - `code-coverage`: debug build with tests and code coverage analysis |
| Davide Pesavento | d839882 | 2020-03-29 18:46:19 -0400 | [diff] [blame] | 28 | - `limited-build`: only a single debug build with tests |
| Davide Pesavento | 956ac31 | 2016-09-20 19:11:30 +0200 | [diff] [blame] | 29 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 30 | - `CACHE_DIR`: directory containing cached files from previous builds, e.g., a compiled |
| 31 | version of ndn-cxx. If not set, `/tmp` is used. |
| Davide Pesavento | 44660cf | 2017-08-16 00:44:23 -0400 | [diff] [blame] | 32 | |
| Davide Pesavento | bd3642f | 2022-08-12 18:19:31 -0400 | [diff] [blame] | 33 | - `DISABLE_ASAN`: disable building with AddressSanitizer. This is automatically set for |
| 34 | the `code-coverage` job type. |
| 35 | |
| 36 | [os-release(5)]: https://www.freedesktop.org/software/systemd/man/os-release.html |