GitHubにタグをpushするだけでリリースを作成できるようにする

name: Release

on:
  push:
    # タグの形式は v1.2.3 のような形式を想定。ここを変えればどんな形式でも使えます。
    tags:
      - 'v*.*.*'

jobs:
  release:
    name: Release
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v5

      # ポイント1: これをやらないとタグの情報を読めない。
      - name: Pull tags
        run: git fetch --tags --force

      # このあたりでビルドなどの作業をする。
      - uses: actions/setup-node@v5
        with:
          node-version: '24'
      - run: npm ci
      - run: npm run build
      # ビルド作業ここまで。

      # ポイント2: git tag -l でタグのアノテーションを読み取ることができる。
      - name: Extract release info
        id: metadata
        run: |
          echo "title=$(git tag -l --format '%(subject)' ${{github.ref_name}})" >> $GITHUB_OUTPUT
          echo "release_note<<EOF" >> $GITHUB_OUTPUT
          git tag -l --format '%(contents:body)' ${{github.ref_name}} >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT          

      # ポイント3: リリースの作成はghコマンドでできる。
      # この例ではdistディレクトリ以下のファイルをすべてアセットとしてアップロードしている。
      - name: Create GitHub Release
        run: |
          gh release create ${{github.ref_name}} \
            --title "${{ steps.metadata.outputs.title }}" \
            --notes "${{ steps.metadata.outputs.release_note }}" \
            ./dist/*          
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

$ git tag -a v1.2.3  # これをやるとエディタが開いてアノテーションを書ける。

$ git tag -a v1.2.3 -m "Release v1.2.3"  # -m オプションで指定することもできる。

$ gh release create <タグ名> --title "<タイトル>" --notes "<説明>" <アセット1> <アセット2> ...

jobs:
  release:
    name: Release
    runs-on: ubuntu-latest
    permissions:
      contents: write  # ← これ

# タグを作る
$ git tag -a v1.2.3
(エディタが開くので、1行目にリリースのタイトル、3行目以降に説明文をMarkdown形式で書く)

# タグをpushする
$ git push origin v1.2.3

# すでに作ったリリースを削除する（GitHubのWebページからやってもOK）
$ gh release delete v1.2.3

# force (-f) オプションを付けてタグを作りなおす
$ git tag -f -a v1.2.3

# force (-f) オプションを付けてpushしなおす
$ git push -f origin v1.2.3