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

⚠️ 已弃用

此基础镜像已弃用，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

镜像概述

此基础镜像是balena.io IoT设备基础镜像系列的一部分。该镜像针对balena.io平台和balenaOS进行了优化，同时也可在任何运行适当架构的Docker环境中使用。

!balenalogo

核心功能与特性

balenalib基础镜像包含以下主要特性：

• 简化的包安装工具：提供install_packages脚本，抽象底层包管理器差异，可安装指定软件包并仅保留最小依赖（忽略可选依赖），自动清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：每个balenalib基础镜像的默认ENTRYPOINT为ENTRYPOINT ["/usr/bin/entry.sh"]。该脚本会检查UDEV环境变量是否设置为true（通过ENV UDEV=1配置），若启用则启动udevd守护进程，使容器内/dev目录下的设备节点可动态识别。

更多特性详情请参考官方文档中的特性概述。

使用场景与适用范围

• IoT设备上的Python应用开发与部署，尤其是基于balena.io平台或balenaOS的场景。
• 需要动态识别外接硬件设备（如传感器、USB设备）的Python应用。
• 需分离构建环境与运行环境以减小镜像体积的Python项目（利用-build和-run变体）。

镜像变体

balenalib镜像提供多种变体，适用于不同场景：

:<version> 或 :<version>-run

默认镜像变体。run变体设计为精简版本，仅包含运行时必需组件，适合直接部署应用。

:<version>-build

构建环境变体，包含大量源码构建所需工具，可减少Dockerfile中手动安装的包数量，从而降低系统中所有镜像的总体积。

更多变体说明请参考官方文档。

支持的版本及Dockerfile链接

3.11.2 (latest)、3.10.10、3.9.16、3.8.16

关于镜像及其历史的更多信息，请查看balena-io-library/official-images GitHub仓库中的相关清单文件（amd64-alpine-python）。

使用方法与配置说明

通过Dockerfile构建应用

在Python项目中创建Dockerfile：

dockerfile
FROM balenalib/amd64-alpine-python:latest

WORKDIR /usr/src/app

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

COPY . .

CMD [ "python", "./your-daemon-or-script.py" ]

构建并运行镜像：

console
$ docker build -t my-python-app .
$ docker run -it --rm --name my-running-app my-python-app

运行单个Python脚本

对于简单的单文件项目，可直接使用镜像运行脚本，无需编写完整Dockerfile：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/amd64-alpine-python:latest python your-daemon-or-script.py

用户反馈

Issues

如遇镜像相关问题或疑问，请通过GitHub Issue联系我们。

贡献

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励提交Pull Request，并会尽快处理。代码贡献前，建议通过GitHub Issue讨论计划，以便其他贡献者提供方向、反馈或避免重复工作。

文档

镜像文档存储在基础镜像文档中。更多balenalib基础镜像（如node、go、精简版等）的信息可在此查阅。balenalib基础镜像新特性详情请参考此博客文章。

迁移说明

由于此镜像已弃用，请参考公告文章中的迁移指南选择替代方案。