moby/client/container_commit.go

package client

import (
	"encoding/json"
	"errors"
	"net/url"

	distreference "github.com/docker/distribution/reference"
	"github.com/docker/docker/api/types"
	"github.com/docker/docker/api/types/reference"
	"golang.org/x/net/context"
)

// ContainerCommit applies changes into a container and creates a new tagged image.
func (cli *Client) ContainerCommit(ctx context.Context, container string, options types.ContainerCommitOptions) (types.ContainerCommitResponse, error) {
	var repository, tag string
	if options.Reference != "" {
		distributionRef, err := distreference.ParseNamed(options.Reference)
		if err != nil {
			return types.ContainerCommitResponse{}, err
		}

		if _, isCanonical := distributionRef.(distreference.Canonical); isCanonical {
			return types.ContainerCommitResponse{}, errors.New("refusing to create a tag with a digest reference")
		}

		tag = reference.GetTagFromNamedRef(distributionRef)
		repository = distributionRef.Name()
	}

	query := url.Values{}
	query.Set("container", container)
	query.Set("repo", repository)
	query.Set("tag", tag)
	query.Set("comment", options.Comment)
	query.Set("author", options.Author)
	for _, change := range options.Changes {
		query.Add("changes", change)
	}
	if options.Pause != true {
		query.Set("pause", "0")
	}

	var response types.ContainerCommitResponse
	resp, err := cli.post(ctx, "/commit", query, options.Config, nil)
	if err != nil {
		return response, err
	}

	err = json.NewDecoder(resp.body).Decode(&response)
	ensureReaderClosed(resp)
	return response, err
}