plexsystems/sinker

sinker 镜像文档

概述

sinker 是一个轻量级工具，用于将容器镜像从一个容器 registry 同步到另一个容器 registry。它简化了跨仓库的镜像迁移与同步流程，适用于需要在不同环境或仓库间保持镜像一致性的场景。

源代码地址：https://github.com/plexsystems/sinker

核心功能与特性

• 跨 registry 同步：支持将镜像从源 registry 完整同步到目标 registry，包括镜像标签、元数据等关键信息
• 轻量级设计：工具体积小巧，运行时资源消耗低，可在各类环境中高效部署
• 灵活配置：支持通过配置文件定义同步规则，满足批量镜像同步需求

使用场景与适用范围

• 镜像备份：将核心业务镜像从主 registry 同步到备份 registry，提升数据安全性
• 跨环境迁移：将公共 registry（如 Docker Hub）中的镜像同步到私有 registry，满足内网环境隔离需求
• 多仓库一致性维护：在开发、测试、生产等多环境 registry 间保持镜像版本一致，确保环境一致性

使用方法与配置说明

基本使用方式

sinker 通过命令行参数或配置文件指定同步规则。以下是 Docker 运行示例：

bash
docker run --rm -v /path/to/config.yaml:/app/config.yaml docker.xuanyuan.run/plexsystems/sinker sync --config /app/config.yaml

配置文件说明

配置文件（YAML 格式）需定义源 registry、目标 registry 及待同步镜像信息。示例配置：

yaml
source:
  registry: docker.io  # 源 registry 地址
  auth:  # 源 registry 认证信息（私有仓库必填）
    username: source-username
    password: source-password
target:
  registry: private-registry.example.com  # 目标 registry 地址
  auth:  # 目标 registry 认证信息（私有仓库必填）
    username: target-username
    password: target-password
images:
  - name: library/nginx  # 待同步镜像名称
    tags: ["latest", "1.25"]  # 待同步镜像标签
  - name: library/alpine
    tags: ["3.18"]

命令行参数

• --config：指定配置文件路径（必填）
• --dry-run：执行空运行，仅输出同步计划，不实际执行同步操作
• --verbose：启用详细日志模式，输出同步过程中的详细信息

注意事项

• 确保源和目标 registry 网络可达，认证信息具备读写权限
• 私有 registry 若使用自签名证书，需通过挂载证书文件（如 -v /path/to/certs:/etc/ssl/certs）配置信任
• 大型镜像同步建议在网络稳定环境中执行，可通过 --verbose 参数监控同步进度