Dockershelf Python 镜像文档

镜像概述和主要用途

Dockershelf Python 镜像是 Dockershelf 项目提供的 Python 语言专用 Docker 镜像，旨在为 Python 应用开发与部署提供测试驱动、轻量级且可靠的基础环境。该镜像基于 Debian 稳定版构建，每周通过自动化流程重建，确保包含最新安全补丁和依赖更新。支持多种 Python 版本及主流硬件架构，适用于从开发测试到生产部署的全流程场景。

核心功能和特性

测试驱动与可靠性

基于严格的自动化测试流程构建，确保镜像功能完整性和运行稳定性。
每周通过 GitHub Actions 工作流自动重建，及时集成基础系统和 Python 依赖的安全更新。

轻量级与高效

采用精简设计，移除不必要依赖，最小化镜像体积，提升部署和运行效率。
基于 Debian 稳定版（如 Bookworm）构建，平衡稳定性与资源占用。

多架构支持

提供 amd64 和 arm64 架构镜像，覆盖 x86_64 服务器、ARM 开发板（如 Raspberry Pi）等主流设备。

版本管理

支持多种 Python 版本（如 3.11、3.12 等），通过标签明确区分（如 dockershelf/python:3.11）。
仅提供稳定版本（无 unstable 分支），适合生产环境对版本稳定性的要求。

使用场景和适用范围

开发环境

快速搭建标准化 Python 开发环境，避免本地环境配置差异。
支持多版本 Python 并行测试，验证应用在不同版本下的兼容性。

生产部署

作为 Python 应用的基础镜像，构建可靠的生产环境容器，确保运行稳定性。
适合需要定期更新安全补丁的长期运行服务。

跨架构应用

在 ARM64 设备（如云服务器、边缘设备）上部署 Python 应用，无需额外适配。

详细的使用方法和配置说明

从 Docker Hub 获取并运行

拉取镜像

通过 Docker Hub 拉取指定版本的 Python 镜像：

bash
docker pull dockershelf/python:3.11  # 拉取 Python 3.11 版本

交互式运行

启动容器并进入交互式终端：

bash
docker run -it --rm dockershelf/python:3.11 bash

--rm 选项确保容器退出后自动清理，避免残留资源。

运行 Python 脚本

挂载本地脚本并执行：

bash
docker run -it --rm -v $(pwd):/app dockershelf/python:3.11 python /app/script.py

作为 Dockerfile 基础镜像

在 Dockerfile 中使用该镜像构建自定义应用：

dockerfile
# 基于 Python 3.11 版本构建
FROM dockershelf/python:3.11

# 设置工作目录
WORKDIR /app

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

# 复制应用代码
COPY . .

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

Docker Compose 配置示例

创建 docker-compose.yml 部署多服务应用：

yaml
version: '3'
services:
  app:
    build: .
    image: dockershelf/python:3.11
    volumes:
      - ./app:/app
    command: python /app/main.py
    ports:
      - "8000:8000"

本地构建镜像

如需自定义构建，可通过以下步骤从源码构建：

克隆 Dockershelf 仓库：

bash
git clone [***]
cd dockershelf

运行构建脚本（需确保 Docker 已安装且当前用户有权限执行 docker build）：

bash
bash build-image.sh dockershelf/python:3.11-bookworm  # 构建 Python 3.11 (基于 Debian Bookworm)

配置说明

环境变量：镜像未定义特定环境变量，可根据需求在运行时通过 -e 参数添加（如 docker run -e PYTHONPATH=/app ...）。
依赖管理：可通过 pip 或 apt-get（基于 Debian）安装额外依赖，建议在 Dockerfile 中使用多阶段构建减小最终镜像体积。