corpusops Docker镜像集合

1. 镜像概述和主要用途

概述

corpusops Docker镜像集合是由corpusops组织维护的一系列Docker镜像，旨在提供经过优化、安全加固且易于集成的容器化解决方案。该集合包含基础系统镜像、编程语言运行时、中间件及特定应用镜像，覆盖从开发环境到生产部署的全流程容器化需求。

主要用途

• 作为应用开发、测试和生产环境的标准化基础载体
• 提供安全增强的容器运行时，降低基础设施层安全风险
• 支持多架构部署，适配x86_64、ARM等主流硬件平台
• 简化CI/CD流水线中的环境一致性管理

2. 核心功能和特性

2.1 镜像优化

• 基于***镜像精简构建，移除冗余依赖，降低镜像体积
• 采用多阶段构建技术，分离构建环境与运行环境
• 定期更新基础层，集成最新安全补丁

2.2 安全增强

• 默认启用非root用户运行模式
• 集成AppArmor/SELinux配置模板
• 镜像构建过程中执行漏洞扫描（Trivy/Clair）

2.3 易用性设计

• 统一的环境变量配置接口
• 标准化日志输出格式（JSON/Plaintext可选）
• 内置健康检查和优雅关闭机制

2.4 架构支持

• 原生支持amd64、arm64架构
• 部分镜像提供ppc64le、s390x架构构建版本

3. 使用场景和适用范围

3.1 典型使用场景

• 开发环境：为开发团队提供一致的本地容器环境，消除"环境不一致"问题
• CI/CD流水线：作为自动化构建、测试、部署的标准化执行环境
• 微服务架构：为微服务应用提供轻量级运行时载体
• 边缘计算：针对资源受限环境优化的轻量级镜像版本

3.2 适用范围

• 开发人员：本地开发环境配置、应用容器化测试
• 运维团队：生产环境容器部署、基础设施自动化
• DevOps工程师：CI/CD流程设计、容器编排系统集成
• 企业IT部门：标准化容器基础设施建设

4. 使用方法和配置说明

4.1 镜像获取

4.1.1 镜像命名规范

corpusops/<镜像类型>/<具体镜像名>:<版本标签>

示例：corpusops/python/python:3.11-slim、corpusops/nginx/nginx:1.23-alpine

4.1.2 拉取方式

通过Docker Hub或GitHub Container Registry获取：

bash
# Docker Hub
docker pull corpusops/python/python:3.11-slim

# GitHub Container Registry
docker pull ghcr.io/corpusops/python/python:3.11-slim

4.2 基础使用示例

4.2.1 单容器运行（docker run）

以Python应用镜像为例：

bash
docker run -d \
  --name python-app \
  -p 8000:8000 \
  -e "APP_ENV=production" \
  -e "LOG_LEVEL=INFO" \
  -v ./app:/app \
  --health-cmd "curl -f http://localhost:8000/health || exit 1" \
  --health-interval 30s \
  corpusops/python/python:3.11-slim \
  python /app/main.py

4.2.2 多容器编排（docker-compose）

创建docker-compose.yml：

yaml
version: '3.9'

services:
  web:
    image: corpusops/nginx/nginx:1.23-alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
      - static_data:/var/www/html
    depends_on:
      - api
    restart: unless-stopped

  api:
    image: corpusops/python/python:3.11-slim
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/appdb
      - WORKERS=4
    volumes:
      - ./api:/app
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: corpusops/postgres/postgres:14-alpine
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=appdb
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  static_data:
  postgres_data:

启动服务：

bash
docker-compose up -d

4.3 配置参数说明

4.3.1 通用环境变量

4.3.2 卷挂载建议

4.3.3 健康检查配置

各镜像内置默认健康检查命令，可通过--health-cmd覆盖：

bash
# 示例：自定义HTTP健康检查
docker run --health-cmd "wget --no-verbose --tries=1 --spider http://localhost/health || exit 1" corpusops/app:latest

5. 扩展使用

5.1 自定义构建

如需基于现有镜像修改，可通过Dockerfile扩展：

dockerfile
FROM corpusops/python/python:3.11-slim

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

# 添加应用代码
COPY ./requirements.txt /app/
RUN pip install --no-cache-dir -r /app/requirements.txt

# 重写启动命令
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "app:create_app()"]

5.2 镜像验证

可通过以下方式验证镜像完整性：

bash
# 查看镜像元数据
docker inspect corpusops/python/python:3.11-slim

# 验证签名（如启用）
docker trust inspect --pretty corpusops/python/python:3.11-slim

6. 参考资源

• GitHub仓库：[]
• 各镜像详细文档：仓库内对应镜像目录下的README.md
• 问题反馈：GitHub Issues
• 贡献指南：CONTRIBUTING.md