Bitbucket Cloud
将 Bitbucket Cloud 仓库连接到 Mintlify，实现自动化部署、拉取请求预览和持续同步。
Bitbucket Cloud 需要 Enterprise 套餐。
Mintlify 通过 OAuth 连接到 Bitbucket Cloud。当你连接仓库后，Mintlify 会自动部署推送到部署分支的更改，并为拉取请求创建预览部署。
Mintlify 支持托管在 bitbucket.org 上的 Bitbucket Cloud 仓库。Bitbucket Data Center、Slack agent 和 automations 不支持 Bitbucket 仓库。
- 一个 Bitbucket Cloud 账户
- 在你要连接的仓库中创建 webhook 的权限
- 你的 Mintlify 组织的管理员访问权限
- 你的仓库中有一个
docs.json文件
当你首次打开 Git Settings 时，设置向导会引导你完成 Bitbucket 仓库的连接。
选择 Bitbucket 作为提供商
- 在 Git Settings 页面，选择 Connect to Bitbucket。
- 点击 Continue。
迁移 Mintlify 托管的内容
如果你目前将内容托管在 Mintlify 管理的仓库中，请将其下载为 zip 文件。解压 zip 内容并将文件推送到你的 Bitbucket 仓库。
如果你的内容已经在 Bitbucket 中，请点击 Continue setup。
授权 Bitbucket
- 点击 Connect Bitbucket。
- Bitbucket 会打开一个新页面，用于授权 Mintlify 访问你的 Bitbucket 账户。请授权 Mintlify 访问你要连接的仓库。
授权完成后，Bitbucket 会将你重定向回你的 Mintlify Git 设置。
配置仓库
输入以下值：
- Workspace：拥有该仓库的 Bitbucket 工作区的 slug。例如，在
https://bitbucket.org/acme/docs中，acme是工作区 slug。 - Repository：仓库的 slug。例如，在
https://bitbucket.org/acme/docs中，docs是仓库 slug。 - Deploy branch：发布到你的正式文档站点的分支，例如
main。
配置内容目录（可选）
- 如果你的
docs.json文件位于子目录中，请在 Git 设置页面启用 Docs are in a subdirectory。 - 输入包含你的
docs.json文件的目录路径。例如，如果你的docs.json位于apps/docs/目录，请输入apps/docs。
连接仓库
- 点击 Connect。
- 确认更改。Mintlify 会验证已授权的 Bitbucket 账户可以访问你的仓库，并注册用于触发部署和拉取请求预览的 webhook。
- 前往你的 Mintlify 控制台的 Git Settings 页面。
- 展开 Bitbucket OAuth 部分。
- 启用或禁用单个仓库。禁用某个仓库会移除其 Mintlify webhook。
撤销连接会移除通过该账户连接的每个仓库的 Mintlify webhook。
你可以将来自多个 Bitbucket 仓库的内容合并到一个站点中。部署中的每个源都必须使用 Bitbucket，并且你必须在 Bitbucket OAuth 下启用每个仓库，然后才能将其添加为源。
有关设置说明以及关于 URL 路径、基础源和导航的信息，请参阅 多仓库部署。
Was this page helpful?Suggest editsRaise issue