あらかじめイメージに埋め込めんでおけないコンテナ固有の設定ファイルを物理ファイルを作成せずにコンテナへコピーしたいと思い、Go言語の Docker Engine SDK API を試そうとしたら手短なサンプルコードが見つからなかったので紹介します。
動作確認環境
- go 1.18.2
- Docker version 20.10.15
- ApiVersion:1.41
コード
NGINX コンテナの index.html を上書きします。
API の CopyToContainer() を使いますが、ドキュメントに次のようにあるので注意ください。
Note that
contentmust be a Reader for a TAR archive
contentは TAR アーカイブの Reader である必要がある
package main
import (
"archive/tar"
"bytes"
"context"
"github.com/docker/docker/api/types"
"github.com/docker/docker/api/types/container"
"github.com/docker/docker/client"
"github.com/docker/go-connections/nat"
"log"
)
func main() {
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
log.Fatal(err)
}
containerName := "my-nginx"
ctx := context.Background()
rsp, err := cli.ContainerCreate(ctx, &container.Config{
Image: "nginx:latest",
Tty: false,
}, &container.HostConfig{
AutoRemove: true,
PortBindings: nat.PortMap{
nat.Port("80/tcp"): []nat.PortBinding{{HostIP: "0.0.0.0", HostPort: "9090/tcp"}},
},
}, nil, nil, containerName)
if err != nil {
log.Fatal(err)
}
html := []byte(`
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Docker copy sample</title>
</head>
<body>
<h1>Hello Docker copy</h1>
</body>
</html>
`)
// TAR アーカイブ作成
var buf bytes.Buffer
tw := tar.NewWriter(&buf)
hdr := &tar.Header{
Name: "/usr/share/nginx/html/index.html",
Mode: 0444,
Size: int64(len(html)),
}
if err = tw.WriteHeader(hdr); err != nil {
log.Fatal(err)
}
if _, err = tw.Write(html); err != nil {
log.Fatal(err)
}
if err = tw.Close(); err != nil {
log.Fatal(err)
}
content := bytes.NewReader(buf.Bytes())
// TAR アーカイブをコンテナへコピー
err = cli.CopyToContainer(ctx, rsp.ID, "/", content, types.CopyToContainerOptions{})
if err != nil {
log.Fatal(err)
}
if err := cli.ContainerStart(ctx, rsp.ID, types.ContainerStartOptions{}); err != nil {
log.Fatal(err)
}
}
実行
$ go mod init ydclab/docker-copy
$ go mod tidy
$ go run main.go
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
9882d97ac986 nginx:latest "/docker-entrypoint.…" About a minute ago Up About a minute 0.0.0.0:9090->80/tcp y-nginx
※ go mod init のモジュールパスは適宜変更ください。
HTML を確認
$ curl localhost:9090
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Docker copy sample</title>
</head>
<body>
<h1>Hello Docker copy</h1>
</body>
</html>
デフォルトの index.html を上書きできました。