包含curl的Docker镜像

为什么创建此镜像？

如您所知，curl包含两个组件：同名库和动态链接的可执行文件。在基于scratch（空文件系统）的Docker镜像中使用curl时，有两种选择：

• 在镜像中包含curl所需的所有依赖库
• 将curl编译为静态二进制文件

本仓库的Dockerfile采用第二种方案（主要思路参考自此处）。

重要说明：为减小二进制文件大小，部分curl功能（如gopher、imap、proxy等）已被禁用。

另一重要变更：使用--fail标志时，错误退出码为1（而非默认的22）。此补丁详情可查看此处。该变更旨在适配Docker健康检查（Docker健康检查的可能退出码：0表示成功/健康，1表示不健康）：

bash
$ docker run --rm tarampampam/curl -s --fail --show-error [***]
curl: (22) The requested URL returned error: 401

$ echo "退出码: $?"
退出码: 1

镜像信息

基于alpine的镜像标签带有-alpine后缀，例如：tarampampam/curl:8.0.1-alpine。

此镜像支持以下平台：

bash
$ docker run --rm mplatform/mquery tarampampam/curl:latest
Image: tarampampam/curl:latest
 * Manifest List: Yes (Image type: application/vnd.docker.distribution.manifest.list.v2+json)
 * Supported platforms:
   - linux/amd64
   - linux/386
   - linux/arm64
   - linux/arm/v6
   - linux/arm/v7

如何使用？

例如 - 作为Docker健康检查（注意 - 我们使用scratch作为基础镜像）：

Dockerfile
# 使用空文件系统
FROM scratch

# 导入可执行应用
COPY --from=docker.io/containous/whoami:v1.5.0 /whoami /whoami

# 从当前仓库镜像导入curl
COPY --from=ghcr.io/tarampampam/curl:8.6.0 /bin/curl /bin/curl

# 文档: <[***]>
HEALTHCHECK --interval=5s --timeout=2s --retries=2 --start-period=2s CMD [ \
    "curl", "--fail", "[***]" \
]

ENTRYPOINT ["/whoami"]

之后可构建此镜像、运行并查看状态：

bash
$ docker build --tag healthcheck-test:local .
...
Successfully built 72bf22424af7
Successfully tagged healthcheck-test:local

$ docker run --rm -d --name healthcheck-test healthcheck-test:local
b3f20332ac19b42dfed03021c0b90b3650b9a7efbaea7c8800d35551e43d35d7

$ docker ps --filter 'name=healthcheck-test' --format '{{.Status}}'
Up 1 minutes (healthy)

$ docker kill healthcheck-test

发布流程

新版本发布非常简单 - 只需在此仓库中进行必要更改，然后使用仓库的发布页面"发布"新版本即可。

Docker镜像将自动构建并发布。

新版本将覆盖两个注册表中的latest和latest-alpine Docker镜像标签。

支持

如发现任何包错误，请在当前仓库中创建issue。

许可证

WTFPL。可随意用于任何用途。