ubuntu/busybox

ubuntu/busybox 镜像文档

镜像概述和主要用途

ubuntu/busybox 是由 https://canonical.com/ 维护的 BusyBox rock 镜像。BusyBox 将许多常见 UNIX 工具的小型版本整合为单个小型可执行文件，提供桌面系统上常见工具（如 ls、cp、mv、mount、tar 等）的极简替代方案。此 rock 仅包含 BusyBox 二进制文件及其所有支持工具的符号链接。

https://www.busybox.net/

核心功能和特性

• 工具整合：将多种常见 UNIX 工具（ls、cp、mv 等）的精简版本整合为单个可执行文件
• 极简设计：仅包含 BusyBox 二进制文件及必要符号链接，体积小巧
• Canonical 维护：由 Canonical 官方维护，确保稳定性和安全性
• Pebble 入口点：采用 Pebble（容器优化的 init 进程）作为入口，支持服务编排和管理

https://documentation.ubuntu.com/pebble/

标签和架构

注意：这些标签遵循特定命名规范，符合 channels 概念。

使用场景和适用范围

• 轻量级容器环境中需要基础命令行工具的场景
• 嵌入式系统或资源受限环境的命令工具需求
• 作为基础镜像构建极简应用容器
• 需要快速获取常用 UNIX 工具集的临时环境

使用方法和配置说明

快速开始

检查

查看此 rock 中定义的 https://documentation.ubuntu.com/rockcraft/en/latest/reference/rockcraft-yaml/#services 和 https://documentation.ubuntu.com/rockcraft/latest/reference/rockcraft-yaml/#checks%EF%BC%9A

sh
docker run --rm docker.xuanyuan.run/ubuntu/busybox:1.37-26.04_edge plan

sh
docker inspect --format='{{.Config.Entrypoint}} {{.Config.Cmd}}' ubuntu/busybox:1.37-26.04_edge

运行

使用常规容器运行时（如 docker）运行此 rock：

sh
docker run --name busybox-container \
    docker.xuanyuan.run/ubuntu/busybox:1.37-26.04_edge \
    exec busybox

容器将输出 BusyBox 的帮助信息，包含其提供的可用命令。

获取日志

查看运行中容器的日志：

sh
docker exec busybox-container pebble logs

或查看特定服务的日志：

sh
docker exec busybox-container pebble logs <service>

sh
docker logs busybox-container

监控健康检查

Rocks 可能预定义了健康检查，可通过以下命令列出：

sh
docker exec busybox-container pebble checks

通过以下命令检查容器整体健康状态：

sh
docker exec busybox-container pebble health

问题反馈与***信息

https://github.com/canonical/busybox-rock/issues

Canonical 是此容器镜像的提供商。用户有责任确保对此镜像的任何使用均符合其中包含的所有软件的相关许可，以及 https://canonical.com/legal/intellectual-property-policy%E3%80%82