{"id":26712,"url":"https://patchwork.libcamera.org/api/patches/26712/?format=json","web_url":"https://patchwork.libcamera.org/patch/26712/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20260511134817.2841886-3-stefan.klug@ideasonboard.com>","date":"2026-05-11T13:48:05","name":"[v2,2/2] Deploy docs to docs.libcamera.org","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"ac093d5463fd55af3bc739f31b9115310e367550","submitter":{"id":184,"url":"https://patchwork.libcamera.org/api/people/184/?format=json","name":"Stefan Klug","email":"stefan.klug@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/26712/mbox/","series":[{"id":5932,"url":"https://patchwork.libcamera.org/api/series/5932/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5932","date":"2026-05-11T13:48:03","name":"Deploy documentation to docs.libcamera.org","version":2,"mbox":"https://patchwork.libcamera.org/series/5932/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/26712/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/26712/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 5F9DDBDCBD\n\tfor ;\n\tMon, 11 May 2026 13:48:31 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 0ACBA6301E;\n\tMon, 11 May 2026 15:48:31 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id CB34163024\n\tfor ;\n\tMon, 11 May 2026 15:48:27 +0200 (CEST)","from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:b16a:5ed9:4ada:a95a])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id A0B67593;\n\tMon, 11 May 2026 15:48:20 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"l64FIojC\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778507300;\n\tbh=4xXpRRXdhXgUDXNhGtEnYtg3xE1g5OBXnGJFH+BsFbg=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=l64FIojClLIZu2lb/kjthuoOkUJw1MdoJpwIbniliT7LkZXJ/0P7FylBBqE4S3CjJ\n\t2xxGbzVl8TgT0OqnBhdjxQuuo+v5Ft66krhO20xDA43osl8847Rtapx1EwFGTNQSN4\n\t4OXo01n7hGnvEls2WmdgvlYUhvs5QrBeKUhsQBPE=","From":"Stefan Klug ","To":"libcamera-devel@lists.libcamera.org","Cc":"Stefan Klug ","Subject":"[PATCH v2 2/2] Deploy docs to docs.libcamera.org","Date":"Mon, 11 May 2026 15:48:05 +0200","Message-ID":"<20260511134817.2841886-3-stefan.klug@ideasonboard.com>","X-Mailer":"git-send-email 2.51.0","In-Reply-To":"<20260511134817.2841886-1-stefan.klug@ideasonboard.com>","References":"<20260511134817.2841886-1-stefan.klug@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=UTF-8","Content-Transfer-Encoding":"8bit","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"Add a build step that deploys the docs to a server. This step\nonly runs on pushes to master and on tag builds. It requires three\nexternal variables:\n\nDEPLOY_SSH_KEY_BASE64: base64 encoded private deploy key\nDEPLOY_KNOWN_HOSTS: Known hosts containing the destination\nDEPLOY_DESTINAION: user@host:/ for the rsync push\n\nSigned-off-by: Stefan Klug \n\n---\n\nChanges in v2:\n\n- Moved deployment into script\n- Improved build rules\n- Pipe ssh key into ssh agent instead of creating a file\n---\n .gitlab-ci/deploy-libcamera-docs.sh | 23 +++++++++++++++++++++++\n .gitlab-ci/setup-container.sh | 2 ++\n gitlab-ci.yml | 29 ++++++++++++++++++++++++++++-\n 3 files changed, 53 insertions(+), 1 deletion(-)\n create mode 100755 .gitlab-ci/deploy-libcamera-docs.sh","diff":"diff --git a/.gitlab-ci/deploy-libcamera-docs.sh b/.gitlab-ci/deploy-libcamera-docs.sh\nnew file mode 100755\nindex 000000000000..a6936728c4a9\n--- /dev/null\n+++ b/.gitlab-ci/deploy-libcamera-docs.sh\n@@ -0,0 +1,23 @@\n+#!/bin/bash\n+\n+# SPDX-License-Identifier: GPL-2.0-or-later\n+# SPDX-FileCopyrightText: © 2026 Ideas on Board\n+#\n+# Deploy libcamera docs\n+\n+set -e\n+\n+source \"$(dirname \"$0\")/lib.sh\"\n+\n+libcamera_deploy_docs() {\n+\techo \"Deploying libcamera docs\"\n+\n+\trsync -rlz --delete --chmod=Do=rx,Fo=r \\\n+ --exclude .doctrees \\\n+ --exclude .buildinfo \\\n+ --exclude objects.inv \\\n+ docs/ \\\n+ \"${DEPLOY_DESTINATION}${CI_COMMIT_REF_NAME}\"\n+}\n+\n+run libcamera_deploy_docs\ndiff --git a/.gitlab-ci/setup-container.sh b/.gitlab-ci/setup-container.sh\nindex c7ca6426c3ab..6c4b439b887b 100755\n--- a/.gitlab-ci/setup-container.sh\n+++ b/.gitlab-ci/setup-container.sh\n@@ -132,6 +132,8 @@ case $FDO_DISTRIBUTION_VERSION in\n \t\tpython3-sphinxcontrib.doxylink\n \t\ttexlive-latex-extra\n \t)\n+\t# Packages required to deploy the documentation\n+\tPKGS_LIBCAMERA_RUNTIME+=( openssh-client rsync )\n \t# Tools requires by the lint jobs.\n \tPKGS_LIBCAMERA_RUNTIME+=( clang-format jq python3-autopep8 reuse shellcheck )\n \t# libclang-rt-dev for the clang ASan runtime.\ndiff --git a/gitlab-ci.yml b/gitlab-ci.yml\nindex 7c5e59de30a1..cef5a16de20a 100644\n--- a/gitlab-ci.yml\n+++ b/gitlab-ci.yml\n@@ -5,6 +5,7 @@ stages:\n - build\n - lint\n - test\n+ - deploy\n \n variables:\n FDO_UPSTREAM_REPO: 'camera/libcamera'\n@@ -74,7 +75,7 @@ include:\n .libcamera-ci.debian:13:\n variables:\n FDO_DISTRIBUTION_VERSION: 'trixie'\n- FDO_DISTRIBUTION_TAG: '2026-04-24.0'\n+ FDO_DISTRIBUTION_TAG: '2026-05-06.0'\n \n .container-debian:\n extends:\n@@ -438,3 +439,29 @@ test-lc-compliance:virtual:\n artifacts:\n reports:\n junit: build/lc-compliance-report.xml\n+\n+# ------------------------------------------------------------------------------\n+# Deploy stage - deploy docs if we are building master or a tag\n+# ------------------------------------------------------------------------------\n+\n+deploy-docs:\n+ extends:\n+ - .fdo.distribution-image@debian\n+ - .libcamera-ci.debian:13\n+ - .libcamera-ci.scripts\n+ rules:\n+ - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH\n+ - if: $CI_COMMIT_TAG =~ /^v([0-9]+\\.)*[0-9]+$/\n+ environment: deploy\n+ stage: deploy\n+ needs:\n+ - job: build-docs\n+ script:\n+ - |\n+ mkdir -p ~/.ssh\n+ chmod 700 ~/.ssh\n+ echo \"${DEPLOY_KNOWN_HOSTS}\" > ~/.ssh/known_hosts\n+ eval $(ssh-agent -s)\n+ echo \"${DEPLOY_SSH_KEY_BASE64}\" | base64 -d | ssh-add -\n+\n+ - $CI_PROJECT_DIR/.gitlab-ci/deploy-libcamera-docs.sh\n","prefixes":["v2","2/2"]}