From 946fa75baa0aa7ea601ecdf15ef1d5e7763c9700 Mon Sep 17 00:00:00 2001
From: Erich Blume <blume.erich@gmail.com>
Date: Fri, 1 May 2026 16:58:33 -0700
Subject: [PATCH] C1(valkey-mirror): add valkey container build

Native Dagger build of valkey 8.1.6-r0 on Alpine 3.22. Mirrors upstream
docker.io/valkey/valkey:8.1-alpine for paperless and immich sidecars.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 containers/valkey/container.py          | 47 +++++++++++++++++++++++++
 docs/changelog.d/valkey-mirror.infra.md |  1 +
 service-versions.yaml                   | 12 +++++++
 3 files changed, 60 insertions(+)
 create mode 100644 containers/valkey/container.py
 create mode 100644 docs/changelog.d/valkey-mirror.infra.md

diff --git a/containers/valkey/container.py b/containers/valkey/container.py
new file mode 100644
index 0000000..5d150e7
--- /dev/null
+++ b/containers/valkey/container.py
@@ -0,0 +1,47 @@
+"""Valkey — native Dagger build.
+
+Alpine 3.22 base with the `valkey` apk package (8.1.x — Redis-compatible).
+Mirrors `docker.io/valkey/valkey:8.1-alpine`, used by paperless and immich
+as a cache/queue sidecar.
+"""
+
+import dagger
+from dagger import dag
+
+from blumeops.containers import oci_labels
+
+# Alpine 3.22 ships valkey 8.1.6-r0. Alpine 3.23 jumps to 9.0 — hold on 3.22
+# to keep this a 1:1 swap for the upstream `valkey:8.1-alpine` image.
+VERSION = "8.1.6-r0"
+
+ALPINE_BASE = "alpine:3.22"
+
+
+async def build(src: dagger.Directory) -> dagger.Container:
+    ctr = (
+        dag.container()
+        .from_(ALPINE_BASE)
+        .with_exec(["apk", "add", "--no-cache", f"valkey={VERSION}"])
+        .with_exec(["mkdir", "-p", "/data"])
+        .with_exec(["chown", "valkey:valkey", "/data"])
+        .with_workdir("/data")
+        .with_exposed_port(6379)
+        .with_user("valkey")
+        .with_default_args(
+            args=[
+                "valkey-server",
+                "--bind",
+                "0.0.0.0",
+                "--protected-mode",
+                "no",
+                "--dir",
+                "/data",
+            ]
+        )
+    )
+    return oci_labels(
+        ctr,
+        title="Valkey",
+        description="Valkey high-performance key/value datastore (Redis-compatible)",
+        version=VERSION,
+    )
diff --git a/docs/changelog.d/valkey-mirror.infra.md b/docs/changelog.d/valkey-mirror.infra.md
new file mode 100644
index 0000000..06f8d98
--- /dev/null
+++ b/docs/changelog.d/valkey-mirror.infra.md
@@ -0,0 +1 @@
+Mirror Valkey 8.1 locally as `registry.ops.eblu.me/blumeops/valkey`. Replaces direct pulls of `docker.io/valkey/valkey:8.1-alpine` for paperless and immich sidecars. Built via native Dagger pipeline on Alpine 3.22. Stateless swap — no data migration. Authentik's nix-built Redis remains separate.
diff --git a/service-versions.yaml b/service-versions.yaml
index 42f9c77..76c0655 100644
--- a/service-versions.yaml
+++ b/service-versions.yaml
@@ -125,6 +125,18 @@ services:
     upstream-source: https://github.com/immich-app/immich/releases
     notes: Kustomize manifests with upstream images
 
+  - name: valkey
+    type: argocd
+    last-reviewed: 2026-05-01
+    current-version: "8.1.6-r0"
+    upstream-source: https://pkgs.alpinelinux.org/package/v3.22/community/aarch64/valkey
+    notes: >-
+      Shared Alpine-built valkey image, used as a sidecar/cache by paperless
+      (sidecar) and immich (separate Deployment). Mirrors the upstream
+      docker.io/valkey/valkey:8.1-alpine. Pinned to Alpine 3.22 for valkey 8.1.x;
+      Alpine 3.23 jumps to 9.0. Distinct from authentik-redis (nix-built Redis
+      8.x) which has its own entry.
+
   - name: external-secrets
     type: argocd
     last-reviewed: 2026-03-25