mplatform/mquery

镜像概述

mquery 是一个用于查询公共容器仓库中公共镜像信息的工具，可获取镜像的媒体类型（标准OCIv1或Docker v2.2）、摘要，以及平台支持情况（当镜像为OCI索引或Docker v2.2清单列表时）。该镜像由GitHub Action在公共仓库 https://github.com/estesp/mquery 发布新版本时自动创建并推送。

latest 标签始终指向上述GitHub代码仓库的最新非预发布版本。执行 registry 查询的后端实现为Web API触发的Lambda函数（代码位于仓库的 function 目录）。由于查询未经过身份验证，在负载较高时，Lambda函数实例的IP可能会受到速率限制，此限制主要影响DockerHub，其他公共 registry 目前可能无查询速率限制。

核心功能和特性

• 媒体类型识别：判断镜像是否为标准OCIv1或Docker v2.2格式
• 摘要信息获取：返回镜像的唯一加密摘要
• 平台支持检测：若镜像为OCI索引或Docker v2.2清单列表，可列出其支持的操作系统和架构组合
• 跨仓库兼容性：支持查询任何公共容器仓库中的公共镜像

使用场景和适用范围

• 开发者验证公共镜像的格式和兼容性
• 运维人员确认镜像支持的平台以规划部署环境
• 镜像维护者检查多平台镜像的构建结果

使用方法和配置说明

基本使用命令

通过 docker run 命令运行容器，指定要查询的公共镜像：

bash
docker run --rm docker.xuanyuan.run/mplatform/mquery [镜像名称:标签]

示例：查询自身镜像信息

运行以下命令可查看 mplatform/mquery:latest 镜像支持的操作系统/架构对：

bash
docker run --rm docker.xuanyuan.run/mplatform/mquery mplatform/mquery:latest

输出示例

Image: docker.xuanyuan.run/mplatform/mquery:latest (digest: sha256:1535b95ede49ab1f21a43c8c28cb1bb4d4c204ef43e5971666934ba9825adc11)
 * Manifest List: Yes (Image type: application/vnd.docker.distribution.manifest.list.v2+json)
 * Supported platforms:
   - linux/ppc64le
   - linux/amd64
   - linux/386
   - linux/s390x
   - linux/arm64/v8
   - linux/arm/v7
   - linux/arm/v6
   - windows/amd64:10.0.17763.1817
   - windows/amd64:10.0.14393.4283

输出内容解释

• Image：显示查询的镜像名称、标签及唯一摘要
• Manifest List：指示是否为清单列表（OCI索引或Docker v2.2清单列表）及具体镜像类型
• Supported platforms：列出镜像支持的所有操作系统/架构组合

问题反馈

如遇镜像相关问题，请在 https://github.com/estesp/mquery/issues 提交issue。