balenalib/orbitty-tx2-golang

balenalib/orbitty-tx2-debian-golang 镜像文档

1. 镜像概述与主要用途

本镜像属于 https://balena.io/ 物联网设备基础镜像系列，专为 IoT 场景优化，适用于 https://balena.io/ 平台和 https://www.balena.io/os/ 系统，同时也支持在其他兼容架构的 Docker 环境中运行。其核心定位是为基于 Go 语言开发的 IoT 应用提供轻量、高效的运行时与构建环境。

2. 核心功能与特性

2.1 便捷的包管理工具 install_packages

内置 install_packages 脚本，抽象了底层包管理器的差异，具备以下特性：

• 自动安装指定软件包，仅包含必要依赖（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提升稳定性

2.2 动态设备支持（UDEV）

默认入口点为 ENTRYPOINT ["/usr/bin/entry.sh"]，通过环境变量控制设备节点管理：

• 设置 ENV UDEV=1 时，自动启动 udevd 守护进程
• 动态识别并创建容器内 /dev 目录下的设备节点，支持热插拔设备

更多特性详情参见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview

3. 镜像变体与适用场景

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

• 定位：精简运行时镜像
• 特性：仅包含运行时必要组件，体积最小化
• 适用场景：生产环境部署、应用运行时环境

3.2 :<version>-build

• 定位：构建环境镜像
• 特性：包含源码构建所需的工具链（编译器、链接器等）
• 适用场景：应用编译、依赖安装、源码构建阶段

镜像变体详细说明参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build

4. 快速使用指南

4.1 基本使用（Dockerfile 示例）

创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/orbitty-tx2-debian-golang:latest

WORKDIR /go/src/app
COPY . .

# 安装依赖
RUN go get -d -v ./...
# 编译应用
RUN go install -v ./...

# 运行应用
CMD ["app"]

构建并运行镜像：

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

# 运行容器
docker run -it --rm --name my-running-app docker.xuanyuan.run/my-golang-app

4.2 仅编译应用（不运行）

在容器内编译本地项目，输出可执行文件到宿主机：

bash
docker run --rm \
  -v "$PWD":/usr/src/myapp \
  -w /usr/src/myapp \
  docker.xuanyuan.run/balenalib/orbitty-tx2-debian-golang:latest \
  go build -v

• -v "$PWD":/usr/src/myapp：挂载当前目录到容器内工作目录
• -w /usr/src/myapp：设置容器工作目录
• go build -v：编译当前目录项目，输出可执行文件到当前目录

4.3 与 Balena 平台配合使用

• https://www.balena.io/docs/learn/getting-started/orbitty-tx2/go/：基于 orbitty-tx2 设备的 Go 应用开发流程
• https://www.balena.io/docs/learn/getting-started/orbitty-tx2/go/#example-projects：参考 Balena 官方 Go 应用示例

5. 支持的版本与架构

5.1 支持的 Go 版本

• 1.12.9（latest）
• 1.11.13
• 1.10.8

版本对应的 Dockerfile 源码参见 https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/orbitty-tx2/debian/

5.2 架构支持

专为 orbitty-tx2 架构优化，兼容基于该架构的 balenaOS 设备及其他 Docker 环境。

6. 高级配置

6.1 UDEV 配置

启用动态设备管理：

dockerfile
FROM docker.xuanyuan.run/balenalib/orbitty-tx2-debian-golang:latest
ENV UDEV=1  # 启用 udevd 守护进程

7. 用户反馈与支持

7.1 问题反馈

通过 https://github.com/balena-io-library/base-images/issues 提交 bug 报告或功能请求。

7.2 贡献指南

欢迎提交 PR 贡献代码，建议先通过 https://github.com/balena-io-library/base-images/issues 讨论重大变更，确保与项目方向一致。

7.3 文档资源

• https://www.balena.io/docs/reference/base-images/base-images/
• https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build
• https://www.balena.io/blog/new-year-new-balena-base-images/