multiarch/true 镜像技术文档

1. 镜像概述

multiarch/true 是一个轻量级 Docker 镜像，提供多架构版本的 Unix/Linux 基础命令 /bin/true 功能。其核心用途是在容器环境中返回标准化的成功退出状态码（0），适用于需要确保命令成功执行的场景，如脚本占位符、多架构环境测试等。

2. 核心功能与特性

2.1 多架构支持

提供跨不同 CPU 架构的镜像版本，适配主流硬件平台（如 x86、x86_64 等）。

2.2 轻量级设计

镜像体积极小，仅包含 /bin/true 核心功能，无额外依赖，启动速度快。

2.3 标准化退出码

默认返回 Unix 标准成功退出码（0），符合 /bin/true 命令的原生行为（特定架构除外，详见下文说明）。

3. 支持架构

镜像通过标签区分不同架构，当前主要支持以下架构（基于***示例验证）：

注意：linux_arm 架构镜像在***示例中执行后返回非 0 退出码（1），可能存在架构兼容性问题，建议避免在 ARM 环境中使用。

4. 使用场景

4.1 多架构部署测试

用于验证 Docker 多架构环境配置，快速检测目标架构是否支持该镜像。

4.2 容器占位符

作为无业务逻辑的占位符容器，确保编排工具（如 Kubernetes、Docker Compose）的部署流程正常执行。

4.3 脚本与 CI/CD 流程

在自动化脚本或 CI/CD 流水线中，作为“空操作但成功”的标志，确保流程分支正常推进（如 if docker run multiarch/true; then ...）。

5. 使用方法与配置说明

5.1 基本使用

无需额外配置，直接通过 docker run 命令执行，镜像会立即返回退出码并退出。

命令格式：

bash
docker run --rm multiarch/true:<架构标签>

参数说明：

• --rm：容器退出后自动删除，避免残留。
• <架构标签>：指定目标架构，如 linux_amd64（必填，无默认标签）。

5.2 架构选择示例

根据部署环境的 CPU 架构选择对应标签：

64位 x86 环境（amd64）：

bash
docker run --rm multiarch/true:linux_amd64 2>/dev/null; echo $?
# 输出：0（成功退出码）

32位 x86 环境（386）：

bash
docker run --rm multiarch/true:linux_386 2>/dev/null; echo $?
# 输出：0（成功退出码）

ARM 环境（兼容性问题）：

bash
docker run --rm multiarch/true:linux_arm 2>/dev/null; echo $?
# 输出：1（非预期退出码，不建议使用）

5.3 配置参数与环境变量

该镜像无任何可配置参数或环境变量，仅提供 /bin/true 原生功能（无参数执行）。

6. 注意事项

1. 架构兼容性：linux_arm 标签可能存在未修复的兼容性问题，执行后返回非 0 退出码，生产环境建议优先使用 linux_amd64 或 linux_386。
2. 无持久化数据：镜像不包含文件系统写入逻辑，退出后无数据残留。
3. 网络无关性：无需网络连接即可运行，适合离线环境测试。