name: Release

on:
  push:
    tags: ['v*']

permissions:
  contents: write
  id-token: write

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }  # Full history for changelog

      - name: Get version
        id: ver
        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT

      - name: Build & push image with version tag
        run: |
          # ... docker build + push with tag ${{ steps.ver.outputs.version }}
          echo "Pushed image: api:${{ steps.ver.outputs.version }}"

      - name: Generate changelog
        id: changelog
        run: |
          PREV_TAG=$(git tag --sort=-version:refname | sed -n '2p')
          echo "## Changes since $PREV_TAG" > changelog.md
          git log --pretty="- %s (%h)" $PREV_TAG..HEAD >> changelog.md

      - name: Create GitHub Release
        uses: softprops/action-gh-release@v1
        with:
          tag_name: v${{ steps.ver.outputs.version }}
          body_path: changelog.md
          generate_release_notes: true

Creating a release:

# Bump version in package.json, then:
git tag -a v2.1.0 -m "Release v2.1.0: Added search API"
git push origin v2.1.0
# → Release pipeline triggers automatically