From 7f8500199d6d430fd631159ea9ab3caa93d29064 Mon Sep 17 00:00:00 2001
From: Chris Farhood <chris@farhood.org>
Date: Mon, 20 Jul 2026 09:59:26 -0400
Subject: [PATCH] ci: tag release image with semver so it can be pinned

Trigger the image build on v* tags and, on a version tag, publish the semver
(X.Y.Z) alongside :latest and the commit SHA. Previously only :latest and
:<sha> were pushed and the build never fired on the release tag, so there was
no stable version to pin against.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NGzHtDvJur9U7ysgRKRUTN
---
 .gitea/workflows/build.yaml | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/.gitea/workflows/build.yaml b/.gitea/workflows/build.yaml
index 554d5ca..fb9b4e8 100644
--- a/.gitea/workflows/build.yaml
+++ b/.gitea/workflows/build.yaml
@@ -3,6 +3,7 @@ name: build-image
 on:
   push:
     branches: [main]
+    tags: ["v*"]
   workflow_dispatch:
 
 permissions:
@@ -46,15 +47,25 @@ jobs:
         run: |
           echo "${{ secrets.REGISTRY_TOKEN }}" | docker login git.farh.net -u cpfarhood --password-stdin
 
-      - name: Build image
+      - name: Build and push image
         run: |
-          docker build --progress=plain \
-            -t "${IMAGE}:latest" \
-            -t "${IMAGE}:${GITHUB_SHA}" \
-            .
+          # Always tag the immutable commit SHA. On a version tag (refs/tags/vX.Y.Z)
+          # also publish the semver (X.Y.Z) so images can be pinned, and move :latest.
+          # On a main-branch push, publish :latest.
+          REFS="${IMAGE}:${GITHUB_SHA}"
+          case "${GITHUB_REF}" in
+            refs/tags/v*)
+              VERSION="${GITHUB_REF#refs/tags/v}"
+              REFS="${REFS} ${IMAGE}:${VERSION} ${IMAGE}:latest"
+              ;;
+            *)
+              REFS="${REFS} ${IMAGE}:latest"
+              ;;
+          esac
 
-      - name: Push image
-        run: |
-          docker push "${IMAGE}:latest"
-          docker push "${IMAGE}:${GITHUB_SHA}"
-          echo "pushed ${IMAGE}:latest and ${IMAGE}:${GITHUB_SHA}"
+          BUILD_ARGS=""
+          for r in ${REFS}; do BUILD_ARGS="${BUILD_ARGS} -t ${r}"; done
+          docker build --progress=plain ${BUILD_ARGS} .
+
+          for r in ${REFS}; do docker push "${r}"; done
+          echo "pushed: ${REFS}"