orbisk/django-test Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

官方Python镜像虽广泛用于软件开发，但可能未预装Django测试所需的全部依赖，尤其在CI流水线中使用MySQL、MariaDB或Postgres作为服务时，需额外安装依赖或配置，增加开发流程复杂度。本镜像旨在提供便捷高效的CI环境MySQL数据库支持，预安装MySQL配置及必要客户端（如mysql-client），简化Django测试 setup 流程。

核心功能与特性

• 🐍 支持Python 3.7 - 3.13版本
• ⚡️ 预安装 uv 包管理器
• 🏗️ 内置构建依赖
• 🔄 专为CI/CD环境优化
• 数据库支持：
  • 🐘 Postgres
  • 🐬 MariaDB
  • 🐬 MySQL
  • 🏢 MSSQL（测试版）

兼容性说明

• 🟢 已支持/测试
• 🟡 未知/未测试
• 🟠 测试版/实验性（欢迎反馈使用体验）
• 🔴 当前不支持（如需支持可提交Issue或Pull request）

Python版本兼容性

MySQL兼容性*️⃣

MariaDB兼容性*️⃣

Postgres兼容性

MSSQL兼容性 (详见)

*️⃣ 需额外步骤：参见创建测试数据库时出错

常见问题

创建测试数据库时出错

错误信息：Got an error creating the test database: (1044, "1044 (42000): Access denied for user '<test_user>'@'%' to database 'test_<my_db>'", '42000')

原因：MySQL用户仅被授予MYSQL_DB的权限，导致Django无法创建测试数据库。

解决方法：使用非root用户操作MySQL和MariaDB时，需为测试用户授予权限：

sql
echo "GRANT ALL on *.* to '$MYSQL_USER';"| mysql -u root --password="$MYSQL_ROOT_PASSWORD" -h <host> -p <port>

CI配置示例

GitLab CI

yml
variables:
  MARIADB_USER: test_user          # 测试用户
  MARIADB_PASSWORD: password       # 测试用户密码
  MARIADB_ROOT_PASSWORD: root@password  # root用户密码
  MARIADB_DATABASE: my_db          # 数据库名称

django-tests:
  image: orbisk/django-test:3.11   # 使用Python 3.11版本镜像
  stage: test                      # 测试阶段
  services:
    - name: mariadb:10             # 使用MariaDB 10服务
      alias: maria                 # 服务别名
  script:
    - pip3 install -r requirements.txt  # 安装项目依赖
    # MySQL用户仅拥有MYSQL_DB权限，需额外授权以创建测试数据库
    - echo "GRANT ALL on *.* to '$MARIADB_USER';"| mysql -u root --password="$MARIADB_ROOT_PASSWORD" -h maria
    - python3 manage.py test       # 执行Django测试

MSSQL测试版说明

⚠️ MSSQL支持当前处于测试阶段。如有问题或疑问，请在GitHub提交Issue。

当前仅支持/测试以下版本：

• ^mssql-server-linux:2019-CU23-ubuntu-20.04
• mssql-django===1.3
• Microsoft ODBC Driver 17 for SQL Server 和 Microsoft ODBC Driver 18 for SQL Server（'Microsoft ODBC Driver 18 for SQL Server' 当前在使用自签名SSL证书的CI服务中存在兼容性问题，如有解决方案欢迎提交Issue或PR）

限制

Python 3.7

Python 3.7不再被CI/CD测试覆盖，因此无法保证镜像在该版本下的预期功能。原因是mssql-django等包已停止支持Python 3.7，导致无法进行测试。

反馈

如使用本镜像时遇到问题或有疑问，请在GitHub提交Issue。