pkimber/gitlab-pytest

Django-PostgreSQL测试镜像（Python 3）

镜像概述

该Docker镜像专为Django项目测试设计，基于Python 3环境构建，集成PostgreSQL数据库支持，旨在提供便捷、一致的测试环境。镜像预装Django测试所需依赖组件，简化测试流程，帮助开发者快速验证项目功能，支持本地开发与CI/CD自动化测试场景。

核心功能与特性

• Python 3基础环境：基于官方Python 3镜像构建，兼容Python 3.6+版本，适配现代Django项目需求。
• PostgreSQL集成支持：内置PostgreSQL客户端及依赖库（如psycopg2），支持数据库连接与交互测试。
• 测试依赖预装：包含Django测试框架、数据库驱动及常用工具，减少手动配置步骤。
• 环境一致性：标准化测试环境，避免因本地配置差异导致的测试结果不一致问题。
• 灵活定制能力：支持通过环境变量调整数据库参数、Django设置，适配不同测试场景。

使用场景与适用范围

• Django项目测试：适用于单元测试、集成测试及功能测试，验证数据库交互、模型逻辑等核心功能。
• 自动化测试流程：可集成至CI/CD管道（如GitHub Actions、GitLab CI），实现代码提交后的自动测试。
• 团队协作环境：为开发团队提供统一测试基准，降低环境配置成本。
• 快速原型验证：支持快速启动测试环境，验证新功能或修复的有效性。

使用方法与配置说明

获取镜像

通过Docker Hub或私有仓库拉取镜像（请替换[镜像仓库地址]为实际地址）：

bash
docker pull [镜像仓库地址]/django-postgres-test:python3

基础使用示例

本地测试启动

挂载Django项目目录并执行测试命令：

bash
docker run -it --rm \
  -v /本地项目路径:/app \
  -e POSTGRES_HOST=postgres-host \
  -e POSTGRES_PORT=5432 \
  -e POSTGRES_USER=testuser \
  -e POSTGRES_PASSWORD=testpass \
  -e POSTGRES_DB=testdb \
  [镜像仓库地址]/django-postgres-test:python3 \
  sh -c "cd /app && python manage.py test"

Docker Compose配置（含PostgreSQL服务）

创建docker-compose.yml实现多容器协同测试：

yaml
version: '3.8'

services:
  postgres:
    image: postgres:14
    environment:
      POSTGRES_USER: testuser
      POSTGRES_PASSWORD: testpass
      POSTGRES_DB: testdb
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U testuser -d testdb"]
      interval: 5s
      timeout: 5s
      retries: 5

  test:
    image: [镜像仓库地址]/django-postgres-test:python3
    volumes:
      - ./django-project:/app
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_USER: testuser
      POSTGRES_PASSWORD: testpass
      POSTGRES_DB: testdb
      DJANGO_SETTINGS_MODULE: myproject.settings.test
    depends_on:
      postgres:
        condition: service_healthy
    command: sh -c "cd /app && python manage.py test"

启动测试环境：

bash
docker-compose up

环境变量配置

注意事项

• 版本兼容性：建议使用Django 2.2+版本，确保与Python 3环境兼容。
• 权限处理：挂载本地目录时可添加-u $(id -u):$(id -g)参数解决权限问题。
• 依赖管理：项目额外依赖可通过requirements.txt在容器启动时安装：

  bash
  docker run ... sh -c "pip install -r /app/requirements.txt && python manage.py test"
  

• 数据持久化：如需保留测试数据，可挂载PostgreSQL数据目录（如-v postgres-data:/var/lib/postgresql/data）。