如何在GitLab CI中实现YAML转JSON并解决yq安装找不到包的问题

一、解决yq安装报错的可行方案 #

你遇到的apt安装yq报错是因为多数Debian/Ubuntu默认软件源未收录yq包，PPA源在CI环境中常因网络限制无法正常访问，可使用以下两种稳定方案：

• 方案1：直接安装预编译二进制文件（无需依赖第三方软件源）
  在before_script中执行如下命令：

apt-get -qq update
apt-get install -y wget
# 下载官方预编译的yq可执行文件
wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -O /usr/local/bin/yq
chmod +x /usr/local/bin/yq

安装完成后即可直接使用yq -o json api-spec.yml > api-spec.json完成格式转换。

• 方案2：直接使用yq官方镜像作为Job运行镜像
  无需在CI中执行任何安装操作，直接为转换任务指定官方yq镜像即可，示例配置：

convert-yaml-to-json:
  image: mikefarah/yq:4
  script:
    - yq -o json api-spec.yml > api-spec.json
  # 按需补充artifacts、缓存等其他配置

该方案无需处理依赖安装，执行效率更高。

二、无需安装yq的替代转换方案 #

如果你不想额外安装yq，可使用CI环境普遍预装的工具实现转换：

• 方案1：基于Python实现（绝大多数Linux镜像默认预装Python3）
  python3-yaml在官方apt源中稳定存在，不会出现找不到包的问题，执行命令如下：

apt-get -qq update
apt-get install -y python3 python3-yaml
python3 -c 'import yaml, json; json.dump(yaml.safe_load(open("api-spec.yml")), open("api-spec.json", "w"), ensure_ascii=False, indent=2)'

• 方案2：基于Node.js实现（仅适用于已预装Node的镜像）
  如果你的CI环境已经有Node runtime，可执行如下命令转换：

npm install -g js-yaml
node -e "const fs = require('fs'), yaml = require('js-yaml'); fs.writeFileSync('api-spec.json', JSON.stringify(yaml.load(fs.readFileSync('api-spec.yml', 'utf8')), null, 2))"

内容的提问来源于stack exchange，提问作者ebrake