feat: 更新 Dockerfile 以支持 Pig 环境管理器

Author: Ricco Xie

CHANGELOG.md

@@ -0,0 +1,114 @@
+# 更新日志
+
+## 20250929 - 使用 Pig 包管理器重构
+
+### 新增功能
+
+- **Pig 包管理器集成**：使用 [Pig](https://pig.pgsty.com/zh/start/) 统一管理 PostgreSQL 内核和扩展
+- **简化构建过程**：移除复杂的手动编译步骤
+- **多架构支持**：自动处理不同 CPU 架构的兼容性
+- **容错安装**：智能处理安装失败的情况
+- **环境管理**：通过 Pig 自动配置 PostgreSQL 运行环境
+
+### 主要变化
+
+#### 🔧 Dockerfile 重构
+
+- **之前**：手动下载、编译 SCWS 库和 zhparser 扩展
+- **现在**：使用 Pig 包管理器统一管理 PostgreSQL 内核和扩展（基于 Ubuntu 24.04）
+- **优势**：构建时间更短，维护更简单，环境更统一，使用最新的 Ubuntu LTS
+
+#### 📦 环境管理优化
+
+- **统一管理**：PostgreSQL 内核和扩展都通过 Pig 包管理器管理
+- **自动依赖**：Pig 自动处理内核和扩展的依赖关系
+- **版本控制**：支持 PostgreSQL 内核和扩展的版本管理
+- **环境配置**：自动配置 PostgreSQL 运行环境
+
+#### 🗂️ 项目结构简化
+
+- **删除文件**：移除复杂的配置文件和多余脚本
+- **保留核心**：只保留必要的构建和初始化文件
+- **清晰结构**：项目文件结构更加简洁明了
+
+### 技术改进
+
+#### 构建过程
+
+```dockerfile
+# 新的构建方式
+RUN curl -fsSL https://repo.pigsty.io/pig | bash
+RUN pig repo add all -u
+RUN pig ext install pg16
+RUN pig ext install pg_trgm hstore btree_gist pg_stat_statements unaccent
+RUN pig ext install zhparser || echo "zhparser not available for this architecture"
+```
+
+#### 扩展管理
+
+```bash
+# 查看已安装扩展
+docker exec -it postgres-zh pig ext list
+
+# 安装新扩展
+docker exec -it postgres-zh pig ext install <extension_name>
+
+# 更新扩展
+docker exec -it postgres-zh pig ext update <extension_name>
+
+# 搜索可用扩展
+docker exec -it postgres-zh pig ext search <extension_name>
+```
+
+### 兼容性说明
+
+| 架构 | PostgreSQL | zhparser | 其他扩展 | 状态 |
+|------|------------|----------|----------|------|
+| linux/amd64 | ✅ 完整支持 | ✅ 完整支持 | ✅ 完整支持 | 🟢 推荐 |
+| linux/arm64 | ✅ 完整支持 | ✅ 完整支持 | ✅ 完整支持 | 🟢 推荐 |
+| linux/386 | ✅ 完整支持 | ⚠️ 部分支持 | ✅ 完整支持 | 🟡 可用 |
+| linux/arm/v7 | ✅ 完整支持 | ⚠️ 部分支持 | ✅ 完整支持 | 🟡 可用 |
+| linux/ppc64le | ✅ 完整支持 | ⚠️ 部分支持 | ✅ 完整支持 | 🟡 可用 |
+| linux/s390x | ✅ 完整支持 | ⚠️ 部分支持 | ✅ 完整支持 | 🟡 可用 |
+
+### 迁移指南
+
+#### 从旧版本升级
+
+1. 更新 Dockerfile 以使用新的构建方式
+2. 移除手动编译相关的构建步骤
+3. 使用 Pig 命令管理扩展
+
+#### 使用方法
+
+```bash
+# 构建镜像
+docker build -t riccoxie/postgres-zh .
+
+# 测试构建
+./test-pig-build.sh
+
+# 运行容器
+docker run -d --name postgres-zh -e POSTGRES_PASSWORD=your_password -p 5432:5432 riccoxie/postgres-zh
+```
+
+### 优势总结
+
+- **🎯 简化维护**：统一的 PostgreSQL 环境管理，减少手动配置
+- **🔒 提高可靠性**：自动处理内核和扩展依赖关系，减少构建失败
+- **⚡ 增强灵活性**：支持动态内核和扩展安装更新
+- **🛡️ 更好的错误处理**：智能回退机制，提高构建成功率
+- **📦 标准化管理**：使用业界标准的 Pig 包管理器
+- **🌍 环境统一**：通过 Pig 实现 PostgreSQL 内核和扩展的统一管理
+
+---
+
+## 20250928 - 初始版本
+
+### 🎉 项目创建
+
+- 基于 PostgreSQL 16 的 Docker 镜像
+- 支持中文全文搜索功能
+- 集成 zhparser 中文分词器
+- 多架构支持（7 种 CPU 架构）
+- 预装常用 PostgreSQL 扩展

Dockerfile

@@ -1,69 +1,50 @@
-# 基于官方PostgreSQL 16镜像
-FROM postgres:16
+# 基于 Ubuntu 基础镜像
+FROM ubuntu:24.04
 
-# 切换为root用户执行安装操作
-USER root
+# 设置环境变量
+ENV DEBIAN_FRONTEND=noninteractive
+ENV POSTGRES_VERSION=16
 
-# 安装依赖包
+# 安装基础依赖包
 RUN apt-get update && apt-get install -y --no-install-recommends \
     apt-transport-https \
-    bzip2 \
     ca-certificates \
     curl \
-    gcc \
-    libc6-dev \
-    make \
+    gnupg \
+    lsb-release \
     wget \
-    unzip \
-    cmake \
-    openssl \
-    clang \
-    && rm -rf /var/lib/apt/lists/* \
-    && update-ca-certificates
-
-# 安装 PostgreSQL 开发包（容错安装）
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    libpq-dev \
-    && (apt-get install -y postgresql-server-dev-16 || \
-        apt-get install -y postgresql-server-dev-all || \
-        apt-get install -y postgresql-server-dev || \
-        echo "PostgreSQL server dev packages not available for this architecture") \
+    sudo \
+    systemd \
     && rm -rf /var/lib/apt/lists/*
 
-# 验证 PostgreSQL 开发包是否安装成功
-RUN if [ ! -f "/usr/include/postgresql/16/server/postgres.h" ]; then \
-        echo "PostgreSQL headers not found, trying alternative installation..."; \
-        apt-get update && apt-get install -y --no-install-recommends \
-        postgresql-server-dev-16 || \
-        echo "Failed to install PostgreSQL development headers"; \
-    fi
-
-# 安装SCWS库和zhparser扩展（使用官方发布版本）
-RUN wget -q -O - "http://www.xunsearch.com/scws/down/scws-1.2.3.tar.bz2" | tar xjf - && \
-    ZHPARSER_URL="https://github.com/amutu/zhparser/archive/master.tar.gz" && \
-    curl -sSkLf "${ZHPARSER_URL}" | tar xzf - && \
-    cd scws-1.2.3 && \
-    ./configure && \
-    make -j$(nproc) install V=0 && \
-    ldconfig && \
-    cd /zhparser-master && \
-    # 检查 PostgreSQL 头文件是否存在
-    if [ -f "/usr/include/postgresql/16/server/postgres.h" ]; then \
-        echo "PostgreSQL headers found, proceeding with zhparser compilation..."; \
-        make -j$(nproc) install; \
-    else \
-        echo "PostgreSQL headers not found, skipping zhparser compilation..."; \
-        echo "zhparser will not be available in this build"; \
-    fi && \
-    rm -rf /scws-1.2.3 /zhparser-master
-
-# 注意：pg_jieba 已移除，因为 zhparser 已经提供了完整的中文分词功能
-# 如果需要结巴分词功能，可以单独安装 pg_jieba 扩展
-
-# 安装其他常用扩展包
+# 安装 Pig 包管理器
+RUN curl -fsSL https://repo.pigsty.io/pig | bash
+
+# 配置 Pig 仓库（添加所有必要的仓库）
+RUN pig repo add all -u
+
+# 使用 Pig 安装 PostgreSQL 16 内核
+RUN pig ext install pg16
+
+# 使用 Pig 安装 PostgreSQL 扩展
+RUN pig ext install pg_trgm hstore btree_gist pg_stat_statements unaccent
+
+# 尝试安装中文分词扩展（如果可用）
+RUN pig ext install zhparser || echo "zhparser not available for this architecture, skipping..."
+
+# 安装其他常用扩展
+RUN pig ext install postgresql-contrib || echo "postgresql-contrib not available via pig, using apt..."
+
+# 如果 Pig 无法安装某些扩展，回退到 apt 安装
 RUN apt-get update && apt-get install -y --no-install-recommends \
     postgresql-contrib \
-    && rm -rf /var/lib/apt/lists/*
+    && rm -rf /var/lib/apt/lists/* || echo "Some extensions may not be available for this architecture"
+
+# 创建 postgres 用户和组
+RUN groupadd -r postgres --gid=999 && useradd -r -g postgres --uid=999 postgres
+
+# 创建 PostgreSQL 数据目录
+RUN mkdir -p /var/lib/postgresql/data && chown -R postgres:postgres /var/lib/postgresql
 
 # 复制初始化脚本到容器中
 COPY init-scripts/ /docker-entrypoint-initdb.d/
@@ -72,5 +53,38 @@ COPY init-scripts/ /docker-entrypoint-initdb.d/
 RUN chmod -R 755 /docker-entrypoint-initdb.d/ && \
     chown -R postgres:postgres /docker-entrypoint-initdb.d/
 
+# 设置环境变量
+ENV PGDATA=/var/lib/postgresql/data
+ENV POSTGRES_USER=postgres
+ENV POSTGRES_PASSWORD=postgres
+ENV POSTGRES_DB=postgres
+
+# 暴露端口
+EXPOSE 5432
+
+# 创建启动脚本
+RUN echo '#!/bin/bash\n\
+set -e\n\
+\n\
+# 初始化数据库（如果不存在）\n\
+if [ ! -s "$PGDATA/PG_VERSION" ]; then\n\
+    echo "Initializing database..."\n\
+    su-exec postgres initdb\n\
+    echo "host all all 0.0.0.0/0 md5" >> $PGDATA/pg_hba.conf\n\
+    echo "listen_addresses = '\''*'\''" >> $PGDATA/postgresql.conf\n\
+fi\n\
+\n\
+# 启动 PostgreSQL\n\
+echo "Starting PostgreSQL..."\n\
+su-exec postgres postgres "$@"\n\
+' > /usr/local/bin/docker-entrypoint.sh && chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# 安装 su-exec
+RUN apt-get update && apt-get install -y su-exec && rm -rf /var/lib/apt/lists/*
+
 # 切换回postgres用户
 USER postgres
+
+# 设置启动命令
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
+CMD ["postgres"]

README.md

@@ -18,12 +18,13 @@
 
 ### 🚀 核心功能
 
-- **PostgreSQL 16**: 基于官方 PostgreSQL 16 镜像
+- **PostgreSQL 16**: 基于 Ubuntu 24.04 和 Pig 包管理器
 - **多架构支持**: 支持 7 种不同的 CPU 架构
 - **中文分词支持**: 集成 zhparser 中文分词器
 - **全文搜索**: 支持中文全文搜索和模糊匹配
 - **扩展丰富**: 预装常用 PostgreSQL 扩展
 - **容错构建**: 智能处理不同架构的包兼容性问题
+- **Pig 环境管理**: 使用 Pig 包管理器统一管理 PostgreSQL 内核和扩展
 
 ### 📦 预装扩展
 
@@ -217,14 +218,39 @@ cd docker-postgres-zh
 docker build -t riccoxie/postgres-zh .
 ```
 
+### Pig 包管理器
+
+本镜像使用 [Pig](https://pig.pgsty.com/zh/start/) 作为 PostgreSQL 环境和扩展的包管理器，提供以下优势：
+
+- **统一管理**: 通过 Pig 统一管理 PostgreSQL 内核和所有扩展
+- **多架构支持**: 自动处理不同架构的兼容性
+- **容错安装**: 智能处理安装失败的情况
+- **环境配置**: 自动配置 PostgreSQL 运行环境
+
+#### 扩展管理
+
+```bash
+# 查看已安装的扩展
+docker exec -it postgres-zh pig ext list
+
+# 安装新扩展
+docker exec -it postgres-zh pig ext install <extension_name>
+
+# 更新扩展
+docker exec -it postgres-zh pig ext update <extension_name>
+
+# 查看可用扩展
+docker exec -it postgres-zh pig ext search <extension_name>
+```
+
 ### 本地开发
 
 ```bash
 # 运行开发环境
 docker run -it --rm \
   -e POSTGRES_PASSWORD=dev_password \
   -p 5432:5432 \
-  -v $(pwd)/script:/docker-entrypoint-initdb.d \
+  -v $(pwd)/init-scripts:/docker-entrypoint-initdb.d \
   riccoxie/postgres-zh:v16
 ```
 
@@ -253,7 +279,7 @@ SET pg_trgm.similarity_threshold = 0.3;
 
 ### 功能可用性
 
-不同架构的功能可用性可能有所不同：
+不同架构的功能可用性可能有所不同（基于 Pig 包管理器）：
 
 | 架构 | PostgreSQL | zhparser | 其他扩展 | 状态 |
 |------|------------|----------|----------|------|
@@ -267,8 +293,8 @@ SET pg_trgm.similarity_threshold = 0.3;
 
 ### 说明
 
-- **🟢 推荐**: 完整功能支持，最佳性能
-- **🟡 可用**: 核心功能完整，部分高级功能可能受限
+- **🟢 推荐**: 完整功能支持，最佳性能（Pig 包管理器完全支持）
+- **🟡 可用**: 核心功能完整，部分高级功能可能受限（Pig 包管理器部分支持）
 - **⚠️ 部分支持**: zhparser 在某些架构上可能无法编译，但 PostgreSQL 核心功能完全可用
 
 ## 故障排除

init-scripts/01-extensions.sql

@@ -1,20 +1,48 @@
--- 启用核心扩展
+-- 使用 Pig 包管理器管理的扩展初始化脚本
+-- 此脚本会在 PostgreSQL 启动时自动执行
+
+-- 启用核心扩展（通过 Pig 安装）
 CREATE EXTENSION IF NOT EXISTS pg_trgm;
 CREATE EXTENSION IF NOT EXISTS hstore;
 CREATE EXTENSION IF NOT EXISTS btree_gist;
 CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
 CREATE EXTENSION IF NOT EXISTS unaccent;
 
--- 启用中文分词扩展
-CREATE EXTENSION IF NOT EXISTS zhparser;
+-- 启用中文分词扩展（如果通过 Pig 安装成功）
+-- 使用容错方式处理，避免在某些架构上失败
+DO $$
+BEGIN
+    -- 尝试创建 zhparser 扩展
+    BEGIN
+        CREATE EXTENSION IF NOT EXISTS zhparser;
+        
+        -- 为zhparser创建中文全文搜索配置
+        -- 包含常用的中文词性：名词、动词、形容词、习语、叹词、习用语、简称、时间词
+        IF NOT EXISTS (SELECT 1 FROM pg_ts_config WHERE cfgname = 'chinese_zh') THEN
+            CREATE TEXT SEARCH CONFIGURATION chinese_zh (PARSER = zhparser);
+            ALTER TEXT SEARCH CONFIGURATION chinese_zh ADD MAPPING FOR n,v,a,i,e,l,j,t WITH simple;
+        END IF;
+        
+        RAISE NOTICE 'zhparser extension and chinese_zh configuration created successfully';
+    EXCEPTION
+        WHEN OTHERS THEN
+            RAISE NOTICE 'zhparser extension not available for this architecture: %', SQLERRM;
+    END;
+END $$;
 
--- 为zhparser创建中文全文搜索配置
--- 包含常用的中文词性：名词、动词、形容词、习语、叹词、习用语、简称、时间词
+-- 显示已安装的扩展信息
 DO $$
+DECLARE
+    ext_record RECORD;
 BEGIN
-    IF NOT EXISTS (SELECT 1 FROM pg_ts_config WHERE cfgname = 'chinese_zh') THEN
-        CREATE TEXT SEARCH CONFIGURATION chinese_zh (PARSER = zhparser);
-        ALTER TEXT SEARCH CONFIGURATION chinese_zh ADD MAPPING FOR n,v,a,i,e,l,j,t WITH simple;
-    END IF;
+    RAISE NOTICE '=== PostgreSQL Extensions Status ===';
+    FOR ext_record IN 
+        SELECT extname, extversion 
+        FROM pg_extension 
+        ORDER BY extname
+    LOOP
+        RAISE NOTICE 'Extension: % (version: %)', ext_record.extname, ext_record.extversion;
+    END LOOP;
+    RAISE NOTICE '================================';
 END $$;