跳到主要内容

使用 Postman CLI 运行集合（collection）

你可以使用 Postman CLI 手动运行和测试集合。你还可以使用 Postman CLI 在 CI/CD 管道上自动运行收集。

当 Postman CLI 运行集合时，集合及其测试在本地执行，结果作为 API 调用发送到 Postman 服务器。

使用 Postman CLI 在本地运行集合​

  1. 下载并安装 Postman CLI 。

  2. 在边栏中选择Collections，然后选择你要运行的 Collection。

  3. 在概述选项卡上，选择 亚军图标 运行。

  4. 在 Collection Runner 上，选择Automate runs via CLI。

    使用 Postman CLI 自动运行

  5. 在Postman CLI 命令窗口中，选择添加 API 密钥。

  6. 选择生成密钥（或使用现有密钥输入现有 API 密钥并跳至第 9 步）。

  7. 输入 API 密钥的名称。

  8. 选择生成。

  9. 复制并保存 API 密钥。

  10. 选择插入密钥。

  11. 选择 复制图标 复制。

  12. 在终端中粘贴并运行命令。

  13. 运行这些命令后，Postman CLI 会生成一个链接。点击链接查看 Postman 上的结果。

    Postman CLI 生成的链接

  14. collection run 结果显示在浏览器中。

    Postman CLI 查看采集运行结果

在 CI/CD 中运行集合​

当集合运行令你满意时，你可以将命令复制到 CI/CD 脚本中，以将它们集成到你的工作流中。将命令添加到 CI/CD 脚本时，你可能希望用变量替换 API 密钥。

  1. 在边栏中选择Collections，然后选择你要运行的 Collection。

  2. 在概述选项卡上，选择 亚军图标 运行。

  3. 在 Collection Runner 上，选择Automate runs via CLI。

    使用 Postman CLI 自动运行

  4. 在 Run on CI/CD下，选择Configure command。

  5. 选择要在管道构建期间运行的集合。你还可以选择要使用的环境。

    如果需要，选择+ 添加更多以选择要运行的其他集合。

  6. 为你的 CI/CD 管道选择 CI/CD提供程序。

  7. 为你的 CI/CD 管道选择操作系统。

  8. 选择复制图标 复制图标 以复制 Postman CLI 配置。

生成 Postman CLI

按特定顺序运行集合​

默认情况下，当你生成从 Collection Runner 运行集合的命令时，会为该集合指定一个 Collection ID。这将按照集合中列出的顺序运行该集合中的文件夹和请求。

如果你需要更改执行顺序，请在 Collection Runner 中选择一个请求并将其拖动以将其移动到新顺序。你还可以通过清除其名称旁边的复选框从运行中删除单个请求。

当你更改文件夹和请求顺序并选择通过 CLI 自动运行时， Postman CLI 命令窗口中的命令也会更改。除了 Collection ID 之外，生成的命令还将使用该选项指定多个文件夹和请求 UID -i。这将按指定顺序运行每个文件夹或请求。