Plugins
Last updated
Last updated
Each release step is implemented by configurable plugins. This allows for support of different commit message formats, release note generators and publishing platforms.
A plugin is a npm module that can implement one or more of the following steps:
Note: If no plugin with a analyzeCommits
step is defined @semantic-release/commit-analyzer
will be used.
These four plugins are already part of semantic-release and don't have to be installed separately:
Additional plugins have to be installed via npm:
Each plugin must be configured with the plugins
options by specifying the list of plugins by npm module name.
Note: If the plugins
option is defined, it overrides the default plugin list, rather than merging with it.
For each release step the plugins that implement that step will be executed in the order in which they are defined.
With this configuration semantic-release will:
execute the verifyConditions
implementation of @semantic-release/npm
then @semantic-release/git
execute the analyzeCommits
implementation of @semantic-release/commit-analyzer
execute the generateNotes
implementation of @semantic-release/release-notes-generator
execute the prepare
implementation of @semantic-release/npm
then @semantic-release/git
execute the publish
implementation of @semantic-release/npm
A plugin configuration can be specified by wrapping the name and an options object in an array. Options configured this way will be passed only to that specific plugin.
Global plugin configuration can be defined at the root of the semantic-release configuration object. Options configured this way will be passed to all plugins.
With this configuration:
All plugins will receive the preset
option, which will be used by both @semantic-release/commit-analyzer
and @semantic-release/release-notes-generator
(and ignored by @semantic-release/github
and @semantic-release/git
)
The @semantic-release/github
plugin will receive the assets
options (@semantic-release/git
will not receive it and therefore will use it's default value for that option)
Step
Required
Description
verifyConditions
No
Responsible for verifying conditions necessary to proceed with the release: configuration is correct, authentication token are valid, etc...
analyzeCommits
Yes
Responsible for determining the type of the next release (major
, minor
or patch
). If multiple plugins with a analyzeCommits
step are defined, the release type will be the highest one among plugins output.
verifyRelease
No
Responsible for verifying the parameters (version, type, dist-tag etc...) of the release that is about to be published.
generateNotes
No
Responsible for generating the content of the release note. If multiple plugins with a generateNotes
step are defined, the release notes will be the result of the concatenation of each plugin output.
prepare
No
Responsible for preparing the release, for example creating or updating files such as package.json
, CHANGELOG.md
, documentation or compiled assets and pushing a commit.
publish
No
Responsible for publishing the release.
success
No
Responsible for notifying of a new release.
fail
No
Responsible for notifying of a failed release.