looztra/kubesplit

镜像概述

kubesplit镜像用于处理多文档格式的Kubernetes YAML描述符，将其拆分为独立的单个资源文件，帮助用户更高效地管理和维护K8s资源配置。

核心功能

• 自动忽略无效或空的Kubernetes资源
• 按资源名称和类型生成独立文件
• 集群级资源（如namespace、clusterrole）存于根目录，命名空间资源存于对应子目录
• 保留注释及引号（可通过参数调整）
• 支持清理输出目录、禁用资源前缀等自定义配置

使用场景

• 拆分复杂的多文档K8s配置文件，便于单独管理每个资源
• 格式化K8s YAML文件，提升可读性
• 集成到CI/CD流程中自动化处理K8s资源配置

配置说明

安装与运行

bash
# 拉取最新镜像
docker image pull looztra/kubesplit
# 或指定版本
docker image pull looztra/kubesplit:[version]-[sha1]

# 从文件输入拆分
docker container run \
        -i --rm \
        -v $(pwd):/code \
        -w /code looztra/kubesplit \
        -i path/to/yaml_file.yml \
        -o path/to/output/directory

# 从标准输入拆分（避免使用-t参数）
cat path/to/yaml_file.yml | \
        docker container run \
        -i --rm \
        -v $(pwd):/code \
        -w /code looztra/kubesplit \
        -o path/to/output/directory

命令行参数

bash
kubesplit -h
usage: kubesplit [-h] [-i INPUT] [-t TYP] -o OUTPUT_DIR [-n] [-e] [-q] [-f] [-d] [-c] [-p]

将Kubernetes描述符拆分为单个文件，支持YAML格式自定义。默认启用显式开始（---）、禁用显式结束（...），数组元素向内缩进，注释通过`rt`模式保留。

可选参数:
  -h, --help            显示帮助信息
  -i INPUT              输入文件路径（或-使用标准输入）
  -t TYP                解析模式（safe/rt）
  -o OUTPUT_DIR         输出目录（必填，不存在则创建）
  -n                    禁用显式开始（---）
  -e                    启用显式结束（...）
  -q                    禁用引号保留
  -f                    启用默认流样式（JSON格式写入）
  -d                    禁用列表dash向内缩进
  -c                    清理输出目录（谨慎使用）
  -p                    禁用资源文件数字前缀

源码地址

https://github.com/looztra/kubesplit