关联您的 Bitbucket 账户，以便从代码仓库部署您的网站

连接它的作用

连接 Bitbucket 允许站点从您的 Bitbucket Cloud 存储库之一进行部署：推送到分支，站点便会更新。

开始之前

一个对您要部署的存储库拥有访问权限的 Bitbucket Cloud 帐户。

1. 在 Bitbucket 创建密钥

Bitbucket 提供两种凭据，任一种均可使用：

• 用于存储库、项目或工作区的访问令牌，通过该存储库、项目或工作区自身的设置在 Access tokens 下创建。它绑定到该存储库、项目或工作区，而不是个人。请为其授予对存储库的读取权限。
• 您 Atlassian 帐户上的 API 令牌。选择您的个人资料，然后依次选择 Account settings → Security → Create and manage API tokens → Create API token with scopes。为其命名，设置过期时间，选择 Bitbucket 作为应用程序，并选择对存储库的读取权限。Bitbucket 仅显示该令牌一次；请在此时复制它。

2. 在此处连接

在仪表板中打开 Integrations，然后选择 Connect an account。选择 Code hosting 作为分组，选择 Bitbucket 作为帐户，填写 API token — 如果您是在 Atlassian 帐户上创建了令牌而非访问令牌，还需填写 Account username，然后点击 Connect account。

我们在保存任何内容之前都会测试您粘贴的内容。无法使用的密钥绝不会被存储，并且返回的提示会说明其问题所在。可用的密钥会加密保存在我们的机密库中 — 绝不会存储在我们的数据库中 — 并且永远不会再次显示，即使对您也是如此。

用户名决定了我们发送令牌的方式，因此仅针对帐户令牌输入它。输入了用户名的访问令牌，或没有输入用户名的帐户令牌，都将被拒绝。

后续操作

• 站点可以直接从此帐户上的存储库进行部署：在站点的存储库连接上选择该帐户，选取存储库和分支，推送即可触发部署。
• 其他每个分支都可以获得自己的预览，以便您在更改进入正式站点之前对其进行检查。
• 使用 Git 构建的静态托管平台（例如 Render 和 Azure Static Web Apps）使用此连接作为站点代码的来源。

如果无法连接

缺少存储库。访问令牌仅能访问创建它的存储库、项目或工作区。请在能够涵盖您所需所有存储库的级别上创建一个令牌。

起初正常，随后停止工作。两种令牌都可能会过期。请创建一个新令牌并进行连接。

提示密钥被拒绝。几乎总是以下三种情况之一：复制时带入了空格或换行符、密钥已过期，或者在您复制后密钥被吊销或重新生成。请创建一个新密钥并重新粘贴。

连接成功，但随后发生错误。密钥通过了身份验证，但缺少该操作所需的权限。请创建一个具有上述权限的新密钥，然后断开旧连接并连接新密钥。

断开连接

打开 Integrations，找到该帐户并点击 Disconnect。这将立即删除存储的密钥。使用它的任何功能都会在下一次操作时停止，并且依赖它的界面会显示相应提示，而不是悄无声息地失败。

断开连接不会撤销已经完成的操作 — 我们在您帐户上更改的记录、部署或设置将保持原样。如果您认为密钥本身可能已泄露，还请在供应商处将其吊销；断开连接仅会删除我们的副本，而不会删除他们的副本。