balenalib/fincm3-ubuntu-golang

balenalib/fincm3-ubuntu-golang镜像说明

镜像概述

本镜像属于balena.io的IoT设备基础镜像系列，基于Ubuntu系统构建并集成Go语言环境。它针对balenaOS和通用Docker环境进行了优化，可用于IoT设备上Go应用的开发、编译与运行。

核心功能

1. 简化包安装：提供install_packages脚本，抽象底层包管理器差异，自动处理依赖、清理元数据并支持重试。
2. 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，设置ENV UDEV=1可启动udevd守护进程，自动识别容器内的设备节点。 3.** 多变体支持**：
   • :<version>或:<version>-run：轻量运行时变体，仅包含必要的运行依赖。
   • :<version>-build：包含编译工具的重型变体，减少手动安装包的需求。

使用场景

• IoT设备上Go应用的开发与部署。
• 在balena平台上构建和运行Go项目。
• 利用Docker容器编译Go应用（无需本地安装Go环境）。

配置说明

启用UDEV支持

在Dockerfile中添加环境变量以启用动态设备识别：

dockerfile
ENV UDEV=1

选择镜像变体

根据需求选择合适的变体：

• 运行时场景：使用balenalib/fincm3-ubuntu-golang:latest（默认run变体）。
• 编译场景：使用balenalib/fincm3-ubuntu-golang:latest-build。

部署示例

Dockerfile示例（构建并运行Go应用）

dockerfile
FROM docker.xuanyuan.run/balenalib/fincm3-ubuntu-golang:latest

WORKDIR /go/src/app
COPY . .

RUN go get -d -v ./...
RUN go install -v ./...

CMD ["app"]

编译Go应用（不运行）

console
docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp docker.xuanyuan.run/balenalib/fincm3-ubuntu-golang:latest go build -v

构建并运行镜像

console
docker build -t my-golang-app .
docker run -it --rm --name my-running-app docker.xuanyuan.run/my-golang-app

用户反馈

• 问题反馈：通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82
• 贡献：欢迎通过GitHub Pull Request贡献代码，建议先通过Issues讨论计划。
• 文档：更多详情请参考https://www.balena.io/docs/reference/base-images/base-images/%E3%80%82