jonstonchan/exit

jonstonchan/exit 镜像文档

镜像概述

jonstonchan/exit 是一个轻量级Docker镜像，其核心功能是以指定的退出码退出。该镜像设计简洁，主要用于CI/CD管道场景，如控制作业执行状态、作为占位符作业或测试退出码处理逻辑。

核心功能与特性

• 指定退出码：支持0-255范围内的任意退出码，通过镜像标签直接指定
• 轻量级：基于汇编语言构建，镜像体积极小
• CI/CD友好：专为CI/CD管道设计，可无缝集成到GitLab CI等平台
• 无latest标签：镜像不提供latest标签，需显式指定具体退出码标签

标签说明

镜像标签直接对应退出码，支持以下标签：

• 0（别名true）：退出码0（成功）
• 1（别名false）：退出码1（失败）
• 2, 3, ..., 255：对应数字的退出码

使用场景

1. GitLab Pages部署占位符：在静态网站部署流程中作为占位符作业
2. CI作业状态控制：通过指定退出码控制CI作业的成功/失败状态
3. 退出码测试：测试系统对不同退出码的处理逻辑

使用方法

1. GitLab CI中部署静态网站

在GitLab CI中，可使用该镜像作为静态网站部署的占位符作业：

yaml
pages:
  stage: deploy
  image: jonstonchan/exit:true
  script: _
  artifacts:
    paths:
      - public/

2. 指定退出码运行

直接通过Docker命令运行，指定退出码：

bash
docker run --rm jonstonchan/exit:127; echo $?

在CI作业中配置特定退出码的状态判断：

yaml
job:
  image: jonstonchan/exit:127
  status:
    success: [0, 127]  # 将退出码0和127视为成功
    warning: [63]      # 将退出码63视为警告

注意：上述CI状态配置在撰写时可能存在语法限制，具体请参考GitLab CI文档。

相关GitLab问题

• CI作业中使用镜像时的空脚本问题
• 通过退出码控制构建状态的需求

构建说明

使用以下命令构建指定退出码的镜像：

bash
nasm -f bin -d exit_code=$exit_code -o e exit.asm

exit.asm模板

基于Stack Exchange回答修改的汇编模板：

asm
BITS 64
  org 0x400000

ehdr:           ; Elf64_Ehdr
  db 0x7f, "ELF", 2, 1, 1, 0 ; e_ident
  times 8 db 0
  dw  2         ; e_type
  dw  0x3e      ; e_machine
  dd  1         ; e_version
  dq  _start    ; e_entry
  dq  phdr - $$ ; e_phoff
  dq  0         ; e_shoff
  dd  0         ; e_flags
  dw  ehdrsize  ; e_ehsize
  dw  phdrsize  ; e_phentsize
  dw  1         ; e_phnum
  dw  0         ; e_shentsize
  dw  0         ; e_shnum
  dw  0         ; e_shstrndx
  ehdrsize  equ  $ - ehdr

phdr:           ; Elf64_Phdr
  dd  1         ; p_type
  dd  5         ; p_flags
  dq  0         ; p_offset
  dq  $$        ; p_vaddr
  dq  $$        ; p_paddr
  dq  filesize  ; p_filesz
  dq  filesize  ; p_memsz
  dq  0x1000    ; p_align
  phdrsize  equ  $ - phdr

_start:
  lea  eax, [rdi+60]     ; rax = 60 = SYS_exit，使用3字节指令：base+disp8寻址模式
  %ifn exit_code = 0
    mov  dil, exit_code  ; int status = exit_code
  %endif
  syscall                ; 原生64位系统调用

filesize  equ  $ - $$