Docker 查看远端仓库的标签和镜像大小

时间 2019-11-29

原文原文链接

1、经过 registry v1 api 接口

此接口只能获取标签，不能获取镜像大小php

# 查询 URL 为 
https://registry.hub.docker.com/v1/repositories/【镜像名】/tags

# 如 centos 的全部镜像标签
https://registry.hub.docker.com/v1/repositories/centos/tags

# 用户 babygod 仓库中 centos-ssh 标签
https://registry.hub.docker.com/v1/repositories/babygod/centos-ssh/tags

接口返回的数据为 json 数据，能够经过 jq 等工具进行格式转换python

[root@test-02 ~] curl -s https://registry.hub.docker.com/v1/repositories/babygod/centos-ssh/tags | jq .
[
  {
    "layer": "",
    "name": "latest"
  },
  {
    "layer": "",
    "name": "v1"
  }
]

[root@test-02 ~] curl -s https://registry.hub.docker.com/v1/repositories/babygod/centos-ssh/tags | jq -r .[].name
latest
v1

经过脚原本获取标签git

[root@test-02 ~]# cat dockertags.sh 
#!/bin/bash
#

usage() {
    cat << HELP

$0  --  list all tags for a Docker image on a remote registry.

EXAMPLE:
    - list all tags for centos:
       $0 centos

    - list all php tags containing apache:
       $0 php apache

HELP
}

if [ $# -lt 1 ]; then
    usage
    exit
fi

image="$1"
tags=$(curl -s https://registry.hub.docker.com/v1/repositories/${image}/tags | jq -r .[].name)

if [ -n "$2" ]
then
    tags=$(echo "${tags}" | fgrep "$2")
fi

echo "${tags}"

# 用法以下
[root@test-02 ~]# ./dockertags.sh babygod/centos-ssh
latest
v1

Ref

https://www.liaoyongfu.com/2018/11/d0d9ca71-85b1-4976-8291-3f0efb8f7a8c/

2、经过 docker hub v2 api 接口

此接口获取的信息比较多，包括 tag name，full_size 等等github

# 查询 URL 为 ( 将 page_size 设置一个比较大的值 )
https://hub.docker.com/v2/repositories/library/【镜像名】/tags/?page_size=10000

# 如 centos 
https://hub.docker.com/v2/repositories/library/centos/tags/?page_size=100000

# 用户 babygod 仓库中 centos-ssh 
https://hub.docker.com/v2/repositories/babygod/centos-ssh/tags/?page_size=1000

# 注意：默认是 library，若是某个用户的话，就须要把 library 改为相应的用户名，如上面把 library 改为 babyggod

接口返回的数据一样为 json 数据，能够经过 jq 等工具进行格式转换docker

[root@test-02 ~]# curl -s https://hub.docker.com/v2/repositories/babygod/centos-ssh/tags/?page_size=10000 | jq .

# 获取标签名
[root@test-02 ~]# curl -s https://hub.docker.com/v2/repositories/babygod/centos-ssh/tags/?page_size=10000 | jq -r .results[].name                       
latest
v1

# 获取镜像大小
[root@test-02 ~]# curl -s https://hub.docker.com/v2/repositories/babygod/centos-ssh/tags/?page_size=10000 | jq -r .results[].full_size                  
82550131
82287724

# 获取对应标签和大小
[root@test-02 ~]# curl -s https://hub.docker.com/v2/repositories/babygod/centos-ssh/tags/?page_size=10000 | jq -r '.results[]|[.name,.full_size|tostring]|join(": ")' 
latest: 82550131
v1: 82287724

经过脚原本获取标签和大小apache

[root@test-02 ~]# cat dockertags_size.sh 
#!/bin/bash
#

usage() {
    cat << HELP

$0  --  list all tags and full_size for a Docker image on a remote registry.

EXAMPLE:
    - list all tags and full_size for centos:
       $0 centos

HELP
}

if [ $# -lt 1 ]; then
    usage
    exit
fi

fgrep -q '/' <<< "$1" && {
    image="$1"
    } || {
    image="library/$1"
}    

tags_size=$(curl -s https://hub.docker.com/v2/repositories/${image}/tags/?page_size=10000 | \
          jq -r '.results[]|[.name,.full_size|tostring]|join(" ")')

echo "${tags_size}" | awk '{printf "%-20s %.2fMB\n",$1,$2/1000000}'

# 用法以下
[root@test-02 ~]# ./dockertags_size.sh babygod/centos-ssh
latest               82.55MB
v1                   82.29MB

python 脚本json

#!/usr/bin/env python

from sys import argv
import requests

def help_text():
    text = '''
    {0} -- list all tags and full_size for a Docker image on a remote registry.
    EXAMPLE:
        - list all tags and full_size for centos:
           {0} centos
    '''.format(argv[0])
    print(text)

def get_json(url):
    results = requests.get(url).json()     
    return results

def get_results():
    results = get_json(url)
    for i in results["results"]:
        print("%-20s %.2fMB" % (i["name"], i["full_size"] / 1000000))

    next_url = results["next"]
    while next_url:
        results = get_json(next_url)
        for n in results["results"]:
            print("%-20s %.2fMB" % (n["name"], n["full_size"] / 1000000))
        next_url = results["next"]

def check_if_in_any(string, iterable):
    return any(map(lambda item: item == string, iterable))

if __name__ == '__main__':
    if len(argv) < 2 or any([check_if_in_any(x, ['-h', '--help']) for x in argv]):
        help_text()
        exit(1)

    image = argv[1] if '/' in argv[1] else 'library/' + argv[1]
    url = "https://hub.docker.com/v2/repositories/" + image + "/tags/?page_size=100"
    try:
        get_results()
    except KeyError:
        exit('Please enter the correct image name! ')