Patch Detail
Show a patch.
GET /api/patches/26712/?format=api
{ "id": 26712, "url": "https://patchwork.libcamera.org/api/patches/26712/?format=api", "web_url": "https://patchwork.libcamera.org/patch/26712/", "project": { "id": 1, "url": "https://patchwork.libcamera.org/api/projects/1/?format=api", "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=api", "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=api", "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": "<libcamera-devel-bounces@lists.libcamera.org>", "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 <parsemail@patchwork.libcamera.org>;\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 <libcamera-devel@lists.libcamera.org>;\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 <stefan.klug@ideasonboard.com>", "To": "libcamera-devel@lists.libcamera.org", "Cc": "Stefan Klug <stefan.klug@ideasonboard.com>", "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": "<libcamera-devel.lists.libcamera.org>", "List-Unsubscribe": "<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>", "List-Archive": "<https://lists.libcamera.org/pipermail/libcamera-devel/>", "List-Post": "<mailto:libcamera-devel@lists.libcamera.org>", "List-Help": "<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>", "List-Subscribe": "<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>", "Errors-To": "libcamera-devel-bounces@lists.libcamera.org", "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>" }, "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 <stefan.klug@ideasonboard.com>\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" ] }