.gitlab-ci/README.md

   1 # CI support stuff
   2
   3 ## Docker image
   4
   5 GitLab CI jobs run in a Docker image, defined here. To update that image
   6 (perhaps to install some more packages):
   7
   8 1. Edit `.gitlab-ci/*.Dockerfile` with the changes you want
   9 1. Run `.gitlab-ci/run-docker.sh build --base=debian-stable --base-version=1` to
  10    build the new image (bump the version from the latest listed for that `base`
  11    on https://gitlab.gnome.org/GNOME/glib/container_registry). If rebuilding the
  12    `coverity.Dockerfile` image, you’ll need to have access to [Coverity Scan][cs]
  13    and will need to specify your project name and access token as the environment
  14    variables `COVERITY_SCAN_PROJECT_NAME` and `COVERITY_SCAN_TOKEN`.
  15 1. Run `.gitlab-ci/run-docker.sh push  --base=debian-stable --base-version=1` to
  16    upload the new image to the GNOME GitLab Docker registry
  17     * If this is the first time you're doing this, you'll need to log into the
  18       registry
  19     * If you use 2-factor authentication on your GNOME GitLab account, you'll
  20       need to [create a personal access token][pat] and use that rather than
  21       your normal password — the token should have `read_registry` and
  22       `write_registry` permissions
  23 1. Edit `.gitlab-ci.yml` (in the root of this repository) to use your new
  24    image
  25
  26 [pat]: https://gitlab.gnome.org/-/profile/personal_access_tokens
  27 [cs]: https://scan.coverity.com/