freifunkhamm/jsonschema

Docker化的jsonschema工具

!Docker Stars !Docker Pulls !Docker Automated !Docker Build !Docker Image Size

镜像概述

本镜像将jsonschema命令行工具容器化，支持验证draft-03、draft-04、draft-06和draft-07版本的JSON Schema文件，主要用于CI/CD流水线（如Github Actions、Travis-CI等）及本地开发场景中的JSON Schema校验。

相关资源：

• jsonschema源码：https://github.com/Julian/jsonschema
• jsonschema文档：[***]
• Dockerfile仓库：https://github.com/Freifunk-Hamm/docker_jsonschema
• Docker镜像地址：https://hub.docker.com/r/freifunkhamm/jsonschema

核心功能

1. 验证JSON实例文件是否符合自定义Schema
2. 验证自定义Schema是否符合官方元Schema（支持多个草案版本）
3. 支持在CI/CD环境中集成使用
4. 提供固定版本标签确保构建可复现性

使用场景

1. CI/CD流水线中自动校验JSON配置文件的Schema合规性
2. 本地开发时快速验证JSON Schema文件的正确性
3. 批量检查多个JSON文件是否符合指定Schema

配置说明

安装

将脚本复制到系统PATH以简化使用：

bash
sudo cp jsonschema /usr/local/bin

脚本会将当前工作目录挂载到容器的/data目录，支持直接操作本地文件。

版本管理

• 镜像标签（除latest外）均为不可变版本，建议在CI/CD中使用固定版本（如3.1.1）确保可复现性
• 如需更新镜像，删除本地缓存后重新运行：

  bash
  docker image rm freifunkhamm/jsonschema
  

安全更新

当环境有安全补丁时，会发布带有securityFix后缀的版本（如3.2.0_securityFix1），建议优先使用此类版本。

运行示例

查看版本

bash
jsonschema --version

查看帮助

bash
jsonschema -h

验证JSON实例与自定义Schema

bash
jsonschema -i instanceData.json customSchema.json

验证Schema是否符合官方元Schema（以draft-07为例）

1. 缓存官方元Schema（可选）：

   bash
   wget -O official.draft-07.schema.json http://json-schema.org/draft-07/schema#
   

2. 验证自定义Schema：

   bash
   # 使用内置补丁版本验证
   jsonschema --validator Draft7Validator customSchema.json
   # 使用官方元Schema验证
   jsonschema -i customSchema.json official.draft-07.schema.json
   

贡献与自定义构建

可Fork仓库修改Dockerfile，测试后提交Pull Request，或自行构建镜像。

bash
git clone https://github.com/Freifunk-Hamm/docker_jsonschema.git
cd docker_jsonschema
docker build -t yourname/jsonschema .