balenalib/odroid-xu4-ubuntu-python

balenalib物联网设备Python基础镜像

镜像概述和主要用途

此镜像为balena.io物联网（IoT）设备基础镜像系列的一部分，专为IoT设备优化，兼容balena.io平台和balenaOS操作系统，同时也可在其他支持相应架构的Docker环境中运行。其设计目标是为IoT应用开发提供精简、高效的基础运行环境，尤其适合需要与硬件设备交互的场景。

核心功能和特性

1. 简化的包管理工具

提供install_packages脚本，抽象了底层包管理器的差异，具备以下特点：

• 安装指定包时仅包含最小依赖（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提高可靠性

2. 动态设备支持

每个基础镜像默认入口点为ENTRYPOINT ["/usr/bin/entry.sh"]，支持动态插入设备：

• 通过设置环境变量ENV UDEV=1启用udevd守护进程
• 当UDEV标志为true时，容器内/dev目录会自动识别并显示相关设备节点

更多特性详情请查看特性概述文档。

镜像变体

:<version> 或 :<version>-run

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

:<version>-build

包含完整构建工具链的变体，预装了从源代码编译所需的各类工具，减少手动安装依赖的工作量，从而降低整体镜像体积。

了解更多变体差异请参考运行时与构建时镜像对比。

与Balena平台配合使用

如需在Balena平台上使用此基础镜像，可参考入门指南，或通过示例项目了解实际应用场景。

Python语言介绍

Python是一种解释型、交互式、面向对象的开源编程语言，具备模块、异常处理、动态类型、高级动态数据类型和类等特性。其语法简洁清晰，同时提供丰富的系统调用、库接口和窗口系统支持，可通过C/C++扩展，具备良好的可移植性，可运行于多种Unix变体、Mac OS和Windows 2000及以上系统。

更多信息请参考***：Python编程语言

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/python/logo.png

支持的版本及Dockerfile链接

• 2.7.16 (latest)、3.7.4、3.6.9、3.5.7、3.4.10
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/python/odroid-xu4/ubuntu/

镜像历史及更多信息可查看https://github.com/balena-io-library/official-images/blob/master/library/odroid-xu4-ubuntu-python%EF%BC%88%60odroid-xu4-ubuntu-python%60%EF%BC%89%EF%BC%8C%E6%88%96%E8%AE%BF%E9%97%AEhttps://github.com/balena-io-library/official-images%E3%80%82

使用方法

创建Python应用的Dockerfile

在Python项目根目录创建Dockerfile：

dockerfile
FROM balenalib/odroid-xu4-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" ]

构建并运行镜像：

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/odroid-xu4-ubuntu-python:latest python your-daemon-or-script.py

用户反馈

Issues

如遇问题或有疑问，请通过https://github.com/balena-io-library/base-images/issues%E5%8F%8D%E9%A6%88%E3%80%82

贡献

欢迎提交新功能、修复或更新（无论大小）。建议在提交代码前，通过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%E6%8C%87%E5%AF%BC%E5%92%8C%E8%AE%BE%E8%AE%A1%E5%8F%8D%E9%A6%88%E3%80%82

文档

镜像文档存储于基础镜像文档。关于balenalib基础镜像的新功能详情，可参考官方博客。