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

连接操作为您带来的优势

连接 Bitbucket 后，网站即可直接从您的某个 Bitbucket Cloud 代码库进行部署：向分支推送代码，网站便会自动更新。

开始之前

您需要一个能够访问您想要部署的代码库的 Bitbucket Cloud 账户。

1. 在 Bitbucket 中创建密钥

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

• 代码库、项目或工作区访问令牌：在相应代码库、项目或工作区自身的设置中的访问令牌（Access tokens）下创建。它绑定于特定的代码库、项目或工作区，而不是个人。请为其授予对代码库的读取权限。
• Atlassian 账户上的 API 令牌：选择您的个人资料，然后依次点击账户设置（Account settings）→ 安全（Security）→ 创建和管理 API 令牌（Create and manage API tokens）→ 使用权限范围创建 API token（Create API token with scopes）。为其命名，设置过期时间，选择 Bitbucket 作为应用，并选择对代码库的读取权限。Bitbucket 仅显示该令牌一次；请务必在那时将其复制。

2. 在此处进行连接

打开仪表板中的集成（Integrations），然后选择连接账户（Connect an account）。选择代码托管（Code hosting）作为组，选择 Bitbucket 作为账户，填写API 令牌（API token）——如果您创建的是 Atlassian 账户上的令牌而非访问令牌，则还需填写账户用户名（Account username），然后点击连接账户（Connect account）。

我们会在保存任何内容之前对您粘贴的密钥进行测试。无法使用的密钥绝不会被存储，系统会提示具体错误原因。能够正常使用的密钥会以加密形式保存在我们的秘密保险库中——绝不存储在数据库中——并且绝不会再次显示，即使对您也是如此。

用户名决定了我们发送令牌的方式，因此只有在使用账户令牌时才需输入用户名。 如果在使用用户名时输入了访问令牌，或者在使用账户令牌时未输入用户名，则会被拒绝。

接下来会发生什么

• 网站可以直接从此账户下的代码库进行部署：在网站的代码库连接中选择它，挑选代码库和分支，随后一次推送即可完成部署。
• 其他所有分支都可以拥有其专属的预览，以便您在更改推送到正式网站之前进行检查。
• 诸如 Render 和 Azure Static Web Apps 之类的 Git 构建静态托管服务将使用此连接作为网站代码的来源。

如果无法连接

找不到代码库。 访问令牌只能访问在其其中创建的代码库、项目或工作区。请在涵盖您所需的所有代码库的级别上创建一个新的访问令牌。

曾经可用但随后停止工作。 这两种令牌都可能会过期。请创建一个新令牌并进行连接。

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

连接成功，但随后的操作失败。 密钥通过了身份验证，但缺少操作所需的权限。请使用上述权限列表创建一个新密钥，然后断开旧连接并连接新密钥。

断开连接

打开集成（Integrations），找到相应账户并点击断开连接（Disconnect）。这将立即删除存储的密钥。任何正在使用该密钥的内容将在下一次执行操作时停止，且依赖于它的屏幕将会显示相应提示，而不会默默失败。

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