balenalib/firefly-rk3288-alpine-python

balenalib/firefly-rk3288-alpine-python 镜像文档

镜像概述和主要用途

该镜像属于balena.io IoT设备基础镜像系列，专为物联网设备优化设计。虽然主要针对balena.io平台和balenaOS系统，但也可在任何支持相应架构的Docker环境中使用。它基于Alpine系统，集成了Python运行环境，为物联网应用开发提供轻量、高效的基础。

核心功能和特性

balenalib基础镜像具有以下显著特性：

• 便捷的包安装工具：提供install_packages脚本，抽象了底层包管理器的细节。该工具会以最少依赖安装指定包（忽略可选依赖），清理包管理器元数据，并在安装失败时自动重试。

• 动态设备接入支持：每个balenalib基础镜像默认设置ENTRYPOINT ["/usr/bin/entry.sh"]，通过设置ENV UDEV=1可启用udev支持。当UDEV标志设为true时，将启动udevd守护进程，使容器内的/dev目录能识别动态插入的设备节点。

更多详细特性请查看https://www.balena.io/docs/reference/base-images/base-images/#features-overview。

镜像变体

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

:<version> 或 :<version>-run

这是默认镜像。run变体设计为轻量级，仅包含运行时必要组件，体积最小。

:<version>-build

构建变体是包含更多工具的较重镜像，集成了从源代码构建所需的多种工具，减少Dockerfile中手动安装包的需求，从而减小系统中所有镜像的总体积。

了解更多关于https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub。

使用场景和适用范围

• 物联网设备应用开发和部署
• 需要轻量级Python环境的嵌入式系统
• 基于balena.io平台的项目开发
• 需要动态设备接入支持的应用场景

使用方法和配置说明

与Balena一起使用

参考https://www.balena.io/docs/learn/getting-started/firefly-rk3288/python/?ref=dockerhub了解如何将此基础镜像与balena一起使用，也可查看https://www.balena.io/docs/learn/getting-started/firefly-rk3288/python/#example-projects?ref=dockerhub获取实际应用案例。

什么是Python？

Python是一种解释型、交互式、面向对象的开源编程语言。它包含模块、异常处理、动态类型、高级动态数据类型和类等特性。Python结合了强大的功能和清晰的语法，提供了许多系统调用和库的接口，支持多种窗口系统，并可通过C或C++扩展。它还可用作需要可编程接口的应用程序的扩展语言。Python具有可移植性，可在多种Unix变体、Mac和Windows 2000及更高版本上运行。

***.org/wiki/Python_(programming_language)

支持的版本及对应Dockerfile链接

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

有关此镜像及其历史的更多信息，请查看https://github.com/balena-io-library/official-images/blob/master/library/firefly-rk3288-alpine-python（位于https://github.com/balena-io-library/official-images）。

如何使用此镜像

在Python应用项目中创建Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/firefly-rk3288-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" ]

构建并运行Docker镜像：

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

运行单个Python脚本

对于简单的单文件项目，可直接使用Python镜像运行脚本：

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

用户反馈

问题反馈

如遇到与镜像相关的问题或疑问，请通过https://github.com/balena-io-library/base-images/issues联系我们。

贡献

欢迎贡献新功能、修复或更新（无论大小）。我们非常欢迎拉取请求，并会尽快处理。

在开始编码前，建议通过https://github.com/balena-io-library/base-images/issues讨论您的计划，尤其是较复杂的贡献，这有助于其他贡献者为您提供指导、反馈设计意见，并避免重复工作。

文档

此镜像的文档存储在https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub中。查看完整的基础镜像列表，包括针对node、python、go等的专用镜像以及更小体积的镜像。

有关balenalib基础镜像新特性的更多详细信息，请参阅此https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub。