balenalib/kitra710-debian-python

balenalib/kitra710-debian-python 镜像说明

镜像概述

本镜像属于balena.io的IoT设备基础镜像系列，针对Kitra710设备优化，基于Debian系统并集成Python环境。它可在balenaOS或任何支持对应架构的Docker环境中使用，旨在简化IoT应用的开发与部署流程。

核心功能

1. 便捷的包安装工具：内置install_packages脚本，抽象底层包管理器差异，自动安装最小依赖包、清理元数据并支持重试。
2. 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，设置ENV UDEV=1时可启动udevd守护进程，自动识别容器内的设备节点。
3. 多变体支持：
   • :<version>或:<version>-run：轻量运行时变体，仅包含必要依赖。
   • :<version>-build：包含源码编译工具的重型变体，减少手动安装步骤。

使用场景

• 开发基于Python的IoT应用（如传感器数据采集、设备控制）。
• 在Kitra710设备上快速部署Python脚本。
• 构建需要从源码编译的IoT项目（使用build变体）。

配置说明

编写Dockerfile

在Python应用项目中创建Dockerfile：

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

无需编写Dockerfile，直接运行脚本：

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

在balena平台使用

参考https://www.balena.io/docs/learn/getting-started/kitra710/python/?ref=dockerhub%E5%92%8Chttps://www.balena.io/docs/learn/getting-started/kitra710/python/#example-projects?ref=dockerhub%EF%BC%8C%E5%8F%AF%E5%BF%AB%E9%80%9F%E5%9C%A8balenaOS%E4%B8%8A%E9%83%A8%E7%BD%B2%E5%BA%94%E7%94%A8%E3%80%82

用户反馈

• 问题反馈：通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82
• 贡献：欢迎提交PR，建议先通过Issue讨论计划。
• 文档：更多细节见https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%E3%80%82