balenalib/surface-pro-6-python

balenalib/surface-pro-6-debian-python 镜像文档

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，专为balenaOS和balena.io平台优化，同时兼容其他Docker环境。基于Debian系统和Python构建，提供简化的包管理和动态设备管理能力，适用于在Surface Pro 6等IoT设备上开发、构建和部署Python应用程序。

核心功能和特性

• install_packages工具：抽象底层包管理器差异，自动以最小依赖安装软件包，清理包管理器元数据，并在安装失败时重试，简化依赖管理流程。
• 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，通过设置ENV UDEV=1环境变量可启动udevd守护进程，使容器能识别并管理动态插入的设备节点。
• 多场景变体：提供运行时精简版和构建工具完整版两种镜像变体，满足不同开发阶段需求。

镜像变体

:<version> 或 :<version>-run

默认镜像变体，采用精简设计，仅包含运行时必需组件，适合生产环境部署。

:<version>-build

包含源码构建所需的多种工具链，减少手动安装依赖步骤，降低整体镜像体积，适用于开发和构建阶段。

什么是Python？

Python是一种解释型、交互式、面向对象的开源编程语言，具备模块化、异常处理、动态类型和高级数据结构等特性。其语法简洁清晰，可与C/C++扩展集成，支持多平台运行，广泛应用于各类软件开发。

更多信息：***-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/surface-pro-6/debian/

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

如何使用此镜像

创建Python应用的Dockerfile

dockerfile
FROM balenalib/surface-pro-6-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脚本

对于简单单文件项目，可直接通过镜像运行脚本：

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

用户反馈

Issues

如遇问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E3%80%82

Contributing

欢迎贡献代码或改进，建议先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%E3%80%82

文档

完整特性说明请参阅balena基础镜像文档。