Использование Changesets с pnpm

заметка

На момент написания этой документации последней версией pnpm была v6.14. Последняя версия Changesets была v2.16.0.

Установка

Чтобы установить changesets в workspace pnpm, установите changesets как dev зависимость в корне workspace:

pnpm add -Dw @changesets/cli

Затем инициализируем changesets командой:

pnpm changeset init

Добавление нового changesets

Чтобы сгенерировать новый набор изменений, запустите pnpm changeset в корне рабочей области. Сгенерированные файлы Markdown в папке .changeset должны быть зафиксированы в репозитории.

Релиз изменений

1. Запуск pnpm changeset version. Это приведёт к загрузке версий пакетов ранее указанных с помощью pnpm changeset (и любых зависимых от них) и обновлению файлов в списке изменений.
2. Запуск pnpm install. Это обновит lockfile и заново соберет пакеты.
3. Зафиксированы изменения.
4. Запуск pnpm publish -r. Это команда опубликует все, которые имеют измененные версии, еще нет в реестре.

Использование GitHub Actions

To automate the process, you can use changeset version with GitHub actions.

Bump up package versions

The action will detect when changeset files arrive in the main branch, and then open a new PR listing all the packages with bumped versions. Once merged, the packages will be updated and you can decide whether to publish or not by adding the publish property.

Publishing

Add a new script ci:publish which executes pnpm publish -r. It will publish to the registry once the PR is opened by changeset version.

package.json

{
   "scripts": {
      "ci:publish": "pnpm publish -r"
   },
   ...
}

name: Changesets
on:
  push:
    branches:
      - main
env:
  CI: true
  PNPM_CACHE_FOLDER: .pnpm-store
jobs:
  version:
    timeout-minutes: 15
    runs-on: ubuntu-latest
    steps:
      - name: checkout code repository
        uses: actions/checkout@v3
        with:
          fetch-depth: 0
      - name: setup node.js
        uses: actions/setup-node@v3
        with:
          node-version: 14
      - name: install pnpm
        run: npm i pnpm@latest -g
      - name: Setup npmrc
        run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
      - name: setup pnpm config
        run: pnpm config set store-dir $PNPM_CACHE_FOLDER
      - name: install dependencies
        run: pnpm install
      - name: create and publish versions
        uses: changesets/action@v1
        with:
          version: pnpm ci:version
          commit: "chore: update versions"
          title: "chore: update versions"
          publish: pnpm ci:publish
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

More info and documentation regarding this action can be found here.