michaelngcg/postgres-pg_partman

Gitlab CI/CD PostgreSQL v15.4 服务镜像（含pg_partman扩展）

镜像概述

本镜像基于PostgreSQL v15.4构建，专为Gitlab CI/CD环境设计，已预装pg_partman扩展。主要用于在CI/CD流水线中提供数据库服务支持，满足集成测试、构建验证等场景需求，同时通过pg_partman扩展支持自动化表分区管理。

核心功能与特性

• 基础数据库功能：完整支持PostgreSQL v15.4的所有原生功能，包括SQL查询、事务处理、索引管理等
• pg_partman扩展：预装表分区管理工具pg_partman，支持时间/序列分区、自动分区维护、分区模板配置等功能
• CI/CD优化：针对Gitlab CI/CD环境进行适配，可直接作为服务集成到流水线配置中
• 轻量级部署：基于官方PostgreSQL镜像优化，保持较小体积同时确保功能完整

使用场景与适用范围

• Gitlab CI/CD流水线中的数据库集成测试环境
• 需要表分区功能的应用构建验证流程
• 开发阶段自动化测试中需要PostgreSQL 15.4及pg_partman扩展的场景
• 临时数据库服务需求，如功能验证、数据迁移测试等

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name gitlab-ci-postgres \
  -e POSTGRES_USER=ci_user \
  -e POSTGRES_PASSWORD=ci_password \
  -e POSTGRES_DB=ci_test_db \
  -p 5432:5432 \
  [镜像名称]

Gitlab CI/CD集成配置

在.gitlab-ci.yml中作为服务使用：

yaml
services:
  - name: [镜像名称]
    alias: postgres
    variables:
      POSTGRES_USER: ci_user
      POSTGRES_PASSWORD: ci_password
      POSTGRES_DB: ci_test_db

variables:
  DATABASE_URL: "postgresql://ci_user:ci_password@postgres:5432/ci_test_db"

test_job:
  script:
    - psql -h postgres -U ci_user -d ci_test_db -c "CREATE EXTENSION pg_partman;"
    - # 执行数据库测试命令

环境变量配置

pg_partman扩展使用

容器启动后，通过以下命令启用pg_partman扩展：

sql
CREATE EXTENSION pg_partman;

扩展启用后，可使用pg_partman提供的分区管理功能，例如创建时间分区表：

sql
SELECT partman.create_parent(
  p_parent_table => 'public.metrics',
  p_control => 'timestamp',
  p_type => 'time',
  p_interval => 'daily',
  p_premake => 7
);

注意事项

• 本镜像主要用于CI/CD环境，不建议用于生产环境数据存储
• 容器停止后数据默认不会持久化，如需保留数据需挂载数据卷
• pg_partman扩展需在数据库中手动启用（CREATE EXTENSION）后使用