Skip to content

Latest commit

 

History

History
123 lines (92 loc) · 4.78 KB

README.md

File metadata and controls

123 lines (92 loc) · 4.78 KB
Raw

GitHub Action Release

Description

GitHub Action that produces a new Release of an Action - adds a new major tag

Configuration

Step1: Set any Semantic Release Configuration in the consumer repository.

Step2: Add Secrets in the consumer repository for the Semantic Release Authentication Environment Variables.

Step3: Add a Workflow File to the consumer repository to create custom automated processes.

Usage

steps:
  - name: Release
    uses: open-turo/actions-gha/release@v1
    with:
      github-token: ${{ secrets.GITHUB_TOKEN }}

IMPORTANT: GITHUB_TOKEN does not have the required permissions to operate on protected branches. If you are using this action for protected branches, replace GITHUB_TOKEN with Personal Access Token. If using the @semantic-release/git plugin for protected branches, avoid persisting credentials as part of actions/checkout@v4 by setting the parameter persist-credentials: false. This credential does not have the required permission to operate on protected branches.

Inputs

parameter description required default
checkout-repo Perform checkout as first step of action false true
dry-run Whether to run semantic release in dry-run mode. It will override the dryRun attribute in your configuration file false
extra-plugins Extra plugins for pre-install. You can also specify specifying version range for the extra plugins if you prefer. Defaults to install @open-turo/semantic-release-config. false @open-turo/semantic-release-config
github-token GitHub token that can create/delete comments. e.g. 'secrets.GITHUB_TOKEN' false

Outputs

parameter description
new-release-published Whether a new release was published
new-release-version Version of the new release
new-release-major-version Major version of the new release

Runs

This action is a composite action.

Additional Examples

extra-plugins example

The action can be used with extra-plugins option to specify plugins which are not in the default list of plugins of semantic release. When using this option, please make sure that these plugins are also mentioned in your semantic release config's plugins array.

For example, if you want to use @semantic-release/git and @semantic-release/changelog extra plugins, these must be added to extra-plugins in your actions file and plugins in your release config file as shown bellow:

Github Action Workflow:

steps:
  - name: Release
    uses: open-turo/actions-gha/release@v1
    with:
      # You can specify specifying version range for the extra plugins if you prefer.
      extra-plugins: |
        @semantic-release/[email protected]
        @semantic-release/git

Similar to parameter semantic_version. It is recommended to manually specify a version of semantic-release plugins to prevent errors caused.

Release Config:

  plugins: [
    .
+   "@semantic-release/changelog"
+   "@semantic-release/git",
  ]

dry-run example

jobs:
  build:
    steps:
      - name: Release
        uses: open-turo/actions-gha/release@v1
        with:
          dry-run: true

using output parameters example

jobs:
  build:
    steps:
      - name: Release
        uses: open-turo/actions-gha/release@v1
        id: semantic # Need an `id` for output variables
      - name: Do something when a new release published
        if: steps.semantic.outputs.new-release-published == 'true'
        run: |
          echo ${{ steps.semantic.outputs.new-release-version }}
          echo ${{ steps.semantic.outputs.new-release-major-version }}

Notes

  • By default, this action will perform actions/checkout as its first step.