配置从 GitHub 和 BitBucket 进行自动化构建

目录

注意

自动化构建需要 Docker Pro、Team 或 Business 订阅。

为了自动化构建和测试您的镜像，您需要将托管的源代码服务关联到 Docker Hub，以便 Docker Hub 可以访问您的源代码仓库。您可以为用户账户或组织配置此关联。

如果您要关联源代码提供商以创建团队的自动化构建，请在按照以下说明关联账户之前，先按照创建团队的服务账户的说明进行操作。

  1. 登录 Docker Hub。

  2. 选择 My Hub > Settings > Linked accounts（我的 Hub > 设置 > 关联账户）。

  3. 选择要关联的源代码提供商对应的 Link provider（关联提供商）。

    如果您想取消关联当前的 GitHub 账户并重新关联到一个新的 GitHub 账户，请务必在通过 Docker Hub 进行关联之前，完全退出 GitHub。

  4. 查看 Docker Hub Builder OAuth 应用程序的设置。

    Granting access to GitHub account

    注意

    如果您是任何 GitHub 组织的拥有者，您可能会在此屏幕上看到授予 Docker Hub 访问这些组织的选项。您也可以单独编辑组织的第三方访问设置，以授予或撤销 Docker Hub 的访问权限。请参阅授予 Docker Hub 访问 GitHub 组织的权限了解更多信息。

  5. 选择 Authorize docker（授权 Docker）以保存关联。

授予 Docker Hub 访问 GitHub 组织的权限

如果您是 GitHub 组织的拥有者，您可以授予或撤销 Docker Hub 对该组织仓库的访问权限。根据 GitHub 组织的设置，您可能需要是组织拥有者。

如果该组织之前没有被授予或撤销过特定的访问权限，您通常可以在关联用户账户的同时授予访问权限。在这种情况下，关联账户屏幕中组织名称旁边会出现一个 Grant access（授予访问）按钮，如下所示。如果此按钮未出现，您必须手动授予应用程序的访问权限。

手动授予 Docker Hub 访问 GitHub 组织的权限

  1. 使用以上说明关联您的用户账户。

  2. 在您的 GitHub 账户设置中，找到左下角的 Organization settings（组织设置）部分。

  3. 选择您想授予 Docker Hub 访问权限的组织。

  4. 选择 Third-party access（第三方访问）。

    页面显示第三方应用程序列表及其访问状态。

  5. 选择 Docker Hub Builder 旁边的铅笔图标。

  6. 选择组织旁边的 Grant access（授予访问）。

撤销 Docker Hub 对 GitHub 组织的访问权限

撤销 Docker Hub 对组织 GitHub 仓库的访问权限

  1. 在您的 GitHub 账户设置中，找到左下角的 Organization settings（组织设置）部分。

  2. 选择您想撤销 Docker Hub 访问权限的组织。

  3. 在组织配置文件菜单中，选择 Third-party access（第三方访问）。页面显示第三方应用程序列表及其访问状态。

  4. 选择 Docker Hub Builder 旁边的铅笔图标。

  5. 在下一页上，选择 Deny access（拒绝访问）。

要撤销 Docker Hub 对您的 GitHub 账户的访问权限，您必须同时在 Docker Hub 和 GitHub 账户中取消关联。

  1. 选择 My Hub > Settings > Linked accounts（我的 Hub > 设置 > 关联账户）。

  2. 在您要删除的源代码提供商旁边选择 Unlink provider（取消关联提供商）。

  3. 转到您的 GitHub 账户的 Settings（设置）页面。

  4. 在左侧导航栏中选择 Applications（应用程序）。

  5. 选择 Docker Hub Builder 应用程序右侧的 ... 菜单，然后选择 Revoke（撤销）。

注意

每个配置为自动化构建源的仓库都包含一个 webhook，用于通知 Docker Hub 仓库中的更改。当您撤销对源代码提供商的访问权限时，此 webhook 不会自动移除。

  1. 使用您的 Docker ID 登录 Docker Hub。

  2. 选择 My Hub > Settings > Linked accounts（我的 Hub > 设置 > 关联账户）。

  3. 选择要关联的源代码提供商对应的 Link provider（关联提供商）。

  4. 如有必要，登录 Bitbucket。

  5. 在出现的页面上，选择 Grant access（授予访问）。

要永久撤销 Docker Hub 对您的 Bitbucket 账户的访问权限，您必须同时在 Docker Hub 和 Bitbucket 账户中取消关联并撤销授权。

  1. 登录 Docker Hub。

  2. 选择 My Hub > Settings > Linked accounts（我的 Hub > 设置 > 关联账户）。

  3. 在您要删除的源代码提供商旁边选择 Unlink provider（取消关联提供商）。

重要

在 Docker Hub 上取消关联账户后，您还必须在 Bitbucket 端撤销授权。

在 Bitbucket 账户中撤销授权

  1. 转到您的 Bitbucket 账户并导航到 Bitbucket settings（Bitbucket 设置）。

  2. 在出现的页面上，选择 OAuth。

  3. 选择 Docker Hub 行旁边的 Revoke（撤销）。

Bitbucket Authorization revocation page

注意

每个配置为自动化构建源的仓库都包含一个 webhook，用于通知 Docker Hub 仓库中的更改。当您撤销对源代码提供商的访问权限时，此 webhook 不会自动移除。

页面选项