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 镜像：

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

交互式运行

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

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

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

运行 Python 脚本

挂载本地脚本并执行：

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

作为 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 部署多服务应用：

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

本地构建镜像

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

1. 克隆 Dockershelf 仓库：

   git clone [***]
   cd dockershelf
   

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

   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 中使用多阶段构建减小最终镜像体积。

许可证

Dockershelf Python 镜像包含来自基础发行版（如 Debian）及依赖软件的组件，这些组件可能受不同许可证约束（如 Bash 等）。镜像使用者需自行确保其使用行为符合所有包含软件的许可证要求。

Dockershelf 项目源代码本身采用 GPLv3 许可证。