bamx/python

Docker镜像文档

1. 镜像概述

本镜像为基于官方Python镜像（https://hub.docker.com/_/python/%EF%BC%89%E6%9E%84%E5%BB%BA%E7%9A%84%E8%A1%8D%E7%94%9F%E9%95%9C%E5%83%8F%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E7%A8%B3%E5%AE%9A%E3%80%81%E5%8F%AF%E9%9D%A0%E7%9A%84Python%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E3%80%82%E9%95%9C%E5%83%8F%E7%BB%A7%E6%89%BF%E4%BA%86%E5%AE%98%E6%96%B9Python%E9%95%9C%E5%83%8F%E7%9A%84%E6%A0%B8%E5%BF%83%E7%89%B9%E6%80%A7%EF%BC%8C%E5%8F%AF%E4%BD%9C%E4%B8%BAPython%E5%BA%94%E7%94%A8%E5%BC%80%E5%8F%91%E3%80%81%E6%B5%8B%E8%AF%95%E5%8F%8A%E7%94%9F%E4%BA%A7%E9%83%A8%E7%BD%B2%E7%9A%84%E5%9F%BA%E7%A1%80%E7%8E%AF%E5%A2%83%E3%80%82

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镜像文档：https://hub.docker.com/_/python/
• Python官方文档：[***]