使用 travis 发布 npm 包

TL:DR

相关链接

• travis-cli 文档
• Travis NPM Releasing 文档

1. 获取需要的 Token

   • Github Access Token
   • NPM auth token 获取方式 在 travis 中也称做 api_key

2. 登录 Travis cli

   travis login --com --github-token <GITHUB_ACCESS_TOKEN>

3. 配置基础 .travis.yml，使用 travis setup npm 的前置依赖

   language: node_js
   node_js:
     - 14

4. 使用 travis setup npm 命令补充配置

如何保护自己的私密信息

执行 npm publish 时需要 npm 的 auth token ，而这个信息显然是不适合中显式的放在 .travis.yml 中

这时可以通过 travis encrypt 命令来加密信息

travis encrypt <TOKEN> --add <CONFIG.PATH>

# YOUR_AUTH_TOKEN 需要加密的TOKEN
# CONFIG.PATH 在 yml 文件（可理解为对象）中的位置，如 `deploy.api_key` 代表是 `deploy` 下的 `api_key` 属性

这同样也适合其它需要加密的信息，如你的数据库链接信息

指定发布的时机

1. 指定分支发布

   特定分支

   deploy:
   on:
   branch: production

   所有分支

   deploy:
   on:
   all_branch: true

2. 存在新的 tag 时发布

   deploy:
   on:
   tags: true

   记得使用 git push --tags 推送 tag 到 github 上

疑难问题解答

1. travis login 碰到 has not granted Travis CI the required permissions, please log in via travis-ci.org 怎么处理？

   如果你使用的是 travis-ci.org 的话，会碰到这个问题，解决方案是迁移到 travis-org.com。同时使用 travis login --com 命令登录

   补充一个相关问题的链接 travis-ci.org vs travis-ci.com?