Docker API

2017年08月23日 10:03 | 2396次浏览

纵观我们的Docker系列教程,我们已经讨论了很多重要的Docker组件与命令。在本文中,我们将继续深入学习Docker:剖析Docker APIs。

Docker提供了很多的API以便用户使用。这些API包含四个方面:

  • Docker Registry API

  • Docker Hub API

  • Docker OAuth API

  • Docker Remote API

具体到这篇文章,我们将讨论Docker Registry API以及Docker Hub API。


Docker Registry API

Docker Registry API是Docker Registry的REST API,它简化了镜像和仓库的存储。该API不能访问用户帐户或者获得授权。你可以阅读Docker系列教程的第四章,以了解更多有关Registry的类型(译者注:Docker中有几种不同的Registry)。

Extract image layer:

取出镜像层:

GET /v1/images/(image_id)/layer


Insert image layer:

插入镜像层:

PUT /v1/images/(image_id)/layer


Retrieve an image:

检索镜像:

GET /v1/images/(image_id)/json


Retrieve roots of an image:

检索根镜像:

GET /v1/images/(image_id)/ancestry


Obtain all tags or specific tag of a repository:

获取库里所有的标签或者指定标签:

GET /v1/repositories/(namespace)/(repository)/tags

或者

GET /v1/repositories/(namespace)/(repository)/tags/(tag*)


Delete a tag:

删除标签:

DELETE /v1/repositories/(namespace)/(repository)/tags/(tag*)


Status check of registry:

registry状态检查:

GET /v1/_ping


Docker Hub API

Docker Hub API是Docker Hub的一个简单的REST API。再提醒一下,请参考Docker系列教程的第四篇文章了解Docker Hub。Docker Hub 通过管理校验(checksums)以及公共命名空间(public namespaces)来控制着用户帐户和授权。该API还支持有关用户仓库和library仓库的操作。

首先,让我们来看看特殊的library仓库(需要管理员权限)的命令:

1. 创建一个新的仓库。使用以下命令可以创建新的library仓库:

PUT /v1/repositories/(repo_name)/

其中,repo_name是新的仓库名称。

2. 删除已经存在的仓库。命令如下:

DELETE /v1/repositories/(repo_name)/

其中,repo_name是要删除的仓库名称。

3. 更新仓库镜像。命令如下:

PUT /v1/repositories/(repo_name)/images

4. 从仓库中获取镜像。命令如下:

GET /v1/repositories/(repo_name)/images

5. 授权。使用Token获取仓库授权,如下:

PUT /v1/repositories/(repo_name)/auth

接下来,让我们来看看用户仓库的命令。library仓库与用户仓库命令之间的主要区别是命名空间的使用。


1.创建用户仓库。命令如下:

PUT /v1/repositories/(namespace)/(repo_name)/


2.删除用户仓库,命令如下:

DELETE /v1/repositories/(namespace)/(repo_name)/


3.更新用户仓库镜像,命令如下:

PUT /v1/repositories/(namespace)/(repo_name)/images


4.从仓库中下载镜像。如下:

GET /v1/repositories/(namespace)/(repo_name)/images


5.验证用户登录,如下:

GET /v1/users


6.添加新用户,命令如下:

POST /v1/users


7.更新用户信息,如下:

PUT /v1/users/(username)/


现在,我们已经走过了Docker API之旅的第一站,第二站是有关Docker OAuth以及Remote API的内容,我们将在Docker系列教程的下一篇见。



小说《我是全球混乱的源头》

感觉本站内容不错,读后有收获?小额赞助,鼓励网站分享出更好的教程