dwdraju/alpine-curl-jq

Alpine Docker镜像（含curl、jq、bash）

1. 镜像概述和主要用途

本镜像基于Alpine Linux构建，集成了curl（HTTP请求工具）、jq（JSON数据处理工具）和bash（增强型shell），提供轻量级运行环境，用于快速执行HTTP请求、JSON数据解析及shell脚本操作。主要用途包括在CI/CD流程、多步骤构建或开发调试中，提供便捷的工具链支持。

2. 核心功能和特性

2.1 基础环境

• Alpine Linux基础：基于Alpine构建，具备轻量级（镜像体积小）、安全性高、资源占用低的特点。

2.2 集成工具

• curl：支持HTTP/HTTPS等多种协议的命令行HTTP客户端，可用于发送请求、下载资源或验证服务可用性。
• jq：轻量级JSON处理器，支持对JSON数据进行解析、过滤、转换和格式化，适用于处理API响应或配置文件。
• bash：提供比Alpine默认ash更丰富的shell功能（如数组、条件判断、函数等），支持复杂脚本执行。

3. 使用场景和适用范围

3.1 多步骤构建/CI/CD流程中的HTTP请求

在Docker多阶段构建或CI/CD流水线中，通过本镜像执行curl命令拉取配置文件、验证服务健康状态或触发外部API（如通知、部署钩子）。

3.2 API访问控制与响应验证

通过curl调用目标API，结合jq解析JSON响应，验证接口权限（如检查返回状态码、提取关键字段值），确保后续步骤仅在权限验证通过后执行。

3.3 开发调试与快速测试

本地开发或调试时，快速启动容器执行临时curl请求（如测试API端点）或使用jq处理JSON数据（如格式化日志、提取字段）。

3.4 轻量级脚本执行

基于bash编写简单脚本，结合curl和jq实现自动化任务（如定时拉取数据、监控API状态），适用于资源受限环境。

4. 使用方法和配置说明

4.1 镜像拉取

从Docker Hub拉取最新版本镜像：

bash
docker pull dwdraju/alpine-curl-jq

4.2 基本使用方式

通过docker run命令启动容器，直接在命令行指定需执行的操作（默认入口为bash，支持覆盖命令）：

bash
docker run --rm dwdraju/alpine-curl-jq [命令]

• --rm：容器退出后自动删除，避免残留。
• [命令]：需执行的具体操作（如curl、jq或自定义脚本）。

5. Docker部署示例

5.1 基础示例：使用curl发送HTTP请求

执行curl访问目标URL（如Google首页）：

bash
docker run --rm dwdraju/alpine-curl-jq curl https://www.google.com

5.2 进阶示例：curl+jq解析API响应

调用GitHub API获取仓库fork列表，并通过jq提取所有fork的ID：

bash
docker run --rm dwdraju/alpine-curl-jq sh -c "curl -s https://api.github.com/repos/github/hub/forks | jq '.[].id'"

• -s：curl静默模式（不输出进度信息）。
• jq '.[].id'：通过jq解析JSON数组，提取每个元素的id字段。

5.3 自定义脚本执行

将本地脚本挂载到容器中，通过bash执行（需确保脚本有可执行权限）：

bash
# 本地脚本示例（script.sh）：
# #!/bin/bash
# curl -s https://api.example.com/config | jq '.env.prod'

docker run --rm -v $(pwd)/script.sh:/script.sh dwdraju/alpine-curl-jq bash /script.sh

• -v $(pwd)/script.sh:/script.sh：将本地script.sh挂载到容器内/script.sh路径。

6. 配置参数与环境变量

本镜像无内置配置文件或环境变量，所有操作通过命令行参数或挂载脚本实现。若需传递自定义参数（如API密钥、代理配置），可通过以下方式：

• 命令行参数：直接在docker run命令中附加（如curl -H "Authorization: Bearer <token>"）。
• 环境变量：通过-e参数传递（如docker run -e "PROXY=http://proxy:8080" dwdraju/alpine-curl-jq curl $PROXY/...）。
• 文件挂载：通过-v挂载配置文件（如CA证书、curl配置文件）到容器内对应路径（如/etc/ssl/certs/）。