镜像概述

该Docker镜像专注于镜像上游代码仓库，确保容器内提供的源代码与原始上游仓库保持完全一致。通过镜像机制，有效降低对上游仓库直接访问的依赖，提升代码获取的稳定性和一致性，适用于各类需要可靠代码源的场景。

核心功能与特性

• 完整镜像能力：精确复制上游仓库的全部源代码，包括分支、标签及完整提交历史，保障代码完整性。
• 严格同步机制：与上游仓库保持实时或定期同步，确保镜像内容与上游仓库完全一致，无版本偏差。
• 依赖降低：通过本地镜像仓库提供代码访问，减少对上游仓库网络稳定性和可用性的依赖，提升系统鲁棒性。

使用场景与适用范围

• 开发环境统一：开发团队需要共享统一代码源时，确保所有开发者获取的代码版本完全一致，避免因上游仓库更新导致的开发环境差异。
• CI/CD流程保障：在持续集成/持续部署流程中，作为稳定代码输入源，确保每次构建、测试使用的代码版本一致，提升流程可重复性。
• 离线/受限环境：在无法直接访问公网上游仓库的离线环境或网络受限场景中，提供本地化的代码访问能力。
• 代码审计与归档：需要长期保存特定版本代码或进行代码审计时，作为可靠的代码快照存储方案。

使用方法和配置说明

Docker部署示例

基本运行命令

启动容器并指定上游仓库URL，进行基础镜像：

docker run -d \
  --name upstream-repo-mirror \
  -e UPSTREAM_REPO_URL="[***]" \
  your-registry/repo-mirror:latest

自定义同步频率

通过环境变量设置同步间隔（单位：分钟），实现定期自动同步：

docker run -d \
  --name upstream-repo-mirror \
  -e UPSTREAM_REPO_URL="[***]" \
  -e SYNC_INTERVAL=30 \  # 每30分钟同步一次
  your-registry/repo-mirror:latest

数据持久化配置

挂载宿主机目录以持久化存储镜像的仓库数据，避免容器重启后数据丢失：

docker run -d \
  --name upstream-repo-mirror \
  -e UPSTREAM_REPO_URL="[***]" \
  -v /local/mirror-data:/app/mirror-repo \  # 宿主机目录:/容器内仓库路径
  your-registry/repo-mirror:latest

配置参数与环境变量

容器日志与监控

容器运行过程中，同步日志默认输出至标准输出流，可通过docker logs命令查看：

docker logs -f upstream-repo-mirror  # 实时查看同步日志

同步状态可通过检查容器内${MIRROR_DIR}/.sync_status文件获取，文件内容包含最后同步时间及状态信息。