Docker Engine API开发教程

Docker提供了一个API（称为Docker engine API），用于与Docker守护进程交互，并且还提供了Go和Python的SDK。通过使用这些SDK，您可以迅速构建和扩展Docker应用程序和解决方案。如果您不使用Go或Python，也可以直接调用Docker engine API。

Docker engine API是一种RESTful API，可以通过HTTP客户端（如wget或curl）或HTTP库来访问。

API和SDK的版本管理

您所使用的Docker engine API版本应与Docker守护程序和Docker客户端的版本相匹配。

特定版本的Docker engine SDK支持相应版本的Docker engine API，以及所有之前的版本。如有重大变化，会在显著位置进行记录。

Docker守护程序和客户端不必保持相同版本，但请注意以下几点：

1. 如果守护程序版本高于客户端，客户端将不知道守护程序中的新功能或不再推荐的API端点。
2. 如果客户端版本高于守护程序，客户端可能会请求守护程序未知的API端点。

随着新功能的添加，新的API版本将发布。Docker API向后兼容，因此除非需要利用新特性，否则不必更新调用该API的代码。

要查看支持的最高API版本，可以使用命令：docker version。

您可以通过以下任一方式指定要使用的API版本：

1. 在使用SDK时，选择最新版本，确保所使用的API版本与所需功能相匹配。
2. 直接使用curl时，可以将版本作为URL的第一部分，例如：/v1.41/containers/。
3. 若要强制Docker CLI或Docker engine SDK使用比API报告的版本更旧的版本，请将环境变量DOCKER_API_version设置为所需版本。这适用于Linux、Windows或MacOS客户端。
4. Docker Go SDK支持API版本协商，自动选择客户端和Docker engine共同支持的API版本。
5. 在SDK中，您也可以通过编程方式指定API版本，作为client对象的参数。请参考Go构造函数或Python SDK文档中的client部分。

[[[IMG_1]]]

[[[IMG_2]]]

[[[IMG_3]]]