bamx/python Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Docker镜像文档

1. 镜像概述

本镜像为基于官方Python镜像（[***]

2. 核心功能与特性

2.1 基础特性

• 多版本支持：提供多种Python版本（如3.7、3.8、3.9、3.10、3.11等），满足不同应用的版本需求
• 精简构建：包含slim（精简版）和alpine（极小版）等变体，减少镜像体积
• 预装依赖：内置常用系统依赖和Python工具（如pip、setuptools等）

2.2 兼容性

• 与官方Python镜像API完全兼容，支持官方镜像的所有命令和配置方式
• 支持多架构部署（amd64、arm64等主流架构）

3. 使用场景

3.1 开发环境

• 快速搭建本地Python开发环境，避免系统环境冲突
• 配合IDE或命令行工具进行Python应用开发和调试

3.2 测试环境

• 作为CI/CD流程中的测试环境，确保测试一致性
• 支持多版本Python应用的兼容性测试

3.3 生产部署

• 部署Python Web应用（如Django、Flask项目）
• 运行Python脚本或后台服务
• 作为微服务架构中的Python服务基础镜像

4. 使用方法

4.1 基本使用

4.1.1 交互式运行

启动Python交互式解释器：

bash
docker run -it --rm [镜像名称]:[标签] python

示例（使用Python 3.11版本）：

bash
docker run -it --rm vendored-python:3.11 python

4.1.2 运行Python脚本

运行当前目录下的Python脚本：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像名称]:[标签] python your_script.py

示例：

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

4.2 构建自定义镜像

基于本镜像构建应用镜像（Dockerfile示例）：

dockerfile
FROM [镜像名称]:3.11-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "main.py"]

构建并运行：

bash
docker build -t my-python-app .
docker run -it --rm my-python-app

4.3 环境变量配置

支持官方Python镜像的常用环境变量：

示例（启用无缓冲输出）：

bash
docker run -it --rm -e PYTHONUNBUFFERED=1 vendored-python:3.11 python app.py

4.4 卷挂载

挂载宿主机目录到容器，实现代码热更新：

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

5. 版本标签说明

镜像标签遵循官方Python镜像命名规范，格式为：

[镜像名称]:[python版本]-[变体]

标签示例：

• vendored-python:3.11：Python 3.11 标准版
• vendored-python:3.10-slim：Python 3.10 精简版
• vendored-python:3.9-alpine：Python 3.9 Alpine极小版
• vendored-python:latest：最新稳定Python版本

6. 注意事项

• 生产环境建议使用固定版本标签（如3.11.4-slim），避免因版本更新导致兼容性问题
• alpine变体基于Alpine Linux，部分依赖可能需要额外安装系统库（如musl-dev）
• 敏感信息（如密钥、配置文件）建议通过环境变量或卷挂载方式注入，避免硬编码到镜像中

7. 相关链接

• 官方Python镜像文档：[***]
• Python官方文档：[***]