iron/python

Iron.io Python 微容器镜像文档

1. 镜像概述

Iron.io Python微容器镜像是一个极小化的Python运行环境容器，专为资源效率和快速部署设计。该镜像基于轻量级基础镜像（如Alpine Linux）构建，通过精简非必要组件实现最小镜像体积，同时保留Python核心运行能力，适合在资源受限环境或对部署速度有要求的场景中使用。

2. 核心功能与特性

• 超小镜像体积：通过精简系统库和依赖，镜像体积远小于官方Python标准镜像，降低存储和网络传输成本。
• 精简运行环境：仅包含Python解释器及核心标准库，减少***面并提升运行安全性。
• 快速启动性能：极小化的镜像内容显著缩短容器启动时间，提升服务响应速度。
• 资源高效利用：低内存占用和磁盘空间需求，适合边缘设备、嵌入式系统等资源受限环境。
• 兼容性保障：支持标准Python语法及核心库，确保常规Python应用可直接运行。

3. 使用场景

3.1 微服务部署

作为轻量级Python微服务的基础镜像，适用于构建分布式系统中的小型功能模块，降低整体集群资源消耗。

3.2 边缘计算应用

在网络带宽有限或硬件资源受限的边缘节点（如IoT设备、边缘服务器）部署Python应用，减少数据传输量和本地资源占用。

3.3 Serverless函数运行时

作为Serverless平台（如IronFunctions）的Python函数执行环境，通过小体积特性缩短冷启动时间，提升函数执行效率。

3.4 CI/CD流水线

在持续集成/部署流程中作为轻量级Python环境，用于脚本执行、依赖检查或单元测试，加速流水线执行速度。

4. 使用方法

4.1 基本运行

通过以下命令快速启动Python交互模式：

bash
docker run --rm -it docker.xuanyuan.run/iron/python python

执行单行Python代码：

bash
docker run --rm docker.xuanyuan.run/iron/python python -c "import sys; print(f'Python version: {sys.version}')"

4.2 运行本地脚本

挂载本地目录并执行Python脚本：

bash
# 假设当前目录下有脚本文件 script.py
docker run --rm -v $(pwd):/app docker.xuanyuan.run/iron/python python /app/script.py

4.3 安装额外依赖

如需添加第三方依赖，可通过pip在运行时或构建自定义镜像时安装：

运行时安装（临时依赖）：

bash
docker run --rm -v $(pwd):/app docker.xuanyuan.run/iron/python sh -c "pip install requests && python /app/script.py"

构建自定义镜像（持久依赖）： 创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/iron/python
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "app.py"]

构建并运行：

bash
docker build -t my-python-app .
docker run --rm docker.xuanyuan.run/my-python-app

5. 配置参数说明

5.1 支持的Python版本

镜像标签对应不同Python版本，如：

• iron/python:3.9 - Python 3.9版本
• iron/python:3.10 - Python 3.10版本
• iron/python:latest - 最新稳定Python版本

5.2 环境变量

5.3 基础镜像信息

• 底层系统：Alpine Linux（轻量级Linux发行版）
• 镜像体积：通常小于50MB（具体依Python版本略有差异）
• 内置工具：包含pip包管理器，支持标准Python包安装

6. 注意事项

• 该镜像为精简版本，不包含部分系统库（如libssl完整版本），如需依赖特定系统库，需基于此镜像构建自定义镜像并添加相关依赖。
• 生产环境中建议指定具体Python版本标签（如3.10），避免因latest标签自动更新导致兼容性问题。
• 对于需要复杂系统依赖的应用（如科学计算、GUI应用），建议使用官方Python镜像或其他完整版本镜像。