调用JFrog Artifactory API查询Docker镜像标签属性未返回预期详情

看起来你在通过JFrog Artifactory API查询Docker镜像的自定义标签属性时遇到了问题——返回的JSON里没有你要的com.company.info.build标签，而且你怀疑是请求URL的问题，这点其实猜得很准！让我帮你拆解一下问题所在，然后给出可行的解决方案。

核心问题：错误的API端点与参数用法 #

你当前使用的api/storage端点，本质是用来查看仓库中文件/对象的存储元数据（比如文件大小、创建时间、存储路径等），并不是专门用来查询Docker镜像的manifest内容或自定义标签属性的。另外，你加在URL后面的docker.label.com.company.info.build='*'是Artifactory的属性过滤参数，但这个参数只能用于搜索类API（比如AQL或属性搜索API），不能直接附加在api/storage的请求路径上。

解决方案1：用AQL查询自定义标签属性 #

如果你要批量搜索包含特定com.company.info.build标签的Docker镜像，最靠谱的方式是使用Artifactory的AQL（Artifactory Query Language），它支持直接过滤自定义属性。下面是修正后的Ruby代码示例：

require 'net/http'
require 'json'

# 构建AQL查询的请求URL
url = URI('http://myrepo:8081/artifactory/api/search/aql')
http = Net::HTTP.new(url.host, url.port)

# 设置请求头（Bearer认证+AQL内容类型）
headers = {
  'Authorization' => 'Bearer <REDACTED>',
  'Content-Type' => 'text/plain'
}

# 编写AQL查询：限定仓库、镜像路径，过滤build标签
aql_query = <<~AQL
  items.find({
    "repo": "dockerv2-local",
    "path": {"$match": "anonymizer/functional"},
    "@docker.label.com.company.info.build": {"$match": "*"}
  })
AQL

# 发送POST请求执行AQL
request = Net::HTTP::Post.new(url, headers)
request.body = aql_query

response = http.request(request)
if response.code == '200'
  puts "Artifactory response: #{response.body}"
  # 解析响应，提取目标标签属性
  results = JSON.parse(response.body)['results']
  results.each do |item|
    puts "Found build label: #{item['@docker.label.com.company.info.build']}"
  end
else
  puts "Request failed: #{response.code} - #{response.body}"
end

解决方案2：通过Docker兼容端点获取manifest中的标签 #

如果你需要获取特定镜像标签的完整Docker manifest（包含镜像内置的Labels字段），可以使用Artifactory提供的Docker兼容API端点。这个方法需要先拉取manifest，再通过manifest中的config digest拉取镜像配置，最终拿到Labels：

require 'net/http'
require 'json'

# 替换成你要查询的镜像标签
target_tag = 'latest'

# 1. 拉取目标镜像的manifest
manifest_url = URI("http://myrepo:8081/artifactory/api/docker/dockerv2-local/v2/anonymizer/functional/manifests/#{target_tag}")
http = Net::HTTP.new(manifest_url.host, manifest_url.port)
headers = {
  'Authorization' => 'Bearer <REDACTED>',
  'Accept' => 'application/vnd.docker.distribution.manifest.v2+json'
}

manifest_request = Net::HTTP::Get.new(manifest_url, headers)
manifest_response = http.request(manifest_request)

if manifest_response.code == '200'
  manifest = JSON.parse(manifest_response.body)
  # 2. 从manifest中获取config层的digest，拉取镜像配置
  config_digest = manifest['config']['digest']
  config_url = URI("http://myrepo:8081/artifactory/api/docker/dockerv2-local/v2/anonymizer/functional/blobs/#{config_digest}")
  
  config_request = Net::HTTP::Get.new(config_url, headers)
  config_response = http.request(config_request)
  
  if config_response.code == '200'
    config = JSON.parse(config_response.body)
    puts "Full Docker Labels: #{config['config']['Labels']}"
    # 提取你需要的特定build标签
    puts "Build info: #{config['config']['Labels']['com.company.info.build']}"
  else
    puts "Failed to fetch config: #{config_response.code} - #{config_response.body}"
  end
else
  puts "Failed to fetch manifest: #{manifest_response.code} - #{manifest_response.body}"
end

关键注意点 #

• 确保你的Artifactory用户拥有仓库读取权限和AQL查询权限（如果用方案1）。
• 如果你的镜像使用的是v1格式的manifest，需要把Accept头改成application/vnd.docker.distribution.manifest.v1+json。
• docker.label开头的属性是Artifactory自动从Docker镜像的Labels字段同步过来的自定义属性，所以两种方案都能拿到你要的内容，按需选择即可。

内容的提问来源于stack exchange，提问作者Mark Jaffe