Skip to content

Runs release-it as a GitHub Action, with handling for semantic releases and protected branches. πŸ“€

License

Notifications You must be signed in to change notification settings

JoshuaKGoldberg/release-it-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

release-it-action

Runs release-it as a GitHub Action, with handling for semantic releases and protected branches. πŸ“€

All Contributors: 1 Codecov Test Coverage Contributor Covenant License: MIT Style: Prettier TypeScript: Strict npm package version

Usage

This action works by:

  1. Checking should-semantic-release for whether a new release is necessary, and bailing if not
  2. Fetching any existing branch protections for the configured branch, and temporarily deleting them if found
  3. Running release-it
  4. Restoring any temporarily deleted branch protections

Run JoshuaKGoldberg/release-it-action in a GitHub workflow after building your code and setting your npm token:

concurrency:
  group: ${{ github.workflow }}

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          ref: main
      - run: npm build
      - env:
          GITHUB_TOKEN: ${{ secrets.ACCESS_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
        uses: JoshuaKGoldberg/release-it-action@v0.2.2

name: Release

on:
  push:
    branches:
      - main

permissions:
  contents: write
  id-token: write

Options

Key Type Default Description
branch string "main" Branch to delete and recreate branch protections on (unless skip-branch-protections).
git-user-email string ${<git-user-name>}@users.noreply.github.com git config user.email value for Git commits.
git-user-name string ${github.context.actor} git config user.name value for Git commits.
github-token string ${GITHUB_TOKEN} GitHub token (PAT) with repo and workflow permissions.
npm-token string ${NPM_TOKEN} npm access token with the automation role.
skip-branch-protections boolean false Whether to skip deleting and recreating branch protections.

Node API

release-it-action can be installed as a dependency that exports a releaseItAction function:

npm i release-it-action
import { releaseItAction } from "release-it-action";

await releaseItAction({
	branch: "main",
	gitUserEmail: "your@email.com",
	gitUserName: "YourUsername",
	githubToken: process.env.GITHUB_TOKEN,
	npmToken: process.env.NPM_TOKEN,
	owner: "YourUsername",
	repo: "your-repository",
});

Note that all non-boolean inputs are required and do not have default values in the Node API.

FAQs

Why does the checkout action run on the branch with full history?

release-it-action needs to run on the latest commit on the default/release branch and with a concurrency group. Otherwise, if multiple workflows are triggered quickly, later workflows might not include release commits from earlier workflows.

Why does this delete and recreate branch protections?

It would be great to instead either change which branch is protected or have a native GitHub API to disable a branch protection rule. Neither exist at time of writing. If you know that one now exists, please do file an issue!

See:

  • #13 for supporting bypassing PR allowances
  • #14 for supporting dismissal restrictions

Contributors

Josh Goldberg ✨
Josh Goldberg ✨

πŸ’» πŸ–‹ πŸ“– πŸ€” πŸš‡ 🚧 πŸ“† πŸ”§ πŸ› ⚠️

πŸ’™ This package is based on @JoshuaKGoldberg's create-typescript-app.

About

Runs release-it as a GitHub Action, with handling for semantic releases and protected branches. πŸ“€

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks