balenalib/fincm3-debian-python

balenalib/fincm3-debian-python镜像说明

该镜像属于balena.io的IoT设备基础镜像系列，基于Debian系统和Python语言构建。它针对balenaOS环境进行了优化，同时也支持在其他符合架构要求的Docker环境中使用。

核心功能

• 便捷包安装工具：提供install_packages脚本，抽象底层包管理器细节，自动安装指定包（忽略可选依赖）、清理元数据并在安装失败时重试。
• 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，当设置ENV UDEV=1时，会启动udevd守护进程，使容器/dev目录中显示相关设备节点。

镜像变体

balenalib镜像提供多种变体以满足不同场景需求：

• :<version>或:<version>-run：默认镜像，轻量且仅包含运行时必要组件。
• :<version>-build：包含构建源码所需的工具，减少手动安装包的需求，降低镜像整体大小。

使用场景

• IoT设备上Python应用的开发与部署。
• 在balenaOS环境中快速构建和运行Python项目。
• 需要动态设备支持的IoT应用场景。

配置说明

启用UDEV支持

若需容器识别动态插入的设备，需设置环境变量：

dockerfile
ENV UDEV=1

部署示例

创建Dockerfile

在Python项目根目录下创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/fincm3-debian-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脚本

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

Python简介

Python是一种解释型、交互式、面向对象的开源编程语言，具有简洁的语法和强大的功能，支持模块、异常处理、动态类型等特性，可在多种操作系统上运行。

支持版本

该镜像支持以下Python版本：3.10.5（latest）、3.9.13、3.8.13、3.7.13、3.6.15，对应的Dockerfile可在https://github.com/balena-io-library/base-images/tree/master/balena-base-images/python/fincm3/debian/%E6%9F%A5%E7%9C%8B%E3%80%82

用户反馈

问题反馈

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

贡献

欢迎提交新功能、修复或更新，建议先通过GitHub Issue讨论计划，再提交PR。

文档

更多镜像详情请参考https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%E3%80%82