4f0d95fa |
package client // import "github.com/docker/docker/client" |
7c36a1af |
import ( |
7d62e40f |
"context" |
7c36a1af |
"encoding/json" |
49211715 |
"net/url" |
7c36a1af |
|
181562c2 |
"github.com/docker/docker/api/types/container" |
49211715 |
"github.com/docker/docker/api/types/versions" |
7c36a1af |
)
|
2b62eb43 |
// ContainerWait waits until the specified container is in a certain state |
49211715 |
// indicated by the given condition, either "not-running" (default),
// "next-exit", or "removed".
// |
39bcaee4 |
// If this client's API version is before 1.30, condition is ignored and |
49211715 |
// ContainerWait will return immediately with the two channels, as the server
// will wait as if the condition were "not-running".
//
// If this client's API version is at least 1.30, ContainerWait blocks until
// the request has been acknowledged by the server (with a response header),
// then returns two channels on which the caller can wait for the exit status
// of the container or an error if there was a problem either beginning the
// wait request or in getting the response. This allows the caller to |
39bcaee4 |
// synchronize ContainerWait with other calls, such as specifying a |
49211715 |
// "next-exit" condition before issuing a ContainerStart request.
func (cli *Client) ContainerWait(ctx context.Context, containerID string, condition container.WaitCondition) (<-chan container.ContainerWaitOKBody, <-chan error) {
if versions.LessThan(cli.ClientVersion(), "1.30") {
return cli.legacyContainerWait(ctx, containerID) |
7c36a1af |
}
|
49211715 |
resultC := make(chan container.ContainerWaitOKBody) |
4d2d2ea3 |
errC := make(chan error, 1) |
49211715 |
query := url.Values{}
query.Set("condition", string(condition))
resp, err := cli.post(ctx, "/containers/"+containerID+"/wait", query, nil, nil)
if err != nil {
defer ensureReaderClosed(resp)
errC <- err
return resultC, errC |
7c36a1af |
}
|
49211715 |
go func() {
defer ensureReaderClosed(resp)
var res container.ContainerWaitOKBody
if err := json.NewDecoder(resp.body).Decode(&res); err != nil {
errC <- err
return
}
resultC <- res
}()
return resultC, errC
}
// legacyContainerWait returns immediately and doesn't have an option to wait
// until the container is removed.
func (cli *Client) legacyContainerWait(ctx context.Context, containerID string) (<-chan container.ContainerWaitOKBody, <-chan error) {
resultC := make(chan container.ContainerWaitOKBody)
errC := make(chan error)
go func() {
resp, err := cli.post(ctx, "/containers/"+containerID+"/wait", nil, nil, nil)
if err != nil {
errC <- err
return
}
defer ensureReaderClosed(resp)
var res container.ContainerWaitOKBody
if err := json.NewDecoder(resp.body).Decode(&res); err != nil {
errC <- err
return
}
resultC <- res
}()
return resultC, errC |
7c36a1af |
} |