balenalib/jetson-tx2-debian 镜像文档

镜像概述

该镜像为 balena.io 物联网设备基础镜像系列的一部分，专为 IoT 设备优化。其主要用途是作为物联网应用的基础镜像，可与 balena.io 平台和 balenaOS 无缝配合，同时也兼容其他支持相应架构的 Docker 环境。

!balenalogo

核心功能和特性

关键特性

• 便捷的包安装工具：提供 install_packages 脚本，可抽象底层包管理器差异，安装指定软件包时自动最小化依赖（忽略可选依赖），清理包管理器元数据，并在安装失败时自动重试。

• 动态设备支持：默认 ENTRYPOINT 为 ENTRYPOINT ["/usr/bin/entry.sh"]，可通过设置 ENV UDEV=1 启用 udev 支持。启用后，将启动 udevd 守护进程，使容器内 /dev 目录中动态出现相关设备节点。

更多特性详情，请参见 balena 基础镜像特性概述。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体。run 变体设计为精简版本，仅包含运行时必需组件，体积小巧。

:<version>-build

构建变体为较完整的镜像，包含从源代码构建所需的多种工具，减少手动安装依赖的需求，从而降低系统中所有镜像的总体积。

更多变体信息请参见 运行时与构建变体。

适用场景

• 物联网设备应用开发与部署
• 基于 balena.io 平台的嵌入式系统项目
• 需要动态设备接入支持的容器化应用
• 需同时进行应用构建和运行时部署的场景

使用方法

与 Balena 配合使用

如需使用该基础镜像与 balena 平台配合，可参考 入门指南，同时提供 示例项目 供参考。

支持的版本

支持以下版本，对应 Dockerfile 链接请参见 GitHub：

• buster (latest)
• jessie
• stretch
• sid

查看 GitHub 仓库中的完整版本信息

镜像使用步骤

在应用项目中创建 Dockerfile

dockerfile
FROM balenalib/jetson-tx2-debian:latest
# 在此处添加你的应用代码

构建并运行 Docker 镜像

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

用户反馈

问题反馈

如在使用该镜像时遇到问题或有疑问，请通过 GitHub Issue 联系我们。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励在编码前通过 GitHub Issue 讨论计划，以便其他贡献者提供方向指导和设计反馈。

文档

该镜像的详细文档存储在 基础镜像文档 中，包含所有基础镜像（如 node、python、go 专用镜像及更小体积镜像等）的信息。

关于 balenalib 基础镜像新特性的更多详情，可参考 博客文章。