balenalib/amd64-alpine-python

⚠️ 已弃用

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

镜像概述

此基础镜像是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链接

https://github.com/balena-io-library/base-images/tree/master/balena-base-images/python/amd64/alpine/

关于镜像及其历史的更多信息，请查看https://github.com/balena-io-library/official-images/blob/master/library/amd64-alpine-python%E3%80%82

使用方法与配置说明

通过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

如遇镜像相关问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%E3%80%82

贡献

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励提交Pull Request，并会尽快处理。代码贡献前，建议通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E4%BB%A5%E4%BE%BF%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%8F%90%E4%BE%9B%E6%96%B9%E5%90%91%E3%80%81%E5%8F%8D%E9%A6%88%E6%88%96%E9%81%BF%E5%85%8D%E9%87%8D%E5%A4%8D%E5%B7%A5%E4%BD%9C%E3%80%82

文档

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

迁移说明

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