Docker API 无法应用 json 过滤器

Question

根据https://docs.docker.com/engine/reference/api/docker_remote_api_v1.24/#/list-tasks，过滤器只能用于获取具有特定服务名称的正在运行的容器。出于某种原因，我得到了所有任务的完整列表，无论它们的名称或期望的状态如何。我找不到任何将 curl 与带有 Docker API 的 JSON 请求一起使用的适当示例。 我正在使用以下命令：

一）

curl -X GET -H "Content-Type: application/json" -d '{"filters":[{ "service":"demo", "desired-state":"running" }]}' https://HOSTNAME:2376/tasks --cert ~/.docker/cert.pem --key ~/.docker/key.pem --cacert ~/.docker/ca.pem

返回所有内容

B) 试图从Docker Remote API Filter Exited得到一些工作

curl https://HOSTNAME:2376/containers/json?all=1&filters={%22status%22:[%22exited%22]} --cert ~/.docker/cert.pem   --key ~/.docker/key.pem   --cacert ~/.docker/ca.pem

这个返回“curl: (60) Peer's Certificate issuer is not recognize.”，所以我猜 curl 请求格式不正确。

我在 Docker 论坛上询问过，他们提供了一些帮助。令我惊讶的是，互联网上没有任何适当的文档说明如何将 Docker API 与 curl 一起使用，或者它是如此明显而我什么都不懂？

Answer 1

docker REST 代理可以像这样简单：

https://github.com/laoshanxi/app-mesh/blob/main/src/sdk/docker/docker-rest.go

然后你可以这样卷曲：

curl -g http://127.0.0.1:6058/containers/json'?filters={%22name%22:[%22jenkins%22]}'

Answer 2

您可以使用 socat 创建日志代理。这是一个例子。

docker run -v /var/run/docker.sock:/var/run/docker.sock -p 127.0.0.1:1234:1234 bobrik/socat -v TCP-LISTEN:1234,fork UNIX-CONNECT:/var/run/docker.sock

然后在另一个窗口中运行类似的命令。

docker -H localhost:1234 run --rm -p 2222:2222  hello-world

这个例子在 ubuntu 上使用了 docker。

Answer 3

我应该在前面加上一个事实，即我从未见过 curl 错误地报告证书错误，而实际上还有其他问题在起作用，但我相信你的断言，这实际上不是证书问题。

一开始我以为你对filters 的论点是不正确的，因为 根据API reference，filters参数是……

要在容器列表上处理的过滤器的 JSON 编码值（map[string][]string）。

我不确定如何解释map[string][]string，所以我在我的Docker客户端和服务器之间设置了一个日志代理并运行docker ps -f status=exited，它产生了以下请求：

GET /v1.24/containers/json?filters=%7B%22status%22%3A%7B%22exited%22%3Atrue%7D%7D HTTP/1.1\r

如果我们将参数解码为filters，我们会看到它是：

{"status":{"exited":true}}

而你正在路过：

{"status":["exited"]}

显然，这是不同的，我假设这是问题的根源......但在尝试验证时，我遇到了一个奇怪的问题。我什至无法运行您所写的curl 命令行，因为由于大括号，curl 会尝试执行一些通配行为：

$ curl http://localhost:2376/containers/json'?filters={%22status%22:[%22exited%22]}'
curl: (3) [globbing] nested brace in column 67

如果我正确引用你的参数来过滤：

$ python -c 'import urllib; print urllib.quote("""{"status":["exited"]}""")'
%7B%22status%22%3A%5B%22exited%22%5D%7D

它似乎工作得很好：

$ curl http://localhost:2376/containers/json'?filters=%7B%22status%22%3A%5B%22exited%22%5D%7D'
[{"Id":...

如果我使用您的原始表达式并通过-g（又名--globoff）来禁用大括号扩展，我可以获得相同的行为：

$ curl -g http://localhost:2376/containers/json'?filters={%22status%22:[%22exited%22]}'
[{"Id":...

我想强调的一件事是在 docker 客户端和服务器之间粘贴代理的实用性。如果您发现自己问“我如何使用这个 API？”，一个很好的答案是确切地查看 Docker 客户端在相同情况下正在做什么。