CorpusOps Docker 镜像文档

1. 镜像概述和主要用途

CorpusOps Docker 镜像集合（corpusops/docker-images）是由 CorpusOps 组织维护的一系列标准化 Docker 镜像，包含多种服务、工具及运行环境的容器化实现。该项目旨在通过预配置、可复用的镜像简化应用部署流程，提供一致的开发、测试和生产环境，降低容器化技术的使用门槛。

2. 核心功能和特性

2.1 多样化镜像覆盖

涵盖基础系统（如 Ubuntu、Alpine 定制版）、数据库（MySQL、PostgreSQL）、Web 服务（Nginx、Apache）、开发工具（Python、Node.js 环境）等多种类型，满足不同场景需求。

2.2 企业级优化

• 安全增强：基于官方镜像加固，移除冗余组件，定期更新以修复 CVEs
• 性能调优：针对生产环境优化资源占用（内存、CPU）和响应速度
• 合规支持：部分镜像符合 GDPR、HIPAA 等合规要求的基础配置

2.3 易用性设计

• 即开即用：内置常用配置，无需复杂初始化步骤
• 灵活定制：支持通过环境变量、配置文件挂载或 Dockerfile 扩展自定义
• 多平台支持：提供 amd64、arm64 等架构镜像，适配云服务器、边缘设备等场景

2.4 持续维护

• 自动化构建流程确保镜像与上游版本同步更新
• 完善的版本控制（语义化版本标签）和变更日志

3. 使用场景和适用范围

3.1 开发环境标准化

为团队提供统一的本地开发环境，避免因依赖差异导致的"在我机器上能运行"问题。

3.2 CI/CD 流水线集成

作为 Jenkins、GitLab CI 等工具的运行环境，确保构建、测试流程一致性。

3.3 生产环境部署

适用于中小规模应用的生产部署，或作为大型系统微服务架构的基础组件。

3.4 教育与演示

快速搭建技术栈演示环境，降低学***和试用新技术的门槛。

3.5 边缘计算场景

轻量级镜像版本可用于资源受限的边缘设备部署。

4. 使用方法和配置说明

4.1 基本使用流程

4.1.1 拉取镜像

从 Docker Hub 拉取指定镜像（以 Nginx 镜像为例）：

docker pull corpusops/nginx:1.25.3  # 指定版本（推荐）
# 或拉取最新版
docker pull corpusops/nginx:latest

4.1.2 运行容器

# 基本运行（映射 80 端口）
docker run -d -p 80:80 --name my-nginx corpusops/nginx:1.25.3

# 挂载自定义配置
docker run -d -p 80:80 \
  -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf \
  -v $(pwd)/html:/usr/share/nginx/html \
  --name my-nginx corpusops/nginx:1.25.3

4.1.3 查看状态与日志

# 查看容器状态
docker ps -f name=my-nginx

# 查看日志
docker logs -f my-nginx

4.2 Docker Compose 部署示例

创建 docker-compose.yml 文件，部署 Nginx + PostgreSQL 应用栈：

version: '3.8'

services:
  web:
    image: corpusops/nginx:1.25.3
    ports:
      - "80:80"
    environment:
      - NGINX_WORKER_PROCESSES=auto
      - LOG_LEVEL=info
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - web-data:/usr/share/nginx/html
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: corpusops/postgres:15.4
    environment:
      - POSTGRES_USER=appuser
      - POSTGRES_PASSWORD=securepass
      - POSTGRES_DB=appdb
      - POSTGRES_INITDB_ARGS=--encoding=UTF8
    volumes:
      - pg-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped

volumes:
  web-data:
  pg-data:

启动服务：

docker-compose up -d

4.3 自定义镜像构建

通过 Dockerfile 扩展基础镜像（以添加自定义工具为例）：

FROM corpusops/python:3.11-slim

# 安装额外依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    git \
    && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 复制应用代码
COPY ./requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

# 运行应用
CMD ["python", "app.py"]

构建并运行：

docker build -t my-custom-python .
docker run -d --name my-app my-custom-python

5. 配置参数和环境变量

5.1 通用环境变量

所有镜像均支持的基础配置：

• TZ: 时区设置（默认：UTC，示例：Asia/Shanghai）
• LOG_LEVEL: 日志级别（可选：debug/info/warn/error，默认：info）
• USER_ID: 运行服务的用户 UID（默认：1000，非 root 用户以增强安全性）

5.2 服务类型专用变量

5.2.1 Web 服务类（Nginx/Apache）

• HTTP_PORT: 监听端口（默认：80）
• HTTPS_PORT: HTTPS 端口（默认：443，需挂载证书）
• SERVER_NAME: 虚拟主机名（默认：localhost）
• MAX_BODY_SIZE: 请求体最大尺寸（默认：10m）

5.2.2 数据库类（PostgreSQL/MySQL）

• DB_USER: 管理员用户名（默认：admin）
• DB_PASSWORD: 管理员密码（必须设置，无默认值）
• DB_NAME: 初始化数据库名（默认：appdb）
• DB_PORT: 监听端口（默认：5432/3306）
• REPLICATION_MODE: 是否启用主从复制（master/slave/off，默认：off）

5.2.3 应用运行时类（Python/Node.js）

• APP_PORT: 应用监听端口（默认：8080）
• WORKERS: 工作进程数（默认：CPU 核心数 × 2 + 1）
• HEALTHCHECK_PATH: 健康检查端点（默认：/health）

6. 注意事项

1. 版本管理：生产环境务必使用具体版本标签（如 1.25.3），避免 latest 标签导致非预期更新。

2. 数据持久化：通过 docker volume 或绑定挂载持久化关键数据（如数据库文件、日志）：

   # 示例：持久化 PostgreSQL 数据
   docker run -v pgdata:/var/lib/postgresql/data corpusops/postgres
   

3. 安全最佳实践：

   • 避免使用 --privileged 选项
   • 限制容器 CPU/内存资源：--memory=1g --cpus=0.5
   • 通过 --read-only 选项启用只读文件系统（需配合临时目录挂载：--tmpfs /tmp）

4. 性能调优：根据应用负载调整资源限制和工作进程数，高并发场景建议使用 Docker Compose 或容器编排工具（Kubernetes）进行扩展。

5. 升级策略：升级前备份数据，新版本镜像建议先在测试环境验证兼容性。

7. 参考资料

• 官方仓库：[***]
• Docker Hub 镜像库：[***]
• 各镜像详细文档：仓库内 docs/ 目录及各子目录 README
• 问题反馈：GitHub Issues