我们很高兴宣布 SwaggerHub 的最新集成,此次是与 Atlassian 的源代码控制管理平台 Bitbucket 的集成。此集成帮助开发者保持他们在 SwaggerHub 和 Bitbucket 上的资产同步并更新,因此在您的源代码控制主机上工作的团队将拥有来自 SwaggerHub 的所有 API 代码。
为什么选择 Bitbucket?
每个开发者都知道源代码控制的重要性,以及它如何使软件开发变得可管理和迭代。但是,您将由源代码控制工具管理的代码存储在哪里呢? 无论是 Git、Mercurial 还是 Subversion,一个用于与您的协作者在公共平台上存储和处理代码的源代码控制主机都是一个很好的补充。 Bitbucket 与 GitHub 和 GitLab 一道,已成为源代码托管环境中的主导者。Bitbucket 凭借强大、安全的功能,已成为团队托管代码的重要资源,对组织和大型公司来说非常有价值。
这对我意味着什么?
虽然源代码控制工具非常适合托管代码,但它们并非旨在编辑、设计和构建 API。 源代码控制主机不适用于像 Swagger (OpenAPI) 规范这样的描述格式所帮助构建的 RESTful 接口。通过 SwaggerHub 与 Bitbucket 的集成,用户现在可以无缝集成其 API 文档和代码,并使其与 Bitbucket 上的仓库保持同步。
让我们举一个简单的例子。
您的组织的 API 团队有多个小组负责 API 生命周期中的各个方面。您将有架构师负责规划 API 结构,服务器端开发人员致力于为您的 API 构建坚实的后端,而面向客户端的开发人员则专注于为 API 的最终用户提供出色的体验。团队的测试人员将与您的 DevOps 团队协作,专注于质量保证并安全地部署 API。 所有这些团队都有两个共同点 — 您的 API 和团队代码库的托管平台。通过 SwaggerHub 与 Bitbucket 的集成,您现在可以同时更新上述内容。这意味着您的团队工作流程将比以往任何时候都更顺畅,并能融入您的持续集成过程。 (SwaggerHub 也很荣幸提供与其他源代码控制工具(如 GitHub)的集成。您可以在 此处 了解 SwaggerHub 中提供的所有集成。)
那么我该如何开始呢?
首先,您需要在 SwaggerHub 上有一个 API 定义,并在 BitBucket 上有一个现有仓库。 您可以 免费注册 SwaggerHub,开始编写您的 Swagger 定义,或导入现有定义。 设置完成后,在 API 编辑器右上角找到管理集成,然后选择 Bitbucket 集成。
然后,您将看到一些选项,精确了解您的 API 定义以及相应的代码将如何与您的仓库同步,包括代码类型(服务器模板或客户端 SDK)、仓库,以及您是否希望 SwaggerHub 完全或部分管理您的仓库。 就这样!您的 API 定义和来自 SwaggerHub 的代码现在将与您的 Bitbucket 仓库同步,供您的整个团队协作!请查看我们的 Bitbucket 帮助部分,了解更多关于使用此集成的信息。 当然,SwaggerHub 拥有一整套集成功能,可增强您的 API 功能,因此请随时浏览我们的文档,了解更多详情。 那么,前往 SwaggerHub,体验一下这个集成吧。欢迎通过功能请求向我们发送您希望在 SwaggerHub 上看到的任何新集成的建议。 还不是 SwaggerHub 用户?免费注册,开始使用 SwaggerHub 构建更出色的 API。