tianon/sleeping-beauty

sleeping-beauty 镜像文档

概述

sleeping-beauty 是一个轻量级Docker镜像，核心功能为执行Linux系统调用pause()，使容器进程进入暂停状态，直至接收外部信号（如SIGTERM、SIGINT）后退出。该镜像专注于提供简单、可预测的进程暂停能力，适用于基础容器测试或占位场景。

特性

• 轻量级设计：基于极简基础镜像构建，镜像体积小，运行时资源占用低
• 行为确定性：仅执行pause()系统调用，无额外逻辑，容器状态可预测
• 环境兼容性：支持标准Docker运行时，可在各类Linux发行版环境中部署

使用场景

• 验证容器生命周期管理（如启动、停止、信号处理流程）
• 作为占位容器临时占用资源（如容器名称、网络接口、PID命名空间）
• 调试容器运行时信号传递机制

使用方法

基本运行

启动暂停容器，进程将阻塞直至接收退出信号： docker run --rm tianon/sleeping-beauty

后台运行

在后台启动并指定容器名称，通过docker stop发送终止信号： docker run -d --name pause-demo tianon/sleeping-beauty docker stop pause-demo

Docker部署方案示例

以下示例演示如何使用该镜像测试容器网络端点占用：

1. 创建测试网络： docker network create test-network
2. 启动占位容器并连接网络： docker run -d --name network-placeholder --network test-network --network-alias placeholder tianon/sleeping-beauty
3. 验证网络端点状态： docker network inspect test-network | grep placeholder
4. 清理资源： docker stop network-placeholder && docker rm network-placeholder && docker network rm test-network

注意事项

• 容器无主动退出机制，需外部信号触发进程退出
• 强制终止可使用docker kill发送SIGKILL信号（如docker kill <container-id>）