npm にパッケージの公開、あるいはその更新をするとき、その手順であったり、そもそも手順どころか npm publish すること自体忘れるということがあります。ここではこの自動化に semantic-release を使った方法を紹介します。

環境設定

npm install -g semantic-release-cli
semantic-release-cli setup

設定は semantic-release-cli によって、対話的に作成することができます。環境の設定以外にも、すでに package.json のあるプロジェクトに必要な script の記述の追加や、.travis.yml の生成しもてくれます。

また、単にリリースする以外にも ChangeLog の出力や Tag をつけてくれたりといったことも自動化してくれます。

使い方

バージョンを自動であげるには、コミットログの形式が AngularJS Commit Message Conventions であり、デフォルトの設定では以下の <Type> である必要があります。

Scoped Packages

公開するパッケージが Scoped Packages である場合、access が public である必要があるため、package.json に以下を追加してください。

{
  ...
  "publishConfig": {
    "access": "public"
  }
}

正しく動作しないケース

package.json に files を指定していて、かつそのディレクトリが .gitignore されているとき、正しく動作しなかったので semantic-release を使うのをやめた。よくわからないが、一度 semantic-release でリリースしたものについては、いくら手動で npm publish しても files に指定したものが publish されなかった。

手動で更新する方法

手動で npm publish する場合、以下のコマンドを叩くとバージョンが更新される。

• npm-version

リリースの手順としては

1. npm version TYPE
2. git push origin TAG_NAME
3. npm publish

となる。