同步规则

创建同步规则

1. 登录容器镜像服务控制台，单击左侧菜单栏“企业版”，然后单击仓库名称进入仓库详情页面。
2. 在左侧导航栏选择“镜像同步 > 同步规则”。
3. 在右上角单击“创建同步规则”。
4. 填写具体规则。

   表1 参数说明

   参数名称	说明	示例
   规则名称	镜像同步规则的名称。	SyncRule
   同步模式	推送到目标仓库：将本仓库中镜像推送到目标仓库中。 从目标仓库拉取：从目标仓库中拉取镜像到本仓库中。	推送到目标仓库
   目标仓库	选择上面添加目标仓库步骤中添加的目标仓库。	-
   目标命名空间	同步至目标仓库后所在的命名空间（其他云厂商可能被称作项目等），不填写则默认是与本仓库中同名的命名空间，如果目标仓库中没有该命名空间同步可能会失败。	library1
   本地命名空间	从目标仓库拉取到本仓库，镜像所在的命名空间，不填写则默认是与目标仓库中同名的命名空间（其他云厂商可能被称作项目等），如果没有命名空间将新建。	library1
   本地仓库推送范围	命名空间：命名空间名称范围。 镜像：镜像名称，默认使用正则表达式匹配。单击可手动选择镜像。 正则表达式规则可填写如nginx-* 、{repo1, repo2} 等，其中： *：匹配不包含路径分隔符“/”的任何字段。 **：匹配包含路径分隔符“/”的任何字段。 ?：匹配任何单个非“/”的字符。 {选项1, 选项2, ...}：同时匹配多个选项。 版本：镜像的版本，同样使用正则表达式匹配，匹配规则与镜像相同。 说明： 当同步模式是“推送到目标仓库”时有该参数。	library2 nginx-* **
   目标仓库拉取范围	命名空间：命名空间名称范围。 镜像：镜像名称，使用正则表达式匹配。 正则表达式规则可填写如nginx-* 、{repo1, repo2} 等，其中： *：匹配不包含路径分隔符“/”的任何字段。 **：匹配包含路径分隔符“/”的任何字段。 ?：匹配任何单个非“/”的字符。 {选项1, 选项2, ...}：同时匹配多个选项。 版本：镜像的版本，同样使用正则表达式匹配，匹配规则与镜像相同。 说明： 当同步模式是“从目标仓库拉取”时有该参数。	library2 nginx-* **
   触发模式	手动：手动触发，规则创建完成后需要您手动单击执行。 事件触发 + 手动：事件触发指推送和被拉取一方有新增镜像且符合匹配规则时触发同步。 定时 + 手动：定时即为设置周期性定时同步。	定时 + 手动
   定时	触发模式为“定时 + 手动”时可以设置。	-
   覆盖	当同步相同版本的镜像时，是否覆盖。	-
   规则描述	规则的描述信息。	-

   图1 创建同步规则
   

5. 单击“确定”完成规则创建。

同步规则示例

• 推送到目标仓库

  将本仓库中library命名空间中以“nginx-”名称开头的所有版本镜像，推送到目标仓库test-edit-fail的lib1命名空间下，触发模式为手动触发，且覆盖相同名称版本的镜像。

  

• 从目标仓库拉取

  将目标仓库test-edit-fail的lib1命名空间中以“nginx-”名称开头的所有版本镜像，拉取到本仓库library1命名空间中，触发方式为手动触发，且覆盖相同名称版本的镜像。

  

管理同步规则

成功创建后即可在“同步规则”页面查看已创建的同步规则，您可以执行以下操作管理同步规则。

图2 同步规则

图3 任务详情

• 启用：表示规则启用，表示规则关闭。新创建的同步规则默认为启用状态，您可以自行调整。
• 执行：手动触发同步规则。
• 编辑：重新编辑同步规则，所有参数均可编辑。
• 删除：删除该同步规则。
• 查看同步任务：当同步规则被触发时，符合规则范围的镜像将被同步。同步任务包含的信息如下：

  表2 同步任务

  参数	说明
  任务ID	仓库内唯一的同步执行任务ID。
  状态	任务完成状态。
  触发模式	手动或自动。 单击“执行”为手动方式，通过规则定义的周期自动执行，则为自动方式。
  成功百分比	同步成功的镜像数占总数的百分比。
  总数	当前任务需要同步的镜像总数。
  持续时间	完成一次任务消耗的时间。
  创建时间	同步任务被触发的时间。
  操作	详情：任务详细信息，单击后在侧边栏可查看哪些镜像被同步。