全部产品
Search
文档中心

容器镜像服务 ACR:绑定源代码托管平台

更新时间:Sep 17, 2026

构建镜像前,您需要绑定一个源代码托管平台,否则将无法构建镜像。本文介绍如何绑定个人版实例与源代码托管平台,便于您后续进行构建镜像等操作。

前提条件

  • 已拥有源代码托管平台账号。

  • 已创建容器镜像个人版实例。具体操作,请参见创建个人版实例。

背景信息

阿里云容器镜像服务个人版实例支持以下几种源代码托管平台:

代码平台

代码平台版本

绑定方式

触发构建限制

GitHub

仅支持GitHub个人版

GitHub OAuth授权

无

Bitbucket

全部

Bitbucket OAuth授权

无

GitLab

全部

私人访问令牌

无

绑定个人版实例与GitHub代码平台

  1. 登录容器镜像服务控制台。

  2. 在顶部菜单栏,选择所需地域。

  3. 在左侧导航栏,选择实例列表。

  4. 在实例列表页面单击目标个人版实例。

  5. 在个人版实例管理页面左侧导航栏选择仓库管理 > 代码源。

  6. 在代码源页面单击GitHub操作列的绑定账号。

  7. 在GitHub对话框中单击点击前往源代码仓库登录。

  8. 在GitHub登录页面输入账号和密码,单击Sign in。

  9. 在Authorize Aliyun Container Registry页面确认授权信息无误后,单击Authorize AliyunDeveloper。

    返回容器镜像服务控制台,可以看到页面显示您已成功绑定GitHub账号,表示绑定成功。

绑定个人版实例与Bitbucket代码平台

  1. 登录容器镜像服务控制台。

  2. 在顶部菜单栏,选择所需地域。

  3. 在左侧导航栏,选择实例列表。

  4. 在实例列表页面单击目标个人版实例。

  5. 在个人版实例管理页面左侧导航栏选择仓库管理 > 代码源。

  6. 在代码源页面单击Bitbucket操作列的绑定账号。

  7. 在Bitbucket对话框中单击点击前往源代码仓库登录。

  8. 在Bitbucket页面输入电子邮件地址,单击继续,输入密码,单击登录。

  9. 在Confirm access to your account页面确认授予权限无误后,单击同意访问。

    返回容器镜像服务控制台,可以看到页面显示您已成功绑定Bitbucket账号,表示绑定成功。

绑定个人版实例与GitLab代码平台

如果您使用的是自建的GitLab,绑定自建GitLab需要注意以下端口事项:

  • HTTP服务

    默认使用80端口。如果要使用其他端口,请在触发器URL末尾手动添加端口号,而且只能选择以下端口号:80、21、443、70、210、280、488、591、777、1025~65535。

  • HTTPS服务

    默认使用443端口。只支持默认的443端口,如果要使用其他端口号,请使用HTTP服务。

说明
  • 不支持防火墙下以及自签名HTTPS的GitLab接入,请确保GitLab在公网可访问。

  • 个人版绑定GitLab的代码仓库若在多级代码组(Group)下,则仅支持手动触发镜像构建。

  1. 创建GitLab的Access Token。

    1. 登录GitLab。

    2. 在GitLab页面单击个人账号,然后单击Settings。

    3. 在User Settings页面左侧导航栏单击Access Tokens。

    4. 在Access Tokens页面设置名称和过期时间,选中api,然后单击Create personal access token。

      创建完成后,您可以在Access Tokens页面查看创建的Access Token。生成个人访问令牌后,单击令牌右侧的复制按钮保存令牌值。令牌仅显示一次,离开页面后无法再次查看。

  2. 绑定GitLab代码平台。

    1. 登录容器镜像服务控制台。

    2. 在顶部菜单栏,选择所需地域。

    3. 在左侧导航栏,选择实例列表。

    4. 在实例列表页面单击目标个人版实例。

    5. 在个人版实例管理页面选择仓库管理 > 代码源。

    6. 在代码源页面单击GitLab操作列的绑定账号。

    7. 在对话框中设置参数,然后单击确定。

      • 地址:输入GitLab的登录地址。

        • 如果您使用的是私有GitLab,请输入私有GitLab登录地址。

        • 如果您使用的是公有GitLab,请输入公有GitLab登录地址。

      • 用户名称:输入登录GitLab的账号名。

      • 私有Token:输入上文创建的Access Token。

      在代码源页面GitLab操作列显示已绑定,说明绑定成功。

相关文档

如果绑定源代码平台失败,您可以查看文档排查失败原因。相关文档,请参见源代码仓库常见问题。