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

连接后带来的便利

连接 GitLab 后，网站可直接从您的某个 GitLab 仓库进行部署，并在您选择其作为网站托管平台时，允许我们将内容发布到您账户下的 GitLab Pages。

开始之前

拥有一个能够访问您想要部署的项目的 GitLab 账户。

1. 在 GitLab 中创建密钥

在 GitLab 中，点击右上角的头像，然后依次选择 Edit profile → Access → Personal access tokens，并生成一个新的令牌（在 Generate token 菜单中，GitLab 可能会将其标记为 Legacy token）。为其命名，设置过期日期，并勾选以下权限范围：

• api
• write_repository

点击 Generate token 并将其复制——GitLab 只会显示一次。

2. 在此处进行连接

在您的控制面板中打开 Integrations，然后选择 Connect an account。选择 Code hosting 作为分组，选择 GitLab 作为账户，填写 API token，最后点击 Connect account。

在保存任何内容之前，我们会对您粘贴的内容进行测试。无法使用的密钥绝不会被存储，并且系统会给出错误提示。能够正常使用的密钥将加密保存在我们的密钥保险库中（绝不保存在我们的数据库中），并且绝不会再次显示，连您本人也无法查看。

接下来会发生什么

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

如果无法连接

曾经有效但随后失效。 GitLab 令牌总是会过期——通常在您创建后最多一年内——并且 GitLab 会在此之前向您发送电子邮件。请创建一个新的令牌并进行连接。

缺少权限范围。 令牌创建后，其权限范围无法更改；请创建一个勾选了两个所需权限范围的新令牌。

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

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

断开连接

打开 Integrations，找到该账户并点击 Disconnect。这会立即删除存储的密钥。任何使用该密钥的内容都会在其下一次操作时停止，且依赖于它的页面会明确显示错误提示，而不是默默失败。

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