balenalib/generic-aarch64-alpine-python

balenalib/generic-aarch64-alpine-python 镜像文档（已弃用）

⚠️ 弃用警告

该基础镜像已弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E6%8E%A8%E8%8D%90%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述与主要用途

本镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为嵌入式环境优化，主要适用于 https://balena.io/?ref=dockerhub 平台和 https://www.balena.io/os/?ref=dockerhub 系统。尽管针对 balena 生态优化，其亦可在支持 generic-aarch64 架构的任何 Docker 环境中运行。

核心功能与特性

1. 简化的包管理工具 install_packages

• 功能：抽象底层包管理器差异，统一包安装流程
• 特性：
  • 自动选择最小依赖集（忽略可选依赖）
  • 安装后自动清理包管理器元数据，减少镜像体积
  • 支持安装失败自动重试机制

2. 动态设备管理支持

• 默认入口点：ENTRYPOINT ["/usr/bin/entry.sh"]
• UDEV 设备发现：通过设置环境变量 UDEV=1 启用，启动 udevd 守护进程，使动态插入的设备节点自动出现在容器 /dev 目录中，适用于需要访问外设的 IoT 场景。

更多特性详情请参考 https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

镜像变体

:<version> 或 :<version>-run（默认变体）

• 定位：精简运行时镜像
• 特点：仅包含应用运行必需的依赖，体积小巧，适合生产环境部署。

:<version>-build

• 定位：构建环境镜像
• 特点：包含完整的源码构建工具链，减少手动安装依赖的需求，降低多阶段构建中的整体镜像体积。

https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

关于 Python

Python 是一种解释型、交互式、面向对象的开源编程语言，具备模块、异常处理、动态类型、高级动态数据类型和类等特性。其语法简洁清晰，同时提供丰富的系统调用、库接口和窗口系统集成，支持 C/C++ 扩展，可移植性强。

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

支持版本及 Dockerfile 链接

• 3.11.2 (latest)、3.10.10、3.9.16、3.8.16
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/python/generic-aarch64/alpine/

镜像历史及详细信息可参考 https://github.com/balena-io-library/official-images/blob/master/library/generic-aarch64-alpine-python%E3%80%82

使用场景与适用范围

• IoT 设备上的 Python 应用开发与部署
• 嵌入式系统中轻量级 Python 服务运行
• 需要动态管理外设的边缘计算场景
• 基于 balenaOS 的 ARM64 架构设备应用开发

使用方法与配置说明

方法一：创建 Dockerfile 部署 Python 应用

1. 编写 Dockerfile

在 Python 项目根目录创建 Dockerfile：

dockerfile
FROM balenalib/generic-aarch64-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"]

2. 构建并运行镜像

bash
# 构建镜像
docker build -t my-python-app .

# 运行容器
docker run -it --rm --name my-running-app my-python-app

方法二：直接运行单个 Python 脚本

对于简单的单文件项目，可直接挂载脚本目录运行：

bash
docker run -it --rm \
  --name my-running-script \
  -v "$PWD":/usr/src/myapp \
  -w /usr/src/myapp \
  balenalib/generic-aarch64-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
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub