shelfmark/.github/workflows/build-and-publish-docker-image.yml

name: Create and publish Docker images
on:
  push:
    tags:
      - 'v*'
  schedule:
    # Nightly at 03:17 UTC — only builds if there are new commits on main
    # since the last successful run (see check-changes job).
    - cron: '17 3 * * *'
  workflow_dispatch:
permissions: read-all

env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository_owner }}/shelfmark
jobs:
  check-changes:
    runs-on: ubuntu-latest
    outputs:
      should_build: ${{ steps.check.outputs.should_build }}
    steps:
      - name: Check for new commits since last successful build
        id: check
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          EVENT_NAME: ${{ github.event_name }}
          CURRENT_SHA: ${{ github.sha }}
          REPO: ${{ github.repository }}
        run: |
          # Always build on tag pushes and manual dispatch.
          if [[ "$EVENT_NAME" != "schedule" ]]; then
            echo "Event is $EVENT_NAME — building unconditionally."
            echo "should_build=true" >> "$GITHUB_OUTPUT"
            exit 0
          fi

          # Scheduled run: only build if HEAD differs from the last successful build on main.
          LAST_SHA=$(gh api "/repos/${REPO}/actions/workflows/build-and-publish-docker-image.yml/runs?branch=main&status=success&per_page=1" --jq '.workflow_runs[0].head_sha' 2>/dev/null || true)
          echo "Last successful build SHA: ${LAST_SHA:-<none>}"
          echo "Current HEAD SHA:          ${CURRENT_SHA}"
          if [[ -z "$LAST_SHA" || "$LAST_SHA" != "$CURRENT_SHA" ]]; then
            echo "New commits detected — building."
            echo "should_build=true" >> "$GITHUB_OUTPUT"
          else
            echo "No new commits since last successful build — skipping."
            echo "should_build=false" >> "$GITHUB_OUTPUT"
          fi

  build-and-push-images:
    needs: check-changes
    if: needs.check-changes.outputs.should_build == 'true'
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: write
      attestations: write
      id-token: write
    strategy:
      matrix:
        include:
          - target: shelfmark
          - target: shelfmark-lite
            image_name_suffix: "-lite"
    steps:
      - name: Get current date
        id: date
        run: echo "date=$(date +'%Y-%m-%d')" >> $GITHUB_OUTPUT

      - name: Checkout repository
        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0

      - name: Log in to the Container registry
        uses: docker/login-action@dbcb813823bdd20940b903addbd779551569679f # v4.6.0
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Extract metadata for ${{ matrix.target }} image
        id: meta
        uses: docker/metadata-action@dc802804100637a589fabce1cb79ff13a1411302 # v6.2.0
        env:
          # Annotate both the per-platform manifests and the multi-arch image
          # index. The index level is what manifest-list consumers (Renovate's
          # minimumReleaseAge soak check, provenance/SBOM tooling) read for the
          # standard org.opencontainers.image.* annotations, including `created`.
          DOCKER_METADATA_ANNOTATIONS_LEVELS: index,manifest
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}${{ matrix.image_name_suffix }}
          tags: |
            type=raw,value=dev,enable={{is_default_branch}}
            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/') }}
            type=semver,pattern={{version}}
            type=semver,pattern={{major}}.{{minor}}
            type=sha
            type=ref,event=tag

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@bb05f3f5519dd87d3ba754cc423b652a5edd6d2c # v4.2.0

      - name: Build and push ${{ matrix.target }} Docker image
        id: push
        uses: docker/build-push-action@53b7df96c91f9c12dcc8a07bcb9ccacbed38856a # v7.3.0
        with:
          platforms: linux/amd64,linux/arm64
          context: .
          target: ${{ matrix.target }}
          push: ${{ github.event_name != 'pull_request' }}
          build-args: |
            BUILD_VERSION=${{ steps.date.outputs.date }}-${{ github.sha }}
            RELEASE_VERSION=${{ github.ref_name }}
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          annotations: ${{ steps.meta.outputs.annotations }}

      - name: Generate artifact attestation for ${{ matrix.target }} image
        if: github.event_name != 'pull_request'
        uses: actions/attest-build-provenance@4d101475d8b20a2381f78447822ac1eab6504dd8 # v4.2.2
        with:
          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}${{ matrix.image_name_suffix }}
          subject-digest: ${{ steps.push.outputs.digest }}
          push-to-registry: true

  # Create aliases for backwards compatibility
  create-aliases:
    needs: build-and-push-images
    runs-on: ubuntu-latest
    if: github.event_name != 'pull_request'
    permissions:
      contents: read
      packages: write
    env:
      # Legacy name for backwards compatibility (hardcoded so it works after rename)
      LEGACY_NAME: calibre-web-automated-book-downloader
    steps:
      - name: Log in to registry
        uses: docker/login-action@dbcb813823bdd20940b903addbd779551569679f # v4.6.0
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@bb05f3f5519dd87d3ba754cc423b652a5edd6d2c # v4.2.0

      - name: Create legacy aliases
        run: |
          # Current image names (follows repo name)
          STANDARD="${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}"
          LITE="${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}-lite"

          # Legacy image names (hardcoded for backwards compatibility)
          LEGACY="${{ env.REGISTRY }}/${{ github.repository_owner }}/${{ env.LEGACY_NAME }}"
          LEGACY_TOR="${LEGACY}-tor"
          LEGACY_EXTBP="${LEGACY}-extbp"

          SHA_SHORT=$(echo "${{ github.sha }}" | cut -c1-7)

          # Helper function to create alias with all standard tags
          create_alias() {
            local SOURCE=$1
            local ALIAS=$2

            # Always create SHA tag
            docker buildx imagetools create -t "${ALIAS}:sha-${SHA_SHORT}" "${SOURCE}:sha-${SHA_SHORT}"

            if [[ "${{ github.ref }}" == refs/tags/v* ]]; then
              VERSION="${{ github.ref_name }}"
              VERSION_NUM="${VERSION#v}"
              MINOR="${VERSION_NUM%.*}"

              docker buildx imagetools create -t "${ALIAS}:latest" "${SOURCE}:latest"
              docker buildx imagetools create -t "${ALIAS}:${VERSION_NUM}" "${SOURCE}:${VERSION_NUM}"
              docker buildx imagetools create -t "${ALIAS}:${MINOR}" "${SOURCE}:${MINOR}"
              docker buildx imagetools create -t "${ALIAS}:${VERSION}" "${SOURCE}:${VERSION}"
            else
              docker buildx imagetools create -t "${ALIAS}:dev" "${SOURCE}:dev"
            fi
          }

          # Create legacy aliases pointing to current images
          # calibre-web-automated-book-downloader → standard image
          create_alias "${STANDARD}" "${LEGACY}"

          # calibre-web-automated-book-downloader-tor → standard image
          create_alias "${STANDARD}" "${LEGACY_TOR}"

          # calibre-web-automated-book-downloader-extbp → lite image
          create_alias "${LITE}" "${LEGACY_EXTBP}"