codestation/registry

Docker Registry 2.0镜像文档

镜像概述

Docker Registry 2.0镜像是Docker官方提供的容器化镜像仓库实现，用于存储、管理和分发Docker镜像。作为容器化环境的核心组件，它允许用户搭建私有或内部镜像仓库，实现镜像的本地存储与分发，提高镜像拉取效率并增强数据安全性。

核心功能与特性

• 镜像存储与管理：支持Docker镜像的上传（push）、拉取（pull）、删除等基础操作，实现镜像的全生命周期管理。
• 版本控制：通过标签（tag）机制支持同一镜像的多版本管理，满足不同环境（开发、测试、生产）的镜像需求。
• 存储灵活性：支持多种存储后端，包括本地文件系统、云存储（如S3、GCS）等，可根据需求配置存储策略。
• 安全特性：可集成TLS加密传输，支持基于令牌的认证机制，保护镜像仓库的访问安全。
• API兼容性：遵循Docker Registry HTTP API V2规范，与Docker CLI、CI/CD工具等生态组件无缝集成。

使用场景与适用范围

• 私有镜像仓库：企业内部搭建私有仓库，存储敏感业务镜像，避免依赖公共仓库，提升安全性与可控性。
• 开发环境镜像管理：开发团队共享内部构建的镜像，加速开发迭代流程。
• CI/CD流程集成：作为持续集成/持续部署流水线的镜像存储节点，实现构建产物的自动推送与拉取。
• 边缘计算场景：在网络条件有限的边缘环境中，本地部署镜像仓库减少对外部网络的依赖。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动一个本地Docker Registry服务：

bash
docker run -d \
  -p 5000:5000 \
  --name registry \
  --restart=always \
  -v /path/to/local/storage:/var/lib/registry \
  registry:2

参数说明：

• -p 5000:5000：将容器的5000端口映射到主机的5000端口，用于API通信。
• --name registry：指定容器名称为registry。
• --restart=always：设置容器自动重启策略。
• -v /path/to/local/storage:/var/lib/registry：将主机目录挂载到容器内的镜像存储路径，实现数据持久化。

Docker Compose配置

创建docker-compose.yml文件，定义Registry服务：

yaml
version: '3'
services:
  registry:
    image: registry:2
    ports:
      - "5000:5000"
    volumes:
      - registry-data:/var/lib/registry
    restart: always
    environment:
      - REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry  # 存储根目录
      - REGISTRY_HTTP_ADDR=0.0.0.0:5000  # 监听地址与端口

volumes:
  registry-data:  # 使用命名卷持久化数据

启动服务：

bash
docker-compose up -d

环境变量配置

Docker Registry支持通过环境变量自定义配置，常用参数如下：

镜像操作示例

1. 标记镜像：将本地镜像标记为私有仓库地址格式

   bash
   docker tag my-image:latest localhost:5000/my-image:latest
   

2. 推送镜像：上传镜像到私有仓库

   bash
   docker push localhost:5000/my-image:latest
   

3. 拉取镜像：从私有仓库拉取镜像

   bash
   docker pull localhost:5000/my-image:latest
   

4. 列出仓库镜像：通过API查询仓库中的镜像

   bash
   curl http://localhost:5000/v2/_catalog
   

安全配置（可选）

为增强安全性，可配置TLS加密与认证：

1. 启用TLS：

   bash
   docker run -d \
     -p 5000:5000 \
     --name registry \
     -v /path/to/certs:/certs \
     -e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/domain.crt \
     -e REGISTRY_HTTP_TLS_KEY=/certs/domain.key \
     registry:2
   

2. 配置基本认证（使用htpasswd）：

   bash
   # 创建密码文件
   htpasswd -Bc /path/to/auth/htpasswd username
   
   # 启动带认证的Registry
   docker run -d \
     -p 5000:5000 \
     --name registry \
     -v /path/to/auth:/auth \
     -e REGISTRY_AUTH=htpasswd \
     -e REGISTRY_AUTH_HTPASSWD_REALM="Registry Realm" \
     -e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \
     registry:2
   

认证后，需通过docker login命令登录私有仓库：

bash
docker login localhost:5000