Add release-suffixed tags to Docker images for version pinning (#326)

Adds additional Docker image tags suffixed with the GitHub release version
alongside standard tags. This gives downstream projects better control over
version pinning and the ability to target specific releases of base images.

For example, on release 2025.11.0, these tags will be published:
 - amd64-base:3.21 AND amd64-base:3.21-2025.11.0
 - amd64-base-python:3.13-alpine3.21 AND amd64-base-python:3.13-alpine3.21-2025.11.0

Author: sairon

.github/workflows/builder.yml

@@ -89,12 +89,17 @@ jobs:
       - name: Set build arguments
         shell: bash
         run: |
-          if [[ "${{ github.event_name }}" != "release" ]]; then
-            echo "BUILD_ARGS=--test" >> $GITHUB_ENV
-          elif [[ "${{ env.ALPINE_LATEST }}" != "${{ matrix.version }}" ]]; then
-            echo "BUILD_ARGS=--no-latest" >> $GITHUB_ENV
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            BUILD_ARGS="--additional-tag ${{ matrix.version }}-${{ github.event.release.tag_name }}"
+            if [[ "${{ env.ALPINE_LATEST }}" != "${{ matrix.version }}" ]]; then
+              BUILD_ARGS="$BUILD_ARGS --no-latest"
+            fi
+          else
+            BUILD_ARGS="--test"
           fi
 
+          echo "BUILD_ARGS=$BUILD_ARGS" >> $GITHUB_ENV
+
       - name: Build base image
         uses: home-assistant/builder@2025.09.0
         with:
@@ -122,12 +127,17 @@ jobs:
       - name: Set build arguments
         shell: bash
         run: |
-          if [[ "${{ github.event_name }}" != "release" ]]; then
-            echo "BUILD_ARGS=--test" >> $GITHUB_ENV
-          elif [[ "${{ env.DEBIAN_LATEST }}" != "${{ matrix.version }}" ]]; then
-            echo "BUILD_ARGS=--no-latest" >> $GITHUB_ENV
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            BUILD_ARGS="--additional-tag ${{ matrix.version }}-${{ github.event.release.tag_name }}"
+            if [[ "${{ env.DEBIAN_LATEST }}" != "${{ matrix.version }}" ]]; then
+              BUILD_ARGS="$BUILD_ARGS --no-latest"
+            fi
+          else
+            BUILD_ARGS="--test"
           fi
 
+          echo "BUILD_ARGS=$BUILD_ARGS" >> $GITHUB_ENV
+
       - name: Build base image
         uses: home-assistant/builder@2025.09.0
         with:
@@ -156,12 +166,17 @@ jobs:
       - name: Set build arguments
         shell: bash
         run: |
-          if [[ "${{ github.event_name }}" != "release" ]]; then
-            echo "BUILD_ARGS=--test" >> $GITHUB_ENV
-          elif [[ "${{ env.UBUNTU_LATEST }}" != "${{ matrix.version }}" ]]; then
-            echo "BUILD_ARGS=--no-latest" >> $GITHUB_ENV
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            BUILD_ARGS="--additional-tag ${{ matrix.version }}-${{ github.event.release.tag_name }}"
+            if [[ "${{ env.UBUNTU_LATEST }}" != "${{ matrix.version }}" ]]; then
+              BUILD_ARGS="$BUILD_ARGS --no-latest"
+            fi
+          else
+            BUILD_ARGS="--test"
           fi
 
+          echo "BUILD_ARGS=$BUILD_ARGS" >> $GITHUB_ENV
+
       - name: Build base image
         uses: home-assistant/builder@2025.09.0
         with:
@@ -189,12 +204,17 @@ jobs:
       - name: Set build arguments
         shell: bash
         run: |
-          if [[ "${{ github.event_name }}" != "release" ]]; then
-            echo "BUILD_ARGS=--test" >> $GITHUB_ENV
-          elif [[ "${{ env.RASPBIAN_LATEST }}" != "${{ matrix.version }}" ]]; then
-            echo "BUILD_ARGS=--no-latest" >> $GITHUB_ENV
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            BUILD_ARGS="--additional-tag ${{ matrix.version }}-${{ github.event.release.tag_name }}"
+            if [[ "${{ env.RASPBIAN_LATEST }}" != "${{ matrix.version }}" ]]; then
+              BUILD_ARGS="$BUILD_ARGS --no-latest"
+            fi
+          else
+            BUILD_ARGS="--test"
           fi
 
+          echo "BUILD_ARGS=$BUILD_ARGS" >> $GITHUB_ENV
+
       - name: Build base image
         uses: home-assistant/builder@2025.09.0
         with:
@@ -232,12 +252,17 @@ jobs:
       - name: Set build arguments
         shell: bash
         run: |
-          if [[ "${{ github.event_name }}" != "release" ]]; then
-            echo "BUILD_ARGS=--test" >> $GITHUB_ENV
-          elif [[ "${{ env.ALPINE_LATEST }}" != "${{ matrix.version }}" ]] || [[ "${{ env.PYTHON_LATEST }}" != "${{ matrix.python }}" ]]; then
-            echo "BUILD_ARGS=--no-latest" >> $GITHUB_ENV
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            BUILD_ARGS="--additional-tag ${{ matrix.python }}-alpine${{ matrix.version }}-${{ github.event.release.tag_name }}"
+            if [[ "${{ env.ALPINE_LATEST }}" != "${{ matrix.version }}" ]] || [[ "${{ env.PYTHON_LATEST }}" != "${{ matrix.python }}" ]]; then
+              BUILD_ARGS="$BUILD_ARGS --no-latest"
+            fi
+          else
+            BUILD_ARGS="--test"
           fi
 
+          echo "BUILD_ARGS=$BUILD_ARGS" >> $GITHUB_ENV
+
       - name: Build base image
         uses: home-assistant/builder@2025.09.0
         with: