balenalib/surface-go-ubuntu-golang

⚠️ 已废弃

此基础镜像已废弃，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

镜像概述和主要用途

该镜像属于balena.io IoT设备基础镜像系列，专为物联网设备开发优化。虽然针对balena.io平台和balenaOS进行了优化，但也可在其他支持相应架构的Docker环境中使用。

核心功能和特性

install_packages 脚本

提供便捷的包安装脚本 install_packages，抽象了底层包管理器的细节，具备以下特性：

• 安装指定包时自动选择最小依赖集（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试

动态设备支持

每个 balenalib 基础镜像默认定义 ENTRYPOINT ["/usr/bin/entry.sh"]，支持动态插入设备：

• 通过设置环境变量 ENV UDEV=1 启用UDEV功能
• 启用后将启动 udevd 守护进程，使容器内 /dev 目录下自动生成相关设备节点

使用场景和适用范围

• IoT设备上Go应用的开发、构建与运行
• 基于balena平台的物联网项目开发
• 需要动态设备接入的容器化应用场景
• 跨架构Go应用的编译环境（结合 -build 变体）

镜像变体

:<version> 或 :<version>-run

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

:<version>-build

重型变体，包含大量源码构建所需工具，减少Dockerfile中手动安装的包数量，从而降低系统中所有镜像的总体积。

支持的版本及Dockerfile链接

• 1.20.1 (latest)、1.19.6、1.18.10
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/surface-go/ubuntu/

镜像历史及详细信息可查看https://github.com/balena-io-library/official-images/blob/master/library/surface-go-ubuntu-golang%EF%BC%88%E4%BD%8D%E4%BA%8E https://github.com/balena-io-library/official-images%EF%BC%89%E3%80%82

使用方法和配置说明

Dockerfile示例：构建并运行Go应用

dockerfile
FROM balenalib/surface-go-ubuntu-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 my-golang-app

容器内编译应用（仅编译不运行）

适用于无需在容器内运行应用的场景：

bash
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp \
  balenalib/surface-go-ubuntu-golang:latest go build -v

• 将当前目录挂载为容器内 /usr/src/myapp 卷
• 设置工作目录为该卷
• 执行 go build 编译项目，输出可执行文件到当前目录

配置参数

UDEV环境变量

Docker部署方案示例

docker-compose配置示例

yaml
version: '3'
services:
  go-app:
    build: .
    image: my-golang-app
    environment:
      - UDEV=1  # 启用动态设备支持
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # 映射USB设备（如适用）
    restart: always

用户反馈

问题反馈

如遇问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E3%80%82

贡献指南

欢迎贡献新功能、修复或更新。建议在提交代码前通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E4%BB%A5%E4%BE%BF%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%8F%90%E4%BE%9B%E6%8C%87%E5%AF%BC%E5%92%8C%E5%8F%8D%E9%A6%88%E3%80%82

更多文档

• balenalib基础镜像文档
• 功能概述
• 迁移指南