mattford63/registry

Docker Registry (含python-mysqldb) 镜像文档

镜像概述

本镜像基于官方Docker Registry构建，额外集成了python-mysqldb库。Docker Registry是用于存储和分发Docker镜像的核心组件，而python-mysqldb是Python语言连接MySQL数据库的驱动库。该镜像适用于需要搭建私有Docker镜像仓库，同时需通过Python实现与MySQL数据库交互功能的场景。

核心功能和特性

基础功能

• 完整支持Docker Registry官方功能，包括镜像存储、版本控制、元数据管理
• 支持标准Docker镜像推送(push)、拉取(pull)、删除(delete)等操作
• 兼容Docker CLI及Docker Compose等工具

扩展特性

• 内置python-mysqldb库，支持Python脚本连接MySQL数据库
• 可基于Python实现自定义镜像管理逻辑（如镜像元数据同步至MySQL、访问日志记录等）
• 保留官方Registry的可配置性，支持多种存储后端（文件系统、S3、GCS等）

使用场景

• 企业内部私有Docker镜像仓库搭建
• 需要将镜像元数据存储至MySQL数据库的场景
• 开发基于Python的Docker Registry扩展工具（如自定义认证、镜像扫描等）
• 教学或测试环境中同时需要Registry和Python-MySQL交互能力的场景

使用方法

基本运行

通过以下命令启动Registry服务（默认使用文件系统存储）：

bash
docker run -d -p 5000:5000 --name my-registry \
  -v /path/to/registry/data:/var/lib/registry \
  docker.xuanyuan.run/registry-with-mysqldb

配置存储后端

可通过环境变量配置存储后端，例如使用文件系统存储：

bash
docker run -d -p 5000:5000 --name my-registry \
  -e REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry \
  -v /path/to/registry/data:/var/lib/registry \
  docker.xuanyuan.run/registry-with-mysqldb

使用python-mysqldb

进入容器内部执行Python脚本，测试MySQL连接：

bash
# 进入容器
docker exec -it my-registry bash

# 创建Python测试脚本
cat > test_mysql.py << EOF
import MySQLdb

# 连接MySQL数据库（需替换为实际数据库信息）
db = MySQLdb.connect(
  host="mysql-host",
  user="username",
  passwd="password",
  db="database"
)

cursor = db.cursor()
cursor.execute("SELECT VERSION()")
data = cursor.fetchone()
print("MySQL Version: %s" % data)
db.close()
EOF

# 执行脚本
python test_mysql.py

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  registry:
    image: docker.xuanyuan.run/registry-with-mysqldb
    ports:
      - "5000:5000"
    volumes:
      - ./registry-data:/var/lib/registry
    environment:
      - REGISTRY_HTTP_ADDR=0.0.0.0:5000
      - REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry
    restart: always

启动服务：

bash
docker-compose up -d

环境变量配置

更多配置参数可参考https://docs.docker.com/registry/configuration/