balenalib/kitra710-alpine-golang

balenalib kitra710-alpine-golang 镜像 文档

镜像概述

该镜像 balena.io 物联网设备基础镜像系列的一部分，专为 物联网设备优化，主要适用于 balena.io 平台和 balenaOS 系统，同时也可在支持相应 架构的其他 Docker 环境中使用。作为 Go 语言开发的基础镜像，它提供 精简高效 运行时环境，便于构建和部署物联网应用。

核心功能与特性

• 便捷 包安装工具：内置 install_packages 脚本，可抽象底层包管理器差异 自动安装指定包并最小化依赖，清理包管理器元数据，安装失败时自动重试。

• 动态设备支持：默认 ENTRYPOINT 为 /usr/bin/entry.sh，通过设置 ENV UDEV=1 可启动 udevd 守护进程，使容器内 /dev 目录能识别动态插入 设备节点。

镜像变体

balen lib 镜像提供多种变体以适应不同使用场景：

:<version> 或 :<version>-run

默认镜像变体，设计为精简 运行时环境，仅包含必要 运行时组件，适合部署阶段使用。

:<version>-build

包含构建源代码所需 多种工具，减少 Dockerfile 中 手动安装包 需求，有助于减小系统中所有镜像 总体大小，适合开发构建阶段使用。

使用场景与适用范围

• 物联网设备上 Go 语言应用 开发与部署
• 需要在 balena.io 平台或 bal enaOS 系统上运行 Go 项目
• 需动态识别外部设备 物联网应用
• 希望简化依赖管理和构建流程 Go 项目

使用方法与配置说明

与 Balena 一起使用

如需在 balena 平台上使用此基础镜像，可参考https://www.balena.io/docs/learn/getting-started kitra71 0/go/?ref=dockerhub，同时可查看https://www.balena.io docs/learn/get ting-started/kitra710/go/#example-projects?ref=dockerhub了解实际应用案例。

什么 Go ？

Go（又称 Golang）是由 Google 开发 编程语言，是一种静态类型语言，语法松散源自 C，但增加 垃圾回收、类型安全、部分动态类型能力、额外内置类型（如变长 数组和 键值映射）及庞大 标准库。

!Go logo

支持 版本及 Dockerfile 链接

• 1.19 ( latest) 、1.18.15、1.17.12 ：https://github.com/balena 1 o -library/base-images/tree/master/bal ena-base-images/golang/kitra710/alpine/

更多关于镜像及其历史 信息，可查看https://github.com/balena-io-library/official-images/blob/master /library/kitra 710-alpine-golang。

如何使用该镜像

在 应用中启动 Go 实例

最直接 使用方式是将 Go 容器同时作为构建和运行环境。 在 Dockerfile 中编写如下 内容，可编译并运行项目：

dockerfile
FROM docker.xuanyuan.run/balenalib/  kitra710-alpine-golang:latest

WORKDIR /  go/src/app
COPY . .  RUN go  get -d -v ./...
RUN go install -  v ./...

CMD ["app"]

然后构建并运行 Docker 镜像：

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

在 Docker 容器内编译应用

若无需在容器 内运行应用，仅需编译，可执行以下命令：

console
$ docker run --rm -v  "$PWD":/usr/src/my  app -w /usr/src/myapp balenalib/kitra710-alpine-golang:latest go build -v

该命令会将当前目录作为卷挂载到容器，设置工作目录为该卷，并执行 go build 命令编译项目，输出可执行文件。

配置参数

• UDEV：环境变量，设置为 1（ENV UDEV=1）时，启动 udevd 守护进程 ，使容器能识别动态插入 设备节点。

用户反馈

问题反馈

如遇到与镜像相关 问题 或疑问，请通过https://github.com/balena-io-library/base-images/issues%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%E5%B0%A4%E5%85%B6%E6%98%AF%E8%BE%83%E5%A4%8D%E6%9D%82 贡献，以便其他贡献 者提供指导和反馈 。

文档

该镜像 文档存储在https://www.balena.io/docs/reference/base-images/base-images/#bal 1 1 1 ena-base-images?ref=dockerhub中。更多关于 1 balenalib 基础镜像 新特性，可查看https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82 1 1