balenalib/artik530

balenalib/artik530镜像说明

镜像概述

该镜像属于balena.io的IoT设备基础镜像系列，专为IoT设备优化，可在balena.io平台、balenaOS环境或适配架构的Docker环境中使用。

!balenalogo

核心功能

balenalib基础镜像的主要特性包括：

1. 便捷包安装脚本：提供install_packages脚本，抽象底层包管理器细节，安装包时忽略可选依赖、清理元数据并在失败时重试。
2. 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，检查UDEV环境变量（设置ENV UDEV=1启用），若为true则启动udevd守护进程，容器/dev目录将出现相关设备节点。

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

镜像变体

• : 或 :-run：默认slim镜像，仅包含运行时必要组件。
• :-build：重型镜像，包含源码构建工具，减少手动安装包需求。

变体详情见https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

使用场景

适用于IoT设备应用的开发与部署，如balenaOS上的物联网项目或其他Docker环境中的IoT应用构建。

配置说明

• 启用动态设备：设置ENV UDEV=1。
• 选择变体：开发阶段用build变体，运行阶段用run变体。

快速使用示例

创建Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/artik530-debian:latest
# 替换为你的应用代码

构建并运行

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

Balena平台使用指南

参考https://www.balena.io/docs/learn/getting-started/artik530/nodejs/?ref=dockerhub%EF%BC%8C%E6%88%96%E6%9F%A5%E7%9C%8Bhttps://www.balena.io/docs/learn/getting-started/artik530/nodejs/#example-projects?ref=dockerhub%E3%80%82

支持版本

• bullseye (latest)、bookworm、buster、sid：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/artik530/debian/

用户反馈

• 问题反馈：通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E3%80%82
• 贡献：建议先通过issue讨论计划，再提交PR。
• 文档：查看https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%E6%88%96https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82