自動(dòng)化運(yùn)維 docker remote api探究

chenatu 發(fā)布于2019-05-28 16:43 / 2280人閱讀

摘要：原文來自注釋譯文和原文對應(yīng)的版本為，普發(fā)行版的維護(hù)版本大多在左右，沒有翻譯最新版本對應(yīng)的文檔。的參數(shù)是容器，文檔提供的是十二位的，而實(shí)際是位的。參數(shù)講解晚上換再翻譯。。

原文來自 Docker Remote API v1.5

  注釋：譯文和原文對應(yīng)的docker版本為1.5，普發(fā)行版的維護(hù)版本大多在1.5左右，沒有翻譯docker最新版本1.17對應(yīng)的文檔。

1.簡介

1.docker remote api主要的目的是取代命令行界面.
2.docker服務(wù)進(jìn)程默認(rèn)監(jiān)聽unix:///var/run/docker.sock，也可以監(jiān)聽其他的端口和其他的unix socket
3.API盡量做到RESTful，盡量將全部的輸出都輸出給接口，但是一些復(fù)雜的命令，例如docker pull，docker attach，還是會不可避免地要輸出到stdout，stderr和stdin

2.分類 2.1容器

列出容器

GET /containers/json

使用示例：

GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
返回值：

    HTTP/1.1 200 OK
    Content-Type: application/json

    [
         {
                 "Id": "8dfafdbc3a40",
                 "Image": "ubuntu:latest",
                 "Command": "echo 1",
                 "Created": 1367854155,
                 "Status": "Exit 0",
                 "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}],
                 "SizeRw": 12288,
                 "SizeRootFs": 0
         },
         {
                 "Id": "9cd87474be90",
                 "Image": "ubuntu:latest",
                 "Command": "echo 222222",
                 "Created": 1367854155,
                 "Status": "Exit 0",
                 "Ports": [],
                 "SizeRw": 12288,
                 "SizeRootFs": 0
         },
         {
                 "Id": "3176a2479c92",
                 "Image": "ubuntu:latest",
                 "Command": "echo 3333333333333333",
                 "Created": 1367854154,
                 "Status": "Exit 0",
                 "Ports":[],
                 "SizeRw":12288,
                 "SizeRootFs":0
         },
         {
                 "Id": "4cb07b47f9fb",
                 "Image": "ubuntu:latest",
                 "Command": "echo 444444444444444444444444444444444",
                 "Created": 1367854152,
                 "Status": "Exit 0",
                 "Ports": [],
                 "SizeRw": 12288,
                 "SizeRootFs": 0
         }
    ]

  備注：提供一個(gè)比較能接受的實(shí)例：

  1.docker監(jiān)聽127.0.0.1:4243

  2.curl -s "127.0.0.1:4243/containers/json"或者curl -s "127.0.0.1:4243/containers/json"|python -m json.tool進(jìn)行格式化。

  3.before的參數(shù)是容器ID，文檔提供的是十二位的id，而實(shí)際是64位的d。