balenalib/kitra520-debian-golang

balenalib/kitra520-debian-golang镜像说明

镜像概述

该镜像属于balena.io的IoT设备基础镜像系列，基于Debian系统并集成Go语言环境。它针对balenaOS进行优化，同时支持在其他符合架构要求的Docker环境中使用，适用于开发和部署IoT领域的Go语言应用。

核心功能

1. 简化包管理：内置install_packages脚本，自动适配底层包管理器，最小化依赖安装，清理元数据并支持重试机制。
2. 动态设备支持：默认ENTRYPOINT通过UDEV环境变量控制udevd守护进程启动，实现容器内/dev目录的设备节点动态管理。
3. 多变体支持：提供两种镜像变体：
   • :<version>/:<version>-run：轻量运行时版本，仅包含必要的运行依赖。
   • :<version>-build：包含完整构建工具的版本，减少手动安装步骤，优化镜像体积。

使用场景

1. 在balenaOS平台上开发和部署IoT应用程序。
2. 编译和运行Go语言编写的跨平台IoT项目。
3. 快速搭建Go语言开发环境，进行代码调试和测试。

配置说明

• 镜像标签：使用latest（对应Go 1.19）或指定版本标签（如1.18.15、1.17.12）选择不同Go版本。
• UDEV配置：添加ENV UDEV=1可启用udevd守护进程，支持动态设备接入。

Docker部署示例

Dockerfile示例

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

WORKDIR /go/src/app
COPY . .

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

CMD ["app"]

构建并运行

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

仅编译应用

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/kitra520-debian-golang:latest go build -v

反馈与贡献

• 若遇到问题，请通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%E3%80%82
• 欢迎通过Pull Request贡献新功能或修复，建议先通过Issue讨论计划。
• 更多文档请参考https://www.balena.io/docs/reference/base-images/base-images/%E3%80%82