GitLab

GitLab 自我管理集成仅适用于 Postman Enterprise 计划。

通过 Postman 到 GitLab 的集成,将您的 Postman 集合备份到 GitLab,这是一个开源 Git 存储库管理器。

设置 GitLab 集成需要您获取 GitLab 个人访问令牌并配置您希望如何备份您的收藏。

API 与 GitLab 同步

Postman 9.0 引入了将 git 存储库连接到 API 的功能。您可以直接将 GitLab 存储库连接到 API Builder 中的 API,而不是使用集成。这提供了模式和关联集合的双向同步,并添加了强大的新功能,用于在 Postman 和您的存储库之间同步分支和发布标签。有关新的 repo 同步功能的更多信息,请参阅版本控制 API

生成 GitLab 个人访问令牌

  1. 登录到GitLab

  2. 如果您还没有来自 GitLab 的个人访问令牌,请生成一个新的.

    gitlab 创建令牌

  3. 保存生成的令牌以供以后使用。

    gitlab 保存令牌

在 GitLab 中为 Postman 集合配置备份

  1. 主页选择集成

  2. 搜索并选择GitLab

  3. 您可以选择查看查看全部以查看您的团队创建的所有集成。

    gitlab 添加集成

上面的屏幕为您提供了以下两个选项:

将您的 Postman 收藏备份到 GitLab

  1. 选择添加集成以输入您的 GitLab 令牌以开始集成。

    输入 gitlab 令牌

  2. 输入您的 GitLab 个人访问令牌并选择Authenticate and Proceed

  3. 选择一个现有的 Postman 集合和您的 GitLab 项目,然后为您的备份输入一个文件名。

  4. 高级选项中,您可以输入自定义目录名称或保留Postman Collections默认名称。您可以为提交指定一个分支,或者将使用存储库的默认分支。

    gitlab 集成配置

  5. 选择添加集成以保存您的集成配置。

您的集合以您指定的文件名推送到 GitLab 项目,并保存为单个 JSON 文件。

保存到 Postman 集合的每个更改都会自动将更改实时提交到 GitLab 项目。您的集合和代码可以存在于同一个存储库中。

将 Postman 集合备份到自定义域上的 GitLab

  1. 如果您的网络位于需要将 IP 地址列入许可名单的防火墙后面,您将需要使用静态 IP 地址来启用对自定义域上 GitLab 的集合备份。

    联系您的 IT 团队,在防火墙中将以下静态 IP 列入许可名单,以启用 GitLab 的集合备份:

    • 美国东部:3.212.102.200

    将此 IP 地址列入白名单后,对此集成的调用将能够连接到您的网络并允许集成按预期工作。

  2. 选择添加集成以输入您的 GitLab 令牌以开始集成。

  3. 输入您的 GitLab 个人访问令牌,指定您的 GitLab 自定义/自托管域,然后选择Proceed

  4. 在“备份您的 Postman 收藏”页面中,选择现有的 Postman 收藏和您的 GitLab 项目,然后输入备份的文件名。

  5. 高级选项中,您可以输入自定义目录名称或保留Postman Collections默认名称。您可以为提交指定一个分支,或者将使用存储库的默认分支。确保您对尝试推送更改的分支具有写入权限。

    请注意,您要将收藏备份到的分支必须已经存在。

  6. 选择添加集成

您的集合被推送到您指定的目录下的 GitLab 项目并保存为单个 JSON 文件。

保存到 Postman Collection 的每一项更改都会自动实时提交对 GitLab 项目的更改。您的集合和代码可以存在于同一个存储库中。

您可以转到 GitLab 域并查看备份的集合,如下面的屏幕所示:

gitlab 高级选项2