nathanosman/hang

hang 容器镜像文档

镜像概述

hang 是一个超小型 Docker 容器，设计初衷是提供一个体积极小（<1KB）且入口点不执行任何操作的容器。它基于极简架构构建，旨在满足各种需要最小化容器的场景，无需任何额外功能或资源消耗。

核心功能与特性

• 超小体积：镜像大小小于 1KB，是目前可用的最小容器之一，显著降低存储和传输成本
• 无操作入口点：容器的入口点设计为不执行任何实质性操作，启动后即完成运行流程
• 极简基础：基于 Docker scratch 镜像构建，不包含任何多余的文件系统、依赖或工具
• 快速启动：由于体积微小且无操作逻辑，容器启动速度极快，几乎不占用系统资源

使用场景与适用范围

• 容器编排测试：验证 Kubernetes、Docker Compose 等编排工具的部署配置，测试 Pod/服务创建逻辑
• 占位容器：在多容器应用中作为临时占位容器，等待其他服务就绪或资源分配
• 网络测试：作为简单网络端点，测试容器间网络连接性、DNS 解析或服务发现功能
• 基础镜像：作为构建其他极小容器的基础，减少最终镜像体积
• 资源测试：测试系统对大量小型容器的调度能力，或验证容器生命周期管理（启动/停止/重启）

使用方法与配置说明

基本使用

通过 docker run 命令直接运行容器：

bash
docker run --rm nathan-osman/hang

该命令会启动容器，执行入口点（无任何操作），然后立即退出，返回状态码 0。

保持容器运行

如需容器启动后保持运行（例如用于测试长时间部署），可覆盖入口点命令：

bash
docker run --rm --entrypoint sleep nathan-osman/hang infinity

此命令将入口点修改为 sleep infinity，使容器保持运行状态直至手动停止。

Docker Compose 配置

创建 docker-compose.yml 文件进行编排部署：

yaml
version: '3'
services:
  placeholder:
    image: nathan-osman/hang
    # 可选：配置为长期运行的占位容器
    entrypoint: ["sleep", "infinity"]
    restart: always

通过以下命令启动服务：

bash
docker-compose up -d

更多信息

关于镜像的详细设计背景和实现细节，请参考项目 GitHub 仓库：
https://github.com/nathan-osman/hang#readme