eidolons/python

Python Docker镜像文档

镜像概述

Python Docker镜像提供官方维护的Python运行环境，基于轻量级Linux发行版构建，包含Python解释器及相关工具，可快速部署Python应用程序，无需手动配置系统环境。

核心功能与特性

• 解释型执行：支持直接运行Python代码，无需编译过程
• 交互式环境：提供Python交互式shell，便于代码测试和调试
• 面向对象支持：完全支持面向对象编程范式，包括类、继承、多态等特性
• 开源生态：集成Python丰富的标准库和第三方包管理工具（pip）
• 多版本支持：提供多个Python版本（如3.8、3.9、3.10等）的镜像标签，满足不同项目需求

使用场景与适用范围

• Web开发：部署基于Django、Flask等框架的Web应用
• 数据分析：运行包含NumPy、Pandas等库的数据分析脚本
• 人工智能/机器学习：支持TensorFlow、PyTorch等框架的模型训练与推理
• 自动化脚本：执行系统管理、数据处理等自动化任务
• 教学与学习：提供一致的Python学习环境，避免环境配置问题

使用方法与配置说明

基本使用

1. 交互式Python shell

通过以下命令启动Python交互式环境：

bash
docker run -it --rm python:latest python

• -it：启用交互式终端
• --rm：容器退出后自动删除
• python:latest：使用最新版Python镜像
• python：容器内执行的命令，启动Python解释器

2. 运行Python脚本

假设本地有app.py脚本，可通过以下命令运行：

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

• -v $(pwd):/app：将当前目录挂载到容器内的/app目录
• -w /app：设置工作目录为/app

版本选择

指定特定Python版本（如3.11）：

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

环境变量配置

常用环境变量：

• PYTHONUNBUFFERED：设置为1可禁用标准输出缓冲，适用于日志实时输出
• PYTHONPATH：指定Python模块搜索路径
• PIP_DISABLE_PIP_VERSION_CHECK：设置为1可禁用pip版本检查

示例：

bash
docker run -it --rm -e PYTHONUNBUFFERED=1 python:latest python

Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  python-app:
    image: python:3.11
    volumes:
      - ./app:/app
    working_dir: /app
    command: python app.py
    environment:
      - PYTHONUNBUFFERED=1
      - PYTHONPATH=/app/lib

启动服务：

bash
docker-compose up

注意事项

• 生产环境建议使用特定版本标签（如python:3.11-slim）而非latest，确保环境一致性
• 对于依赖系统库的Python包（如psycopg2），可能需要使用包含更多系统工具的镜像变体（如python:3.11-buster）
• 敏感信息（如API密钥）应通过环境变量或secrets管理，避免硬编码在镜像中