CI Configuration
Last updated
Last updated
semantic-release
only after all tests succeededThe semantic-release
command must be executed only after all the tests in the CI build pass. If the build runs multiple jobs (for example to test on multiple Operating Systems or Node versions) the CI has to be configured to guarantee that the semantic-release
command is executed only after all jobs are successful. Here is a few example of the CI services that can be used to achieve this:
See CI configuration recipes for more details.
semantic-release requires push access to the project Git repository in order to create Git tags. The Git authentication can be set with one of the following environment variables:
Alternatively the Git authentication can be set up via SSH keys.
Most semantic-release plugins require setting up authentication in order to publish to a package manager registry. The default @semantic-release/npm and @semantic-release/github plugins require the following environment variables:
See each plugin's documentation for the environment variables required.
The authentication token/credentials have to be made available in the CI service via environment variables.
See CI configuration recipes for more details on how to configure environment variables in your CI service.
Note: The environment variables GH_TOKEN
, GITHUB_TOKEN
, GL_TOKEN
and GITLAB_TOKEN
can be used for both the Git authentication and the API authentication required by @semantic-release/github and @semantic-release/gitlab.
Variable
Description
GH_TOKEN
or GITHUB_TOKEN
A GitHub personal access token.
GL_TOKEN
or GITLAB_TOKEN
A GitLab personal access token.
BB_TOKEN
or BITBUCKET_TOKEN
A Bitbucket personal access token.
GIT_CREDENTIALS
URL encoded Git username and password in the format <username>:<password>
. The username and password must each be individually URL encoded, not the :
separating them.
Variable
Description
NPM_TOKEN
npm token created via npm token create.
Note: Only the auth-only
level of npm two-factor authentication is supported.
GH_TOKEN
GitHub authentication token. Note: Only the personal token authentication is supported.