improwised/toolset

工具集镜像

镜像概述

本Docker镜像集成了多种开发和运维常用工具，旨在提供一站式的工具环境，满足图表测试、发布、数据处理、版本管理等多样化需求。无需单独安装各工具，可直接通过容器化方式使用。

核心功能和特性

• ct：Helm图表测试工具，用于验证Helm图表的语法、依赖和可用性
• cr：Helm图表发布工具，支持将Helm图表发布到Chart仓库
• ghr：GitHub发布工具，用于将资产（如二进制文件、压缩包）发布到GitHub Releases
• yq：YAML文件处理工具，支持查询、修改、转换YAML数据
• jq：JSON数据处理工具，支持过滤、转换、查询JSON数据
• git-chglog：变更日志生成工具，基于Git提交历史自动生成结构化变更日志
• semvertool：语义化版本控制工具，用于管理和更新语义化版本号（如major、minor、patch版本 bump）
• git：版本控制系统，用于代码管理和提交历史追踪

使用场景和适用范围

• Helm图表开发与测试流程
• CI/CD流水线中的图表发布环节
• GitHub项目的资产发布与版本管理
• YAML/JSON配置文件的批量处理和转换
• 项目变更日志的自动化生成
• 语义化版本号的规范化管理

使用方法和配置说明

基本使用

通过docker run命令启动容器，直接使用工具：

bash
docker run --rm -it [镜像名称] [工具命令]

工具使用示例

1. 使用ct测试Helm图表

bash
# 进入容器
docker run --rm -it [镜像名称] sh

# 在容器内执行ct测试
ct lint --charts /path/to/chart

2. 使用cr发布Helm图表

bash
docker run --rm -it -e CR_TOKEN=[your-token] [镜像名称] \
  cr upload --owner [username] --repo [repo-name] --package /path/to/chart.tgz

3. 使用ghr发布GitHub资产

bash
docker run --rm -it -e GITHUB_TOKEN=[your-token] -v $(pwd):/assets [镜像名称] \
  ghr -t [your-token] -u [username] -r [repo-name] v1.0.0 /assets/

4. 使用yq处理YAML文件

bash
# 从YAML文件中提取特定字段
docker run --rm -v $(pwd):/data [镜像名称] yq eval '.metadata.name' /data/file.yaml

# 修改YAML文件中的值
docker run --rm -v $(pwd):/data [镜像名称] yq eval '.spec.replicas = 3' -i /data/file.yaml

5. 使用jq处理JSON文件

bash
# 从JSON文件中提取数据
docker run --rm -v $(pwd):/data [镜像名称] jq '.data[] | select(.id == 1)' /data/file.json

6. 使用git-chglog生成变更日志

bash
docker run --rm -v $(pwd):/repo [镜像名称] git-chglog --output CHANGELOG.md

7. 使用semvertool更新版本号

bash
# 升级minor版本（如1.0.0 -> 1.1.0）
docker run --rm [镜像名称] semvertool bump minor 1.0.0

持久化数据

若需在容器外保留工具操作结果（如生成的变更日志、处理后的配置文件），可通过挂载本地目录实现：

bash
docker run --rm -v $(pwd):/workspace [镜像名称] [工具命令]

其中$(pwd)为本地目录，/workspace为容器内工作目录，工具操作的文件可直接在本地查看和编辑。