The open source OpenXR runtime
ci: Add a README for the CI stuff and script to install CI fairy.
+52
-1
+38
.gitlab-ci/README.md
+38
.gitlab-ci/README.md
···
1
+
# CI and Generated Stuff Readme
2
+
3
+
<!--
4
+
# Copyright 2018-2022 Collabora, Ltd. and the Monado contributors
5
+
#
6
+
# SPDX-License-Identifier: CC0-1.0
7
+
-->
8
+
9
+
We use the FreeDesktop
10
+
["CI Templates"](https://freedesktop.pages.freedesktop.org/ci-templates) to
11
+
maintain build containers using code in this repo, storing the images in GitLab
12
+
Registry. Our CI files (and some other files) are auto-generated from Jinja
13
+
templates and `config.yml`, using
14
+
[ci-fairy](https://freedesktop.pages.freedesktop.org/ci-templates/ci-fairy.html).
15
+
You can install it with:
16
+
17
+
<!-- do not break the following line, it is used in CI setup too, to make sure it works -->
18
+
```sh
19
+
python3 -m pip install git+https://gitlab.freedesktop.org/freedesktop/ci-templates@d5aa3941aa03c2f716595116354fb81eb8012acb
20
+
```
21
+
22
+
On Windows you will also need to have GNU make and busybox installed, such as with:
23
+
24
+
```pwsh
25
+
scoop install make busybox
26
+
```
27
+
28
+
To re-generate files, from the root directory, run:
29
+
30
+
```sh
31
+
make -f .gitlab-ci/ci-scripts.mk
32
+
```
33
+
34
+
If you really want to force rebuilding, you can build the clean target first:
35
+
36
+
```sh
37
+
make -f .gitlab-ci/ci-scripts.mk clean all
38
+
```
+3
-1
.gitlab-ci/i386_and_proclamation_container_prep.sh
+3
-1
.gitlab-ci/i386_and_proclamation_container_prep.sh
···
1
1
#!/bin/bash
2
-
# Copyright 2018-2021, Collabora, Ltd. and the Monado contributors
2
+
# Copyright 2018-2022, Collabora, Ltd. and the Monado contributors
3
3
# SPDX-License-Identifier: BSL-1.0
4
4
5
5
(
6
6
cd $(dirname $0)
7
7
bash ./install-cross.sh
8
+
# Using this script "follows the instructions" for some testing of our instructions.
9
+
bash ./install-ci-fairy.sh
8
10
)
9
11
10
12
python3 -m pip install proclamation cmakelang
+11
.gitlab-ci/install-ci-fairy.sh
+11
.gitlab-ci/install-ci-fairy.sh
···
1
+
#!/bin/sh
2
+
# SPDX-License-Identifier: CC0-1.0
3
+
# SPDX-FileCopyrightText: 2018-2022 Collabora, Ltd. and the Monado contributors
4
+
5
+
# This runs the command in the README as an extra bit of continuous integration.
6
+
set -e
7
+
8
+
(
9
+
cd "$(dirname "$0")"
10
+
sh -c "$(grep '^python3 -m pip' README.md)"
11
+
)