GitLab CI Django和Postgres

基础概念

GitLab CI/CD 是 GitLab 提供的持续集成和持续交付工具，允许开发者在代码提交时自动构建、测试和部署应用程序。它通过 .gitlab-ci.yml 文件定义流水线（Pipeline），每个流水线包含多个阶段（Stage），每个阶段包含多个作业（Job）。

Django 是一个基于 Python 的高效 Web 框架，遵循 MVC（模型-视图-控制器）设计模式，内置 ORM（对象关系映射）、Admin 后台、表单处理等功能，适合快速开发。

PostgreSQL（Postgres） 是一个开源的关系型数据库，支持复杂查询、事务、外键约束和 JSON 数据类型，适合高并发和高可靠性的应用场景。

优势

GitLab CI/CD：
- 与 GitLab 仓库无缝集成，无需额外配置。
- 支持多阶段流水线，灵活定义构建、测试、部署流程。
- 提供容器化支持（Docker/Kubernetes）。
- 内置 Artifacts 和 Cache 机制，加速构建。

Django：
- 开箱即用的 Admin 后台和 ORM，减少开发时间。
- 完善的文档和活跃的社区。
- 支持 REST API 开发（如 Django REST framework）。
PostgreSQL：
- ACID 兼容，支持复杂事务。
- 高性能，支持并行查询和索引优化。
- 扩展性强（如 PostGIS 地理信息扩展）。

应用场景

Web 应用开发：Django + PostgreSQL 构建动态网站或 API 服务。
自动化测试：GitLab CI 自动运行 Django 单元测试、集成测试。
持续部署：通过 GitLab CI 将 Django 应用部署到云服务器或容器平台。

常见问题与解决方案

1. Django 无法连接 Postgres

原因：

数据库配置错误（如 settings.py 中 DATABASES 的 HOST、PORT、USER 或 PASSWORD 不正确）。
Postgres 服务未启动或网络不通。
用户权限不足。

解决：

# settings.py 示例配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'myuser',
        'PASSWORD': 'mypassword',
        'HOST': 'localhost',  # 或 Postgres 容器名（如 Docker 环境）
        'PORT': '5432',
    }
}

检查步骤：

确认 Postgres 服务运行：psql -U myuser -d mydatabase。
检查防火墙是否开放 5432 端口。
授予用户权限：GRANT ALL PRIVILEGES ON DATABASE mydatabase TO myuser;。

2. GitLab CI 中测试失败

原因：

测试环境缺少依赖（如 Postgres 未安装）。
数据库未初始化或迁移。
环境变量未正确传递。

解决：

# .gitlab-ci.yml 示例
stages:
  - test

test:
  stage: test
  image: python:3.9
  services:
    - postgres:13
  variables:
    POSTGRES_DB: mydatabase
    POSTGRES_USER: myuser
    POSTGRES_PASSWORD: mypassword
  before_script:
    - pip install -r requirements.txt
    - python manage.py migrate
  script:
    - python manage.py test

关键点：

使用 services 启动 Postgres 容器。
通过 variables 设置数据库连接参数。
before_script 初始化数据库。

3. 数据库迁移冲突

原因：

多人开发时迁移文件冲突（如 0001_initial.py 重复）。
本地迁移与远程数据库不一致。

解决：

删除冲突迁移文件（保留最新版本）：
删除冲突迁移文件（保留最新版本）：
重新生成迁移：
重新生成迁移：

示例代码

Django 模型与 Postgres 交互

# models.py
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey('Author', on_delete=models.CASCADE)

class Author(models.Model):
    name = models.CharField(max_length=50)

GitLab CI 完整配置

# .gitlab-ci.yml
image: python:3.9

services:
  - postgres:13

variables:
  DATABASE_URL: "postgres://myuser:mypassword@postgres:5432/mydatabase"

stages:
  - test
  - deploy

test:
  stage: test
  before_script:
    - apt-get update && apt-get install -y libpq-dev
    - pip install -r requirements.txt
    - python manage.py migrate
  script:
    - python manage.py test

deploy:
  stage: deploy
  only:
    - main
  script:
    - echo "Deploy to production server..."