From 5abab5d4daba88c45b0f642fde3a9f332d22881a Mon Sep 17 00:00:00 2001 From: Arun Raghavan Date: Tue, 19 Nov 2019 07:35:10 +0530 Subject: [PATCH] doc: Add some documentation on generating CI docker images --- doc/ci.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 doc/ci.md diff --git a/doc/ci.md b/doc/ci.md new file mode 100644 index 000000000..06e154ae5 --- /dev/null +++ b/doc/ci.md @@ -0,0 +1,30 @@ +# Continuous Integration + +Our CI runs on the `gitlab.freedesktop.org` infrastructure. Steps can be found +in the top-level `gitlab-ci.yml` file. + +The current build happens on an x86_64, Fedora 31 image. This should be +extended to other distrubtions and architectures over time. + +## fd.o Registry + +The Docker image used for the build process comes from the +`registry.freedesktop.org` container registry. Images are currently manually +generate and pushed using the top-level `Dockerfile` and the following steps. +The assumption is that you are using `podman` as a `docker` alternative. The +corresponding `docker` command should be easy to find. + +```sh +$ cd + +# Build the image +$ podman build --format=docker -t registry.freedesktop.org/pipewire/pipewire/fedora:31 . + +# This is usually only needed once. You will be prompted for your fd.o +# username, and the password is a personal access token that you must generate +# in the gitlab.fd.o user settings. +$ podman login + +# Upload the image +$ podman push registry.freedesktop.org/pipewire/pipewire/fedora:31 +```