[v2,0/2] Deploy documentation to docs.libcamera.org
mbox series

Message ID 20260511134817.2841886-1-stefan.klug@ideasonboard.com
Headers show
Series
  • Deploy documentation to docs.libcamera.org
Related show

Message

Stefan Klug May 11, 2026, 1:48 p.m. UTC 
Hi all,

This is a first puzzle piece for the libcamera.org infrastructure
migration.

This PR implements building of the libcamera documentation and deploying
it to docs.libcamera.org.  Deployment shall happen on pushes to either
master or a tag. I ran it on my instance, so
https://docs.libcamera.org/master/ contains the actual result.

Changes in v2: This version addresses the comments from the v1 review.
Additionally we found issues in the release build and the meson install
using --tags. In this version I worked around these issues by using a
debug build and installing the whole project, so that we can generate
documentation for current master and the just released v0.7.0. As soon
as these issues are fixed upstream, we can improve the ci.

A run of this version is available here:
https://gitlab.freedesktop.org/stefanklug/libcamera/-/pipelines/1664452

Best regards,
Stefan



Stefan Klug (2):
  Split documentation build into separate build step
  Deploy docs to docs.libcamera.org

 .gitlab-ci/build-libcamera-docs.sh  | 35 +++++++++++++++++
 .gitlab-ci/deploy-libcamera-docs.sh | 23 +++++++++++
 .gitlab-ci/setup-container.sh       |  2 +
 gitlab-ci.yml                       | 59 ++++++++++++++++++++++++++---
 4 files changed, 114 insertions(+), 5 deletions(-)
 create mode 100755 .gitlab-ci/build-libcamera-docs.sh
 create mode 100755 .gitlab-ci/deploy-libcamera-docs.sh