原文地址：Automated npm releases with Travis CI

原文作者：TailorDev

译文出自：掘金翻译计划

本文永久链接：github.com/xitu/gold-m…

译者：Starrier

校对者：talisk、liang-kai

使用 Travis CI 自动发布 npm

在 npm 注册表发布一个包应该是很无聊的，在这篇博客中，我描述了如何在每次打 git 标签时使用 Travis CI 来发布 npm 包。

在 TailorDev，我们喜欢自动化构建软件所需的许多重要步骤。其中一个步骤是发布最终的，即可生产的应用程序包，也称为工件或者包。今天，我们关注于 JavaScript 世界，描述如何不花费太大心血而在 npm 注册表中实现包的自动化发布过程。

首先，npm 在 2017 年推出了双因素认证 (简称 2FA)，这是一个很好的想法，直到我们发现了它是“全部或者没有”！:confused:。事实上, npm 2FA 依赖于一次性密码来保护账户以及与您账户相关的所有内容，并自动实现这一功能，从而无法实现 2FA 的功能。

**但是为什么这会如此重要呢？**我很高兴您会这么问，因为我们在续集中需要一个 API 令牌，而且目前不可能在不触发 2FA 机制的情况下生成和使用令牌。换句话说，启用 2FA，几乎不可能自动化 npm 发布过程，“几乎”是因为 npm 实现了双级别身份认证: auth-only 和 auth-and-writes。通过将 2FA 的使用限制在 auth-only 上，我们就可以使用 API 令牌，但安全性较低。我们真的希望 npm 可以在不久的将来为自动化任务设计的 auth 令牌，同时：

$ npm profile enable-2fa auth-only

一旦您的账户启用了 auth-only 用法的 2FA (顺便说一句，这比没有启用 2FA 更好)，那就让我们开始创建一个令牌：

$ npm token create

+----------------+--------------------------------------+
| token          | a73c9572-f1b9-8983-983d-ba3ac3cc913d |
+----------------+--------------------------------------+
| cidr_whitelist |                                      |
+----------------+--------------------------------------+
| readonly       | false                                |
+----------------+--------------------------------------+
| created        | 2017-10-02T07:52:24.838Z             |
+----------------+--------------------------------------+

这个令牌将由 Travis CI 用于代表您进行身份验证。我们也可以使用 Travis CLI 将该令牌作为环境变量进行加密或者在 Travis CI 存储库设置中定义一个变量,，这样做将会更方便。声明两个私密环境变量 NPM_EMAIL 和 NPM_TOKEN：

现在，最重要的部分是创建一个实际发布 npm 包的任务。我们决定利用构建阶段（测试版）特性结合 Travis CI 推荐的方式发布 npm 包。为了做记录，我们希望每次构建版本只发布一次。不管现有的构建矩阵如何，我们还希望在发布 npm 包时使用 git 标签，以便在 npm 版本和 GitHub 版本之间保持一致。

我们从一个用于 JavaScript 项目的标准 .travis.yml 文件开始，在该文中对代码进行了 Node 8 和 9 的测试，并使用 yarn 作为包管理器：

language: node_js
node_js:
  - "8"
  - "9"

cache: yarn

install: yarn
script:
  - yarn lint
  - yarn test

我们现在可以通过将以下配置添加到之前的 .travis.yml 文件中来配置“部署”任务：

jobs:
  include:
    - stage: npm release
      if: tag IS present
      node_js: "8"
      script: yarn compile
      before_deploy:
        - cd dist
      deploy:
        provider: npm
        email: "$NPM_EMAIL"
        api_key: "$NPM_TOKEN"
        skip_cleanup: true
        on:
          tags: true

让我们一行一行地分析。首先，当且仅当 IS 标签存在 时，我们“加入”一个新的 npm 发布阶段，这意味着构建已经被 git 标记触发。我们选择 node 8 (我们的生产版本) 并执行 yarn compile 来构建我们的包。此脚本会创建包含可以在 npm 注册表上发布包文件的 dist/ 文件夹。最后但同样重要的一点是，我们调用 Travis CI deploy 命令在 npm 注册表来实际发布包（同时我们将此命令限制为 git 标记，仅作为额外的保护层）。

注意：为了防止 Travis CI 清理额外的文件夹并删除你做的改变，请在发布前将 skip_cleanup 设置为 true。