wangyanglinux/tools Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

wangyanglinux/tools:randexitv1 镜像文档

镜像概述

wangyanglinux/tools:randexitv1 是一个基于 Alpine 构建的轻量级工具镜像，内置 randexit 程序。该程序可根据配置的休眠时间和退出码参数，在指定时间后返回固定或随机退出码，主要用于测试容器退出行为、验证重启策略及调试退出码处理逻辑。

核心功能与特性

• 可控休眠时间：支持通过参数设置程序运行前的休眠时长（秒）
• 灵活退出码控制：
  • 当 exitcode=0 时，固定返回退出码 0
  • 当 exitcode=1 时，固定返回退出码 1
  • 当 exitcode 为其他值时，随机返回 0 或 1（各 50% 概率）
• 轻量级：基于 Alpine 镜像，体积小，启动快速
• 简单易用：通过命令行参数即可完成配置，无需复杂设置

使用场景

• 测试容器编排平台（如 Kubernetes、Docker Compose）的重启策略（如 always、on-failure 等）
• 验证应用程序对不同退出码的处理逻辑
• 模拟服务异常退出场景，测试监控告警机制
• 自动化测试中控制流程执行时长和结束状态

使用方法与配置说明

基本使用

通过 docker run 命令直接运行镜像，可指定参数控制行为：

bash
docker run wangyanglinux/tools:randexitv1 [参数]

参数说明

使用示例

示例 1：默认参数运行

使用默认参数（休眠 5 秒，随机返回 0 或 1）：

bash
docker run wangyanglinux/tools:randexitv1

输出示例：

休眠 5 秒，产生的随机数为 36，小于等于 50 ，返回码为 0！

示例 2：指定休眠时间和固定退出码

设置休眠 10 秒，固定返回退出码 0：

bash
docker run wangyanglinux/tools:randexitv1 --sleeptime=10 --exitcode=0

输出：

休眠 10 秒，返回码为 0！

示例 3：指定固定退出码 1

设置休眠 3 秒，固定返回退出码 1：

bash
docker run wangyanglinux/tools:randexitv1 --sleeptime=3 --exitcode=1

输出：

休眠 3 秒，返回码为 1！

示例 4：使用 docker-compose 配置

创建 docker-compose.yml：

yaml
version: '3'
services:
  randexit-test:
    image: wangyanglinux/tools:randexitv1
    command: ["--sleeptime=8", "--exitcode=2"]  # 休眠8秒，随机返回0或1

启动服务：

bash
docker-compose up

退出码说明

程序执行后会返回以下退出码：

• 0：正常退出（当 exitcode=0 或随机模式下随机数 <50 时）
• 1：异常退出（当 exitcode=1 或随机模式下随机数 ≥50 时）