tmvdl/projects

镜像概述和主要用途

该Docker镜像提供一个集成化的镜像仓库解决方案，旨在将多个项目的Docker镜像集中存储和管理在单一仓库中，消除多仓库分散管理的复杂性，为开发和运维团队提供统一的镜像访问入口和管理平台。通过整合多项目镜像存储，有效简化镜像版本控制、权限管理和分发流程，提升团队协作效率。

核心功能和特性

• 集中化存储：支持将多个独立项目的Docker镜像统一存储在单一仓库中，避免多仓库分散管理导致的资源浪费和维护成本增加
• 统一访问接口：提供标准化的REST API和Web管理界面，兼容Docker CLI原生命令，支持通过命令行、Web控制台等多种方式访问和操作镜像
• 简化管理流程：集成镜像标签管理、版本控制、自动清理策略等功能，减少多项目镜像维护的重复操作
• 权限控制：支持基于项目或用户的细粒度权限管理，可配置不同项目镜像的访问和操作权限
• 轻量级部署：采用容器化架构，部署简单快捷，资源占用低，可无缝集成到现有CI/CD流水线

使用场景和适用范围

• 多项目开发团队：需要管理5个以上独立项目Docker镜像的中小型开发团队，解决多仓库账号分散、权限管理复杂问题
• 微服务架构环境：微服务项目中存在大量独立服务镜像（如API服务、数据服务、前端服务等），需统一管理的场景
• CI/CD流水线集成：作为自动化构建流程的镜像存储环节，集中接收各项目CI流程产出的镜像，简化后续部署环节的镜像拉取流程
• 开发测试环境：在开发或测试阶段，需要快速共享和迭代多个项目镜像版本的场景

详细使用方法和配置说明

基本部署流程

1. 拉取镜像

bash
docker pull [镜像仓库地址]/all-projects-registry:latest

2. 启动容器（基础配置）

bash
docker run -d \
  --name all-projects-registry \
  -p 5000:5000 \
  -v /local/storage/path:/var/lib/registry \  # 挂载本地目录持久化存储镜像数据
  -e REGISTRY_STORAGE_DELETE_ENABLED=true \  # 启用镜像删除功能
  [镜像仓库地址]/all-projects-registry:latest

3. Docker Compose配置示例

yaml
version: '3.8'
services:
  registry:
    image: [镜像仓库地址]/all-projects-registry:latest
    container_name: all-projects-registry
    restart: always
    ports:
      - "5000:5000"  # 仓库服务端口
      - "8080:8080"  # Web管理界面端口（若集成）
    volumes:
      - ./registry-data:/var/lib/registry  # 镜像数据持久化目录
      - ./config:/etc/registry  # 自定义配置文件目录（可选）
      - ./auth:/etc/registry/auth  # 权限配置文件目录（可选）
    environment:
      - REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry
      - REGISTRY_HTTP_ADDR=0.0.0.0:5000
      - REGISTRY_AUTH_ENABLED=true
      - REGISTRY_AUTH_TYPE=htpasswd
      - REGISTRY_AUTH_HTPASSWD_PATH=/etc/registry/auth/htpasswd

核心配置参数说明

镜像操作示例

1. 推送项目镜像到仓库

bash
# 1. 为项目镜像添加仓库标签（格式：仓库地址/项目名/镜像名:版本）
docker tag project-a-image:v1.2.0 localhost:5000/project-a/project-a-image:v1.2.0

# 2. 推送到集成仓库
docker push localhost:5000/project-a/project-a-image:v1.2.0

2. 拉取项目镜像

bash
# 从集成仓库拉取指定项目镜像
docker pull localhost:5000/project-b/project-b-image:v2.0.1

3. 查看仓库镜像列表

bash
# 通过API查看所有项目镜像
curl http://localhost:5000/v2/_catalog

# 查看指定项目的镜像标签
curl http://localhost:5000/v2/project-a/project-a-image/tags/list

Web管理界面访问

若镜像集成Web管理插件，可通过浏览器访问 http://<仓库IP>:8080 打开可视化管理界面，支持以下操作：

• 查看所有项目镜像的存储状态和占用空间
• 管理镜像标签和版本，执行删除过期镜像操作
• 配置项目级别的访问权限和存储配额
• 查看镜像推送/拉取操作日志