当您对命名空间数、私有仓库数、构建规则数等规格要求不高时,建议使用支持基础镜像功能的个人版。本文介绍如何在个人版实例创建镜像仓库、设置构建规则以及构建镜像。

使用说明

使用个人版实例构建镜像前,您需要确保Dockerfile文件中的基础镜像满足以下要求:
  • 支持使用所有免授权的公开公网镜像。
  • 支持使用个人版同地域同账号的私有公网镜像。
  • 不支持使用个人版非同地域私有镜像。
  • 不支持使用所有地域VPC网络镜像。
  • 不支持使用第三方授权镜像。

例如,在构建镜像时,您的Dockerfile文件中的基础镜像可以使用个人版的公网公开镜像,不可以使用第三方授权镜像。

功能特点

  • 代码变更时自动触发构建

    开启代码变更自动构建镜像后,每次提交代码将自动触发镜像构建,减少手动触发构建的繁琐工作。

    1. 登录容器镜像服务控制台
    2. 在顶部菜单栏,选择所需地域。
    3. 在左侧导航栏,选择实例列表
    4. 实例列表页面单击个人版实例。
    5. 在个人版实例管理页面选择仓库管理 > 镜像仓库
    6. 镜像仓库页面,单击目标仓库右侧操作列的管理
    7. 在左侧导航栏,选择构建,然后开启代码变更自动构建镜像
    代码变更时自动构建镜像
  • 海外构建
    代码构建过程中可能会依赖国外源,但由于网络环境,ACR提供海外机器构建功能。在海外构建完成后,将镜像推送到指定地域的仓库中。
    说明 有时海外回大陆的网络不稳定,可能会导致镜像推送超时失败。
    海外构建
  • 不使用缓存

    开启不使用缓存后,每次构建都会重新拉取基础依赖镜像,这可能会增加镜像拉取时间,因此建议关闭该选项。

  • 多阶段构建

    阿里云容器镜像构建同时支持多阶段构建特性。更多信息,请参见多阶段构建

步骤一:绑定代码源

绑定代码源,本文以绑定GitHub为例。
注意 本地仓库不支持镜像构建功能。
  1. 登录容器镜像服务控制台
  2. 在顶部菜单栏,选择所需地域。
  3. 在左侧导航栏,选择实例列表
  4. 实例列表页面单击个人版实例。
  5. 在个人版实例管理页面选择仓库管理 > 代码源
  6. 代码源页面单击GitHub右侧操作列下的绑定账号
  7. GitHub对话框单击点击前往源代码仓库登录
  8. 在GitHub页面输入账号和密码,然后单击Sign in

    页面自动跳转至容器镜像控制台,并且显示您已成功绑定GitHub账号

步骤二:创建镜像仓库

创建镜像仓库前,需要在所需地域下已创建命名空间。更多信息,请参见命名空间的基本操作

  1. 登录容器镜像服务控制台
  2. 在顶部菜单栏,选择所需地域。
  3. 在左侧导航栏,选择实例列表
  4. 实例列表页面单击个人版实例。
  5. 在个人版实例管理页面选择仓库管理 > 镜像仓库
  6. 镜像仓库页面单击创建镜像仓库
  7. 仓库信息配置向导中,设置命名空间、仓库名称、摘要和仓库类型,本例选择私有镜像仓库类型。然后单击下一步创建镜像仓库对话框
  8. 代码源配置向导中设置代码源构建设置构建规则设置,单击创建镜像仓库
    参数 说明
    代码源 选择代码源,本文以选择GitHub代码为例。单击GitHub,然后选择命名空间和仓库。
    构建设置
    • 代码变更时自动构建镜像:当分支有代码提交后会自动触发构建规则。
    • 海外源智能加速:构建时会在海外机房构建,构建成功后推送到指定地域。如果您项目的Dockerfile文件需要从国外站点下载文件,但是跨境网络不稳定,您可以使用海外源智能加速
    • 不使用缓存:每次构建镜像时会强制重新拉取基础依赖镜像,可能会增加构建时间。开启不使用缓存,可以加速镜像的构建时间。

步骤三:设置构建规则

说明 如果您的镜像仓库管理页面没有构建,说明绑定源代码失败,请参见步骤一重新绑定源代码。
  1. 登录容器镜像服务控制台
  2. 在顶部菜单栏,选择所需地域。
  3. 在左侧导航栏,选择实例列表
  4. 实例列表页面单击个人版实例。
  5. 在个人版实例管理页面选择仓库管理 > 镜像仓库
  6. 镜像仓库页面单击目标仓库右侧操作列中的管理
  7. 在镜像仓库管理页面左侧导航栏单击构建,在构建规则设置区域的左侧单击添加规则
    说明 如需修改构建规则,单击目标规则操作列中的修改
  8. 添加构建规则对话框中设置构建规则,然后单击确定添加构建规则对话框
    参数 说明
    类型 设置源代码仓库的类型,可以是Branch或Tag。
    Branch或Tag 设置构建的代码分支。
    Dockerfile目录 设置Dockerfile文件所在的目录。指的是相对目录,以Branch/Tag的根目录为父目录,例如您的Branch为master,您的Dockerfile文件放在master下,则您的Dockerfile目录为/。
    Dockerfile文件名 设置Dockerfile文件名,默认为Dockerfile。
    镜像版本 设置镜像Tag,例如latest。

步骤四:构建镜像

  1. 登录容器镜像服务控制台
  2. 在顶部菜单栏,选择所需地域。
  3. 在左侧导航栏,选择实例列表
  4. 实例列表页面单击个人版实例。
  5. 在个人版实例管理页面选择仓库管理 > 镜像仓库
  6. 镜像仓库页面,单击目标仓库右侧操作列的管理
  7. 在镜像仓库详情页面,单击左侧导航栏中的构建
  8. 构建规则设置区域,单击目标规则操作列中的立即构建立即构建
    构建完成后,生成新的构建记录。
    说明 单击构建记录右侧操作列下的日志,可以查看构建日志。
    构建日志
  9. 等待镜像构建完成后,单击左侧菜单栏中的镜像版本,查看已构建完成的镜像列表。

    镜像版本
  10. 如果您需要查看所有镜像,请单击构建页签,在构建设置中开启海外机器构建不使用缓存,默认开启代码变更自动构建镜像,可以看到所有镜像版本列表。镜像版本列表

后续步骤