balenalib/raspberrypi4-64-ubuntu-python 镜像文档

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，专为raspberrypi4-64架构设计，主要优化用于balena.io平台和balenaOS系统，同时兼容其他支持该架构的Docker环境。它集成了Python运行环境，提供精简的运行时和完整的构建工具变体，适用于在树莓派4（64位）等IoT设备上开发、构建和部署Python应用。

核心功能和特性

便捷的包管理工具

内置install_packages脚本，简化依赖管理：

• 自动适配底层包管理器，无需手动处理不同系统差异
• 安装时优先选择最小依赖集（忽略可选依赖），减少镜像体积
• 安装后自动清理包管理器元数据，进一步优化镜像大小
• 支持安装失败自动重试，提升可靠性

动态设备支持

默认ENTRYPOINT为/usr/bin/entry.sh，实现动态设备识别：

• 通过设置环境变量ENV UDEV=1启用udev支持
• 启用后自动启动udevd守护进程，容器内/dev目录将动态生成设备节点，支持热插拔设备

更多特性详情参见***特性概述

镜像变体

balenalib镜像提供两种主要变体，满足不同开发阶段需求：

:<version> 或 :<version>-run

默认镜像，精简的运行时变体。仅包含运行Python应用所需的核心组件，体积小巧，适合生产环境部署。

:<version>-build

构建环境变体。包含从源代码编译构建所需的各类工具（如编译器、Make等），减少手动安装依赖的工作量，适合开发和构建阶段。

变体差异详情参见***文档

使用场景和适用范围

• balena生态开发：与balena.io平台和balenaOS深度集成，适合通过balena管理的IoT设备项目
• 树莓派4（64位）部署：专为raspberrypi4-64架构优化，可直接部署到树莓派4等64位ARM设备
• 资源受限环境：run变体体积小巧，适合内存和存储资源有限的IoT设备
• 源码构建需求：build变体提供完整构建工具链，适合需要从源码编译Python依赖的场景

支持版本及镜像信息

支持的Python版本

• 2.7.16 (latest)
• 3.7.4
• 3.6.9
• 3.5.7
• 3.4.10

源码及镜像清单

• Dockerfile源码：GitHub仓库
• 镜像清单：official-images仓库

详细使用方法和配置说明

通过Dockerfile构建Python应用

1. 创建Dockerfile

在Python项目根目录创建Dockerfile：

dockerfile
FROM balenalib/raspberrypi4-64-ubuntu-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" ]

2. 构建并运行

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/raspberrypi4-64-ubuntu-python:latest \
  python your-daemon-or-script.py

参数说明：

• -v "$PWD":/usr/src/myapp：将当前目录挂载到容器内/usr/src/myapp
• -w /usr/src/myapp：设置工作目录为挂载目录
• --rm：容器退出后自动删除，避免残留

与Balena平台配合使用

快速入门指南

参考Balena***入门教程，了解如何将该镜像与balena平台结合使用。同时可查看示例项目获取实践参考。

关于Python

Python是一种解释型、交互式、面向对象的开源编程语言，具有简洁的语法和强大的功能。它支持模块、异常处理、动态类型、高级数据结构和类，可通过C/C++扩展，并可在多种操作系统上运行。

更多信息参见***

用户反馈与贡献

问题反馈

如遇使用问题或有疑问，请通过GitHub Issues提交。

贡献指南

欢迎贡献新功能、修复或改进。建议先通过GitHub Issues讨论计划，确保与项目方向一致。

***文档

更多详情参见：

• balena基础镜像文档
• 新特性介绍博客