{"id":26642,"url":"https://patchwork.libcamera.org/api/patches/26642/?format=json","web_url":"https://patchwork.libcamera.org/patch/26642/","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":"<20260506155442.1566744-3-stefan.klug@ideasonboard.com>","date":"2026-05-06T15:54:12","name":"[v1,2/2] Deploy docs to docs.libcamera.org","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"ae78a6b71a9a9b0d1fded7ea3715cd200e996ee5","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/26642/mbox/","series":[{"id":5910,"url":"https://patchwork.libcamera.org/api/series/5910/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5910","date":"2026-05-06T15:54:10","name":"Deploy documentation to docs.libcamera.org","version":1,"mbox":"https://patchwork.libcamera.org/series/5910/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/26642/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/26642/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 E6958BE173\n\tfor ;\n\tWed, 6 May 2026 15:55:36 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 8499963029;\n\tWed, 6 May 2026 17:55:36 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 8448762FE8\n\tfor ;\n\tWed, 6 May 2026 17:55:34 +0200 (CEST)","from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:f191:8aa5:3091:a04d])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 1BA2ED52;\n\tWed, 6 May 2026 17:55:31 +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=\"Wy0oO436\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778082931;\n\tbh=am1aCIC97fpgj/71aAhk9MF0ow43YpXhsEXtVkvu9Eo=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=Wy0oO436kYlcmp3M1Zb1sRaWrlRK+YkjIOH11ukE7UupABMxlzMin5bhrxPX3HFSm\n\twb/5qixDCA1dMTcCGvsnqnibjzT8u2t/RjXL0/SDc2CUgVl9iwBaSp6Sc0MzLcfBEA\n\tPegu9EUtq75UrkRrY0/B6FYogwdpno4aAEz2zoFw=","From":"Stefan Klug ","To":"libcamera-devel@lists.libcamera.org","Cc":"Stefan Klug ","Subject":"[PATCH v1 2/2] Deploy docs to docs.libcamera.org","Date":"Wed, 6 May 2026 17:54:12 +0200","Message-ID":"<20260506155442.1566744-3-stefan.klug@ideasonboard.com>","X-Mailer":"git-send-email 2.51.0","In-Reply-To":"<20260506155442.1566744-1-stefan.klug@ideasonboard.com>","References":"<20260506155442.1566744-1-stefan.klug@ideasonboard.com>","MIME-Version":"1.0","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 docs.libcamera.org. This step\nonly runs on pushes to master and on tag builds. It requires two\nexternal variables:\n\nDEPLOY_SSH_KEY_BASE64: base64 encoded private deploy key\nDEPLOY_KNOWN_HOSTS: Known hosts containing docs.libcamera.org\n\nSigned-off-by: Stefan Klug \n---\n .gitlab-ci/setup-container.sh | 2 ++\n gitlab-ci.yml | 35 ++++++++++++++++++++++++++++++++++-\n 2 files changed, 36 insertions(+), 1 deletion(-)","diff":"diff --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 468f5769eb87..9bbceae38a27 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@@ -437,3 +438,35 @@ 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 == \"master\"\n+ - if: $CI_COMMIT_TAG\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_SSH_KEY_BASE64}\" | base64 --decode > ~/.ssh/id_ed25519\n+ chmod 600 ~/.ssh/id_ed25519\n+ echo \"${DEPLOY_KNOWN_HOSTS}\" > ~/.ssh/known_hosts\n+\n+ - |\n+ rsync -rlz --delete --chmod=Do=rx,Fo=r \\\n+ --exclude .doctrees \\\n+ --exclude .buildinfo \\\n+ --exclude objects.inv \\\n+ build/docs/ \\\n+ deploy@docs.libcamera.org:/$CI_COMMIT_REF_NAME\n","prefixes":["v1","2/2"]}