thingsolver/solver-base

镜像概述

该镜像定位为所有Python微服务的基础镜像，旨在为各类Python微服务提供统一、标准化的运行环境。通过封装基础系统依赖和Python运行时环境，减少微服务开发中的环境配置差异，提升开发效率和部署一致性。

核心功能与特性

标准化运行环境

• 内置稳定的Python版本（如Python 3.9/3.10等，具体版本可通过镜像标签指定），确保微服务运行时环境一致性。
• 预安装基础系统依赖（如libssl、curl、ca-certificates等），满足多数Python微服务的基础运行需求。

微服务友好设计

• 精简镜像体积，基于轻量级基础镜像（如Alpine或Debian Slim）构建，减少部署资源占用。
• 支持多阶段构建，可作为构建阶段和运行阶段的基础，优化最终镜像大小。

简化依赖管理

• 提供基础Python依赖管理工具（如pip、pipenv或poetry），便于微服务添加自定义依赖。

使用场景

• Python微服务开发：作为各类Python微服务（如REST API服务、数据处理服务、消息队列消费者、定时任务服务等）的基础镜像，统一开发与部署标准。
• 微服务标准化：在团队或组织内推广使用，确保所有Python微服务基于相同的基础环境构建，降低跨服务协作的环境兼容性问题。
• 快速原型验证：用于快速搭建Python微服务原型，减少基础环境配置时间。

使用方法

基本使用（Dockerfile）

在微服务的Dockerfile中，通过FROM指令将该镜像作为基础镜像：

dockerfile
# 以该镜像为基础构建微服务
FROM docker.xuanyuan.run/[镜像名称]:[标签]  # 标签通常指定Python版本，如3.10-slim

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 启动命令（根据微服务类型调整）
CMD ["python", "main.py"]

镜像标签说明

镜像标签通常包含Python版本和基础系统类型，例如：

• 3.9-slim：基于Debian Slim，Python 3.9
• 3.10-alpine：基于Alpine Linux，Python 3.10（体积更小，适合资源受限场景）

具体标签需参考镜像仓库的标签列表，选择与微服务需求匹配的版本。

扩展配置

如需添加自定义系统依赖或环境变量，可在Dockerfile中扩展：

dockerfile
FROM docker.xuanyuan.run/[镜像名称]:3.10-slim

# 添加额外系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    && rm -rf /var/lib/apt/lists/*

# 设置环境变量
ENV PYTHONUNBUFFERED=1 \
    PYTHONDONTWRITEBYTECODE=1

# 后续构建步骤...

注意事项

• 该镜像仅作为基础依赖，微服务的业务逻辑代码和自定义依赖需通过Dockerfile进一步添加。
• 选择镜像标签时，建议匹配微服务所需的Python版本及系统环境（如Alpine适合轻量场景，Debian适合需要更多系统库的场景）。
• 构建微服务镜像时，推荐使用多阶段构建，以进一步减小最终镜像体积：

dockerfile
# 构建阶段
FROM [镜像名称]:3.10-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip wheel --no-cache-dir --wheel-dir /app/wheels -r requirements.txt

# 运行阶段
FROM [镜像名称]:3.10-slim
WORKDIR /app
COPY --from=builder /app/wheels /wheels
RUN pip install --no-cache /wheels/*
COPY . .
CMD ["python", "main.py"]