列出鏡像
列出鏡像,有兩個可選參數,一個是all,一個是filter,all可選值有,0/False/false,1/True/true,默覺得0;filter是一個包括一個過濾對象的json,形式如‘{"dangling":["true"]}'
GET /images/json
我們能夠嘗試請求一下
curl -s -XGET theegg.me/docker/images/json?all=0 | python -mjson.tool
能夠看到例如以下的返回值:
[ { "Created": 1405461399, "Id": "88b42ffd1f7cc87c46edf70924b3e24f18da0eb69337deff4db2979d6e1032d8", "ParentId": "c69cab00d6ef21152755a3de928625d7a02860ebe918b8fe9d1dd6aba15229b2", "RepoTags": [ "fedora:latest" ], "Size": 373742581, "VirtualSize": 373742581 }, { "Created": 1403128361, "Id": "e54ca5efa2e962582a223ca9810f7f1b62ea9b5c3975d14a5da79d3bf6020f37", "ParentId": "6c37f792ddacad573016e6aea7fc9fb377127b4767ce6104c9f869314a12041e", "RepoTags": [ "ubuntu:latest" ], "Size": 8, "VirtualSize": 276100357 } ]
返回值相應的含義:
Created:創建的時間,這是一個UNIX時間,以1970為起點,單位為秒
Id:是一個SHA256值,是該鏡像的標識。
ParentId:是一個SHA256值,是該鏡像的父鏡像的標識。
RepoTags:是一個字符串數組,是標明在倉庫中它的標簽。一個鏡像可能會帶有多個標簽。
Size:是鏡像的實際的大小,即鏡像占硬盤空間的大小。
VirtualSize:是鏡像的虛擬大小,或者就是鏡像的大小。鏡像的實際大小為父鏡像的虛擬大小減去該鏡像的虛擬大小。
創建鏡像
POST /images/create
請求參數:
- **fromImage** – 鏡像的名字 - **fromSrc** – 鏡像的來源,即標準輸入 - **repo** – 倉庫 - **tag** – 標簽 - **registry** – 從哪個registry
演示樣例請求:
curl -s -XPOST theegg.me/docker/images/create?fromImage=base
返回:
開始:
{ "status": "Pulling repository base" }
過程中:
{ "status": "Downloading", "progressDetail": { "current": 528384, "total": 94863360, "start": 1405907686 }, "progress": "[> ] 528.4 kB/94.86 MB 6m30s", "id": "27cf78414709" }
出錯時:(來自官方文檔,但實際curl操作的時候是顯示504超時,原因還沒有查明)
{"error":"Invalid..."}
返回值含義:
status:表示狀態,當前操作狀態
progressDetail:表示進度細節,里面包括三個值,current當前位置,total總共多少,start從何處開始
progress:表示進度,是一個能直接輸出的進度顯示條(ascii圖)
id:標示符
error:出錯信息
插入文件到鏡像中
POST /images/(name)/insert將url指定的文件插入到名字為name的鏡像的路徑path中
演示樣例請求:
不清楚為什么無法請求
檢查鏡像
GET /images/(name)/json
返回一些指定鏡像名的底層信息
演示樣例請求:
curl -s -XGET theegg.me/docker/images/base/json | python -mjson.tool
{ "Architecture": "", "Author": "", "Comment": "", "Config": null, "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", "ContainerConfig": { "AttachStderr": false, "AttachStdin": false, "AttachStdout": false, "Cmd": [ "/bin/bash" ], "CpuShares": 0, "Cpuset": "", "Domainname": "", "Entrypoint": null, "Env": null, "ExposedPorts": null, "Hostname": "", "Image": "base", "Memory": 0, "MemorySwap": 0, "NetworkDisabled": false, "OnBuild": null, "OpenStdin": true, "PortSpecs": null, "StdinOnce": false, "Tty": true, "User": "", "Volumes": null, "WorkingDir": "" }, "Created": "2013-03-23T22:24:18.818426-07:00", "DockerVersion": "", "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", "Os": "", "Parent": "27cf784147099545", "Size": 77 }
返回值解析:
Architecture:架構
Author:作者
Comment:評注
Config:配置
Container:當前使用該鏡像的容器
ContainerConfig:容器的配置
Created:創建時間
DockerVersion:Docker的版本號
Id:Id值
Os:操作系統
Parent:父鏡像的Id
Size:大小
ContainerConfig中:
AttachStderr:錯誤輸出是否有附著
AttachStdin:標準輸入是否有附著
AttachStdout:標準輸出是否有附著
Cmd:運行的命令,是一個數組
CpuShares:共享CPU值
Cpuset:所屬CPU集合
Domainname:域名
Entrypoint:實體點
Env:環境
ExposedPorts:對外暴露的port
Hostname:主機名
Image:鏡像名
Memory:內存占用
MemorySwap:內存交換
NetworkDisabled:是否禁用網絡
OnBuild:在構建
OpenStdin:是否打開標準輸入
PortSpecs:指定port
StdinOnce:以前使用標準輸入
Tty:是否使用TTY
User:用戶
Volumes: 使用卷
WorkingDir:工作文件夾
返回狀態碼:
200:沒有錯誤
404:沒有找到指定鏡像
500:server錯誤
獲取鏡像歷史
GET /images/(name)/history
返回鏡像name的歷史
演示樣例請求:
curl -XGET -s theegg.me/docker/images/base/history | python -mjson.tool [ { "Created": 1364102658, "CreatedBy": "/bin/bash", "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", "Size": 77, "Tags": [ "base:latest", "base:ubuntu-12.10", "base:ubuntu-quantal", "base:ubuntu-quantl" ] }, { "Created": 1364068391, "CreatedBy": "", "Id": "27cf784147099545", "Size": 175306958, "Tags": null } ]
返回值:
是一個數組,表示一系列鏡像
返回狀態碼:
200:沒有錯誤
404:沒有找到指定鏡像
500:server錯誤
上傳鏡像到registry
POST /images/(name)/push
將名為name的鏡像上傳到registry
請求參數:
registry:你想要上傳到的registry
請求頭部:
X-Registry-Auth:包括一個base64編碼的AuthConfig對象,即{'username': string, 'password': string, 'email': string, 'serveraddress' : string}
返回狀態碼:
返回狀態碼:
200:沒有錯誤
404:沒有找到指定鏡像
500:server錯誤
將鏡像打上倉庫的標簽
POST /images/(name)/tag
將名為name的鏡像打上倉庫的標簽
curl -XPOST theegg.me/docker/images/base/tag?repo=a -i
HTTP/1.1 201 Created Server: nginx Date: Tue, 29 Jul 2014 02:26:24 GMT Content-Type: text/plain; charset=utf-8 Content-Length: 0 Connection: keep-alive
請求參數:
repo:指定要打的標簽的倉庫名
force:是否強制,默覺得false
返回狀態碼:
201:沒有錯誤
400:參數有誤
404:沒有找到指定的鏡像
409:矛盾
500:server錯誤
刪除一個鏡像
DELETE /images/(name)
從文件系統上刪除名為name的鏡像
curl -XDELETE theegg.me/docker/images/base [ { "Untagged": "base:latest" } ]
請求參數:
force:是否強制
noprune:是否啰嗦(待確定)
返回狀態碼:
200:沒有錯誤
404:沒有找到指定鏡像
500:server錯誤
搜索鏡像
GET /images/search
在Docker Hub上搜索指定鏡像
演示樣例請求:
curl -XGET -s theegg.me/docker/images/search?term=sshd | python -mjson.tool
[ { "description": "SSH Daemon created in the ssh daemon documentation example", "is_official": false, "is_trusted": false, "name": "dhrp/sshd", "star_count": 5 }, { "description": "Ubuntu 13.10 with openssh based on the stackbrew/ubuntu:13.10 image.", "is_official": false, "is_trusted": false, "name": "stephens/sshd", "star_count": 2 },... ]
返回的是一個鏡像數組,每一個鏡像有:
description:描寫敘述信息
is_official:是否官方
is_trusted:是否受信任
name:名字
star_count:標星數
返回狀態碼:
200:沒有錯誤
500:server錯誤
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索:z360901061

微信掃一掃加我為好友
QQ號聯系: 360901061
您的支持是博主寫作最大的動力,如果您喜歡我的文章,感覺我的文章對您有幫助,請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點擊下面給點支持吧,站長非常感激您!手機微信長按不能支付解決辦法:請將微信支付二維碼保存到相冊,切換到微信,然后點擊微信右上角掃一掃功能,選擇支付二維碼完成支付。
【本文對您有幫助就好】元
