tianon/true

tianon/true Docker镜像文档

镜像概述

tianon/true是一个极致精简的Docker镜像，总大小仅124字节。其核心功能单一且明确：执行true命令后立即退出。该镜像通过静态汇编技术构建，无任何多余依赖，专为需要最小化资源占用的纯数据卷容器场景设计。

核心功能与特性

• 超小体积：仅124字节，是目前已知最小的Docker镜像之一，极大减少存储空间占用
• 单一功能：仅实现true命令功能，执行后立即返回退出码0，无其他多余逻辑
• 静态编译：采用静态汇编方式构建，不依赖任何系统库或运行时环境，可在任何Docker环境中独立运行

使用场景

该镜像主要适用于纯数据卷容器场景，具体包括：

• 创建持久化数据卷，用于存储应用数据且无需运行应用进程
• 在多个容器间共享数据卷，作为数据卷的"载体"容器
• 需要最小化基础镜像体积的特殊场景，如测试或演示环境

使用方法

基本运行方式

创建一个纯数据卷容器：

bash
docker run --name my-volume-container -v /data tianon/true

执行后，容器会立即退出（这是正常行为，因true命令执行完成），但数据卷/data会被Docker引擎保留。可通过docker inspect my-volume-container查看卷信息。

数据卷共享示例

1. 首先创建数据卷容器：

   bash
   docker run --name app-data -v /app/config -v /app/logs tianon/true
   

2. 后续容器可通过--volumes-from参数共享该数据卷：

   bash
   # 运行应用容器并挂载app-data的数据卷
   docker run --volumes-from app-data -d --name my-app my-app-image
   
   # 运行调试容器访问共享数据
   docker run --volumes-from app-data -it --rm ubuntu ls /app/config
   

注意事项

• 该镜像仅用于数据卷管理场景，不具备任何应用服务能力
• 容器启动后立即退出是正常行为，标志着true命令执行成功（退出码0）
• 数据卷的生命周期独立于容器，即使删除数据卷容器，通过-v创建的卷仍需通过docker volume rm显式删除
• 不支持自定义命令或参数，镜像固定执行true命令