Patch Detail
Show a patch.
GET /api/patches/26756/?format=api
{ "id": 26756, "url": "https://patchwork.libcamera.org/api/patches/26756/?format=api", "web_url": "https://patchwork.libcamera.org/patch/26756/", "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": "<20260514101429.552173-3-stefan.klug@ideasonboard.com>", "date": "2026-05-14T10:14:17", "name": "[v4,2/2] Deploy docs to docs.libcamera.org", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": false, "hash": "a60a8985fe1528704276f663914f72dfd608492e", "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/26756/mbox/", "series": [ { "id": 5945, "url": "https://patchwork.libcamera.org/api/series/5945/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=5945", "date": "2026-05-14T10:14:15", "name": "Deploy documentation to docs.libcamera.org", "version": 4, "mbox": "https://patchwork.libcamera.org/series/5945/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/26756/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/26756/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 1BAA0BDCBD\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 14 May 2026 10:14:40 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id C7A2E63026;\n\tThu, 14 May 2026 12:14:39 +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 261906301A\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 14 May 2026 12:14:39 +0200 (CEST)", "from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:1c97:ae49:136:40fb])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 0F08ED7E;\n\tThu, 14 May 2026 12:14:30 +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=\"krDaQN47\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778753670;\n\tbh=Xaa6d1nDLD6WsCznlk8bq9mWdeGO+uKwufkhBYPLpCs=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=krDaQN47GlfKEI4jZPHxbmMFTZCuA8tQ1VeRFt0eJhTqZ1MFqr4+1XlEZKgXnV4bk\n\t74cheoPGpz0SU4S4Rkd46EteCOeZd6J9qgosI74QFYHdWBBK5Tm+rWGF+wpvNAKxA6\n\tocESQxqarBKzf4MWHgqn/DXl6jgXmtBLx0ibTDMc=", "From": "Stefan Klug <stefan.klug@ideasonboard.com>", "To": "libcamera-devel@lists.libcamera.org", "Cc": "Stefan Klug <stefan.klug@ideasonboard.com>, =?utf-8?q?Barnab=C3=A1s_P?=\n\t=?utf-8?b?xZFjemU=?= <barnabas.pocze@ideasonboard.com>, Laurent Pinchart\n\t<laurent.pinchart@ideasonboard.com>", "Subject": "[PATCH v4 2/2] Deploy docs to docs.libcamera.org", "Date": "Thu, 14 May 2026 12:14:17 +0200", "Message-ID": "<20260514101429.552173-3-stefan.klug@ideasonboard.com>", "X-Mailer": "git-send-email 2.51.0", "In-Reply-To": "<20260514101429.552173-1-stefan.klug@ideasonboard.com>", "References": "<20260514101429.552173-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>\nReviewed-by: Barnabás Pőcze <barnabas.pocze@ideasonboard.com>\nReviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\n\n---\n\nChanges in v4:\n- Collected tag\n- Added check for $DEPLOY_DESTINATION to prevent deployments in personal\n ci setups\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 278e69079c15..aad411c4e3d8 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@@ -440,3 +441,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 && $DEPLOY_DESTINATION\n+ - if: $CI_COMMIT_TAG =~ /^v([0-9]+\\.)*[0-9]+$/ && $DEPLOY_DESTINATION\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": [ "v4", "2/2" ] }