ddev/ddev-utilities

ddev-utilities Docker镜像

概述

ddev-utilities是一个轻量级的Linux实用工具集合，提供一致的工具环境，包含以下核心工具：

• base64
• bash
• curl
• jq
• sed
• shasum
• wget
• yq

该镜像旨在解决不同操作系统（如macOS与Linux）上工具行为不一致的问题，确保在各类环境中获得可预测的工具执行结果。

核心功能与特性

• 跨系统一致性：统一工具版本和行为，避免因操作系统差异（如macOS的BSD工具与Linux的GNU工具）导致的兼容性问题
• 丰富工具集：集成日常开发和运维常用的文本处理、网络请求、数据解析工具
• 轻量级设计：镜像体积小，启动快速，资源占用低
• 即开即用：无需本地安装依赖，通过Docker直接调用工具

使用场景

• DDEV插件开发与运行，确保依赖工具的可用性和一致性
• 跨平台脚本编写，避免因系统工具差异导致的脚本执行失败
• 需要在不同环境中保持统一工具行为的自动化任务
• 临时需要特定版本工具的场景，无需在本地安装

使用方法与配置说明

base64

替代系统自带的base64命令，避免不同系统间解码行为差异：

bash
echo "somebase64content" | docker run -i --rm ddev/ddev-utilities base64 -d

curl

执行网络请求：

bash
docker run -i --rm ddev/ddev-utilities curl -I https://ddev.com

jq

JSON数据处理工具，确保在没有本地安装jq的系统上可用：

bash
ddev describe -j | docker run -i --rm ddev/ddev-utilities jq -r .raw

sed

提供一致的流编辑器行为，解决macOS等BSD系统与Linux系统的sed差异：

bash
ddev list -j | docker run -i --rm ddev/ddev-utilities bash -c "jq -r .raw | sed 's/ddev\\.site/tld/g'"

shasum

生成一致的哈希值，避免系统间shasum行为差异：

bash
echo $RANDOM | docker run -i --rm ddev/ddev-utilities shasum -a 256

wget

文件下载工具，支持复杂下载场景：

bash
docker run -it --rm -v ./:/pwd -u $(id -u):$(id -g) -w /pwd ddev/ddev-utilities bash -c "wget -qO- https://github.com/ddev/ddev/releases/download/v1.23.4/ddev_shell_completion_scripts.v1.23.4.tar.gz | tar xz --strip-components=1"

yq

YAML文件处理工具，示例：向DDEV配置添加post-start钩子

原配置示例：

yaml
hooks:
    post-start:
        - exec-host: ddev mailpit

执行命令：

bash
docker run -i --rm -v ./:/pwd -u $(id -u):$(id -g) -w /pwd ddev/ddev-utilities yq -I4 -i '.hooks."post-start"[0]."exec-host" = "ddev mailpit"' .ddev/config.yaml

构建与推送镜像

参考项目中的push.sh脚本：https://github.com/ddev/ddev-utilities/blob/main/push.sh

独立运行容器

直接启动容器进行交互：

bash
docker run -it --rm ddev/ddev-utilities

来源

https://github.com/ddev/ddev-utilities

维护者

https://github.com/ddev

帮助渠道

• DDEV社区***
• Stack Overflow

问题反馈

https://github.com/ddev/ddev-utilities/issues

文档

https://github.com/ddev/ddev-utilities