fittin/base_image

Python 3.9 Slim Buster 镜像文档

镜像概述

本镜像基于官方python:3.9-slim-buster构建，是一个轻量级Python运行环境。它以Debian Buster为基础系统，通过移除非必要依赖和工具，在保留Python 3.9核心功能的同时显著减小镜像体积，适合对资源占用敏感的场景。

核心功能与特性

• Python 3.9环境：内置Python 3.9解释器及标准库，支持Python 3.9语法特性（如类型提示增强、字典合并运算符等）
• 精简体积：基于slim版本构建，相比完整版镜像体积减少约60%，启动速度更快，资源占用更低
• Debian基础：依托Debian Buster稳定系统，提供基础工具链和系统库，确保运行兼容性
• 包管理支持：内置pip包管理器，可直接安装Python依赖包

使用场景

• 轻量级Python应用开发与测试环境
• 生产环境中资源受限的Python服务部署（如微服务、API服务）
• CI/CD流程中的Python应用构建与自动化测试
• 小型Python脚本运行和快速原型验证

使用方法

基本交互模式

启动交互式Python shell：

bash
docker run -it --rm docker.xuanyuan.run/python:3.9-slim-buster python

运行本地Python脚本

将当前目录下的脚本挂载到容器中执行：

bash
docker run -it --rm -v $(pwd):/app -w /app docker.xuanyuan.run/python:3.9-slim-buster python your_script.py

安装依赖包

在容器内安装Python依赖（以requests库为例）：

bash
docker run -it --rm docker.xuanyuan.run/python:3.9-slim-buster pip install requests

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  python-service:
    image: docker.xuanyuan.run/python:3.9-slim-buster
    volumes:
      - ./src:/app  # 挂载本地代码目录
    working_dir: /app
    command: python main.py  # 运行应用入口脚本
    environment:
      - PYTHONUNBUFFERED=1  # 确保日志实时输出

启动服务：

bash
docker-compose up

注意事项

• 镜像不包含编译工具链（如gcc），如需安装需编译的Python包（如psycopg2），需先通过apt-get安装构建依赖：

  bash
  docker run -it --rm docker.xuanyuan.run/python:3.9-slim-buster bash -c "apt-get update && apt-get install -y gcc"
  

• 生产环境建议使用非root用户运行容器，可通过--user参数指定用户
• 定期更新镜像以获取安全补丁和依赖更新