使用 Docker Engine SDK 进行开发

Docker 提供用于与 Docker 守护程序（称为 Docker Engine API）交互的 API，以及用于 Go 和 Python 的 SDK。SDK 允许您高效地构建和扩展 Docker 应用程序和解决方案。如果 Go 或 Python 不适合您，您可以直接使用 Docker Engine API。

Docker Engine API 是一个 RESTful API，通过 HTTP 客户端（例如 wget 或 curl）或大多数现代编程语言都包含的 HTTP 库进行访问。

安装 SDK

使用以下命令安装 Go 或 Python SDK。两个 SDK 都可以安装并共存。

Go SDK

$ go get github.com/docker/docker/client

客户端需要 Go 的最新版本。运行 go version 并确保您正在运行目前受支持的 Go 版本。

有关更多信息，请参阅 Docker Engine Go SDK 参考。

Python SDK

推荐：运行 pip install docker。
如果您无法使用 pip
1. 直接下载软件包.
2. 解压并进入解压后的目录。
3. 运行 python setup.py install。

有关更多信息，请参阅 Docker Engine Python SDK 参考。

查看 API 参考

您可以查看最新版 API 的参考或选择特定版本。

版本化 API 和 SDK

您应该使用的 Docker Engine API 版本取决于您的 Docker 守护程序和 Docker 客户端的版本。有关详细信息，请参阅 API 文档中的版本化 API 和 SDK 部分。

SDK 和 API 快速入门

使用以下指南选择在代码中使用的 SDK 或 API 版本

如果您正在启动一个新项目，请使用最新版本，但请使用 API 版本协商或指定您正在使用的版本。这有助于防止意外情况。
如果您需要新功能，请更新您的代码以使用至少支持该功能的最低版本，并优先使用您能使用的最新版本。
否则，继续使用您的代码已经使用的版本。

例如，docker run 命令可以直接使用 Docker API 实现，也可以使用 Python 或 Go SDK 实现。

package main

import (
	"context"
	"io"
	"os"

	"github.com/docker/docker/api/types/container"
        "github.com/docker/docker/api/types/image"
	"github.com/docker/docker/client"
	"github.com/docker/docker/pkg/stdcopy"
)

func main() {
    ctx := context.Background()
    cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
    if err != nil {
        panic(err)
    }
    defer cli.Close()

    reader, err := cli.ImagePull(ctx, "docker.io/library/alpine", image.PullOptions{})
    if err != nil {
        panic(err)
    }
    io.Copy(os.Stdout, reader)

    resp, err := cli.ContainerCreate(ctx, &container.Config{
        Image: "alpine",
        Cmd:   []string{"echo", "hello world"},
    }, nil, nil, nil, "")
    if err != nil {
        panic(err)
    }

    if err := cli.ContainerStart(ctx, resp.ID, container.StartOptions{}); err != nil {
        panic(err)
    }

    statusCh, errCh := cli.ContainerWait(ctx, resp.ID, container.WaitConditionNotRunning)
    select {
    case err := <-errCh:
        if err != nil {
            panic(err)
        }
    case <-statusCh:
    }

    out, err := cli.ContainerLogs(ctx, resp.ID, container.LogsOptions{ShowStdout: true})
    if err != nil {
        panic(err)
    }

    stdcopy.StdCopy(os.Stdout, os.Stderr, out)
}

import docker
client = docker.from_env()
print(client.containers.run("alpine", ["echo", "hello", "world"]))

$ curl --unix-socket /var/run/docker.sock -H "Content-Type: application/json" \
  -d '{"Image": "alpine", "Cmd": ["echo", "hello world"]}' \
  -X POST https:///v1.51/containers/create
{"Id":"1c6594faf5","Warnings":null}

$ curl --unix-socket /var/run/docker.sock -X POST https:///v1.51/containers/1c6594faf5/start

$ curl --unix-socket /var/run/docker.sock -X POST https:///v1.51/containers/1c6594faf5/wait
{"StatusCode":0}

$ curl --unix-socket /var/run/docker.sock "https:///v1.51/containers/1c6594faf5/logs?stdout=1"
hello world

当使用 cURL 通过 Unix 套接字连接时，主机名并不重要。前面的示例使用 localhost，但任何主机名都可以。

重要
前面的示例假设您使用的是 cURL 7.50.0 或更高版本。较旧版本的 cURL 在使用套接字连接时使用了非标准 URL 表示法。
如果您使用的是旧版 cURL，请改用 http:/<API 版本>/，例如：http:/v1.51/containers/1c6594faf5/start。

有关更多示例，请查看 SDK 示例。

非官方库

有许多社区支持的其他语言库可用。它们未经 Docker 测试，因此如果您遇到任何问题，请向库维护人员提交。

语言	库
C	libdocker
C#	Docker.DotNet
C++	lasote/docker_client
Clojure	clj-docker-client
Clojure	contajners
Dart	bwu_docker
Erlang	erldocker
Gradle	gradle-docker-plugin
Groovy	docker-client
Haskell	docker-hs
Java	docker-client
Java	docker-java
Java	docker-java-api
Java	jocker
NodeJS	dockerode
NodeJS	harbor-master
NodeJS	the-moby-effect
Perl	Eixo::Docker
PHP	Docker-PHP
Ruby	docker-api
Rust	bollard
Rust	docker-rust
Rust	shiplift
Scala	tugboat
Scala	reactive-docker
Swift	docker-client-swift