changesets-gitlab

changesets-gitlab

GitLab CI cli for changesets like its GitHub Action, it creates a pull request with all of the package versions updated and changelogs updated and when there are new changesets on master, the PR will be updated. When you're ready, you can merge the pull request and you can either publish the packages to npm manually or setup the action to do it for you.

Usage

Inputs

Environment valuables starts with INPUT_, case insensitive

• publish - The command to use to build and publish packages
• version - The command to update version, edit CHANGELOG, read and delete changesets. Default to changeset version if not provided
• commit - The commit message to use. Default to Version Packages
• title - The pull request title. Default to Version Packages

Outputs

• published - A boolean value to indicate whether a publishing is happened or not
• publishedPackages - A JSON array to present the published packages. The format is [{"name": "@xx/xx", "version": "1.2.0"}, {"name": "@xx/xy", "version": "0.8.9"}]

Example workflow

Without Publishing

Create a file at .gitlab-ci.yml with the following content.

stages:
  - release

before_script: yarn --frozen-lockfile

release:
  image: node:lts-alpine
  only: main
  script: yarn changesets-gitlab

With Publishing

Before you can setup this action with publishing, you'll need to have an npm token that can publish the packages in the repo you're setting up the action for and doesn't have 2FA on publish enabled (2FA on auth can be enabled). You'll also need to add it as a secret on your GitHub repo with the name NPM_TOKEN. Once you've done that, you can create a file at .github/workflows/release.yml with the following content.

stages:
  - release

before_script: yarn --frozen-lockfile

release:
  image: node:lts-alpine
  only: main
  script: yarn changesets-gitlab
  variables:
    INPUT_PUBLISH: yarn release

By default the GitHub Action creates a .npmrc file with the following content:

//registry.npmjs.org/:_authToken=${process.env.NPM_TOKEN}

However, if a .npmrc file is found, the GitHub Action does not recreate the file. This is useful if you need to configure the .npmrc file on your own. For example, you can add a step before running the Changesets GitHub Action:

script: |
  cat << EOF > "$HOME/.npmrc"
    email=[e-mail]
    //registry.npmjs.org/:_authToken=$NPM_TOKEN
  EOF

With version script

If you need to add additional logic to the version command, you can do so by using a version script.

If the version script is present, this action will run that script instead of changeset version, so please make sure that your script calls changeset version at some point. All the changes made by the script will be included in the PR.

stages:
  - release

before_script: yarn --frozen-lockfile

release:
  image: node:lts-alpine
  only: main
  script: yarn changesets-gitlab
  variables:
    INPUT_VERSION: yarn version

With Yarn 2 / Plug'n'Play

If you are using Yarn Plug'n'Play, you should use a custom version command so that the action can resolve the changeset CLI:

stages:
  - release

before_script: yarn --frozen-lockfile

release:
  image: node:lts-alpine
  only: main
  script: yarn changesets-gitlab
  variables:
    INPUT_VERSION: yarn changeset version

Changelog

0.1.1

Patch Changes

• 7f81cff Thanks @JounQin! - fix: incorrect bin file location