容器镜像服务 ACR：使用企业版实例构建镜像

步骤一：绑定源代码平台

步骤二：创建命名空间

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

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

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

4. 在实例列表页面单击目标企业版实例。

5. 在企业版实例管理页面选择仓库管理 > 命名空间。

6. 在命名空间页面单击创建命名空间。

7. 在创建命名空间对话框中设置命名空间名称、是否自动创建仓库、默认仓库类型。单击确定。

步骤三：创建镜像仓库

创建镜像仓库，并绑定代码仓库，此代码仓库触发的镜像构建都会推送到该镜像仓库下。

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

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

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

4. 在实例列表页面单击目标企业版实例。

5. 在企业版实例管理页面选择仓库管理 > 镜像仓库。

6. 在镜像仓库单击创建镜像仓库。

7. 在仓库信息配置向导中设置命名空间、仓库名称、仓库类型、镜像版本、镜像加速、摘要、描述信息，单击下一步。

8. 在代码源配置向导中设置代码源、构建设置、构建规则设置，单击创建镜像仓库。

   参数	说明
   代码源	选择代码源。
   构建设置	代码变更时自动构建镜像：当分支有代码提交后会自动触发构建规则。 海外源智能加速：构建时会在海外机房构建，构建成功后推送到指定地域。如果您项目的Dockerfile文件需要从国外站点下载文件，但是跨境网络不稳定，您可以使用海外源智能加速。 不使用缓存：每次构建镜像时会强制重新拉取基础依赖镜像，可能会增加构建时间。关闭不使用缓存，可以加速镜像的构建时间。

   在镜像仓库页面单击目标镜像仓库，您可以在镜像仓库管理页面左侧导航栏看到构建，说明镜像仓库和源代码仓库绑定成功。

步骤四：构建镜像

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

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

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

4. 在实例列表页面单击目标企业版实例。

5. 在企业版实例管理页面左侧导航栏，选择仓库管理 > 镜像仓库。

6. 在镜像仓库页面单击目标仓库右侧操作列中的管理。

7. 单击左侧导航栏中的构建，在构建规则设置区域单击添加规则，在构建信息配置向导中设置参数，然后单击下一步。

   参数	说明
   类型	设置源代码仓库的类型，可以是Branch或Tag。
   Branch/Tag	选择或者填写Branch/Tag，支持正则规则。当正则规则为release-(?<imageTag>\w*)时，将识别release-v1源代码变更并自动构建版本为v1的镜像（不支持立即构建），更多信息，请参见正则表达式命名捕获组。 说明 设置正则规则后仅支持系统自动构建，不支持手动立即构建。
   构建上下文目录	设置Dockerfile文件所在的目录。指的是相对目录，以Branch/Tag的根目录为父目录，例如您的Branch为master，您的Dockerfile文件放在master下，则您的Dockerfile目录为/。
   Dockerfile文件名	设置Dockerfile文件名，默认为Dockerfile。

8. 在镜像版本配置向导中设置参数，单击保存，然后单击下一步。

   说明

   单击新增配置，可以增加镜像版本，最多可以设置3个镜像版本。

   参数	说明
   镜像版本	设置镜像Tag，例如latest。支持命名捕获，例如使用Branch/Tag中捕获的内容。
   时间	推送源代码的东八区（UTC+8）时间，有两种格式可供选择，例如20201015和202010151613。 说明 该参数为可选项，当选中该参数后系统仅支持自动构建，不支持手动立即构建。
   Commit ID	最近一次推送代码的Commit ID，默认取前6位，可以滑动下方的滑块设置位数。 说明 该参数为可选项，当选中该参数后系统仅支持自动构建，不支持手动立即构建。

9. 在构建配置配置向导中设置构建参数，然后单击确定。

   参数	说明
   构建架构	选择构建架构，支持并行构建，最终形成一个镜像版本对应多个架构镜像。
   构建参数	镜像构建运行时参数，构建参数由区分大小写的键值对组成，您最多可以设置20个构建参数。您可以设置构建参数，该构建参数会修改Dockerfile文件中环境变量，使同一个Dockerfile文件呈现多种状态。

10. 触发构建规则。

    您可以通过以下两种方式触发构建规则：

    • 在构建页面构建规则设置区域单击目标构建规则操作列下的立即构建，触发构建规则。

    • 向代码仓库的master分支提交代码，触发构建规则。

    说明

    • 在构建页面构建日志区域单击目标构建任务操作列的取消，可以取消构建任务。

    • 在构建页面构建日志区域单击目标构建任务操作列的日志，可以查看构建过程日志。

    在左侧导航栏单击镜像版本，您可以看到构建的镜像，说明构建镜像成功。

构建镜像示例一：基于固定分支main构建镜像（支持手动立即构建）

当main分支上源代码变更或手动单击立即构建时，会触发镜像构建。构建的工作目录是/，文件为构建工作目录下名为Dockerfile的文件。镜像构建完成后生成的镜像版本为latest，构建规则如下图所示。

构建镜像示例二：基于正则规则匹配分支构建镜像（不支持手动立即构建）

当以release-开头的分支源代码变更时，会触发镜像构建。构建的工作目录是/，文件为构建工作目录下名为Dockerfile的文件。

以release-v1的分支源代码变更为例，正则规则release-(?<imageTag>\w*)会将分支名中的v1捕获给变量imageTag，并在镜像版本中使用该变量。镜像构建完成后生成的镜像版本为v1-202010151625-d4ef3dc3b77a011a5779eec7efdd45，构建规则如下图所示。

相关操作