github.com/lacework-dev/go-moby@v20.10.12+incompatible/integration-cli/daemon/daemon.go (about) 1 package daemon // import "github.com/docker/docker/integration-cli/daemon" 2 3 import ( 4 "fmt" 5 "strings" 6 "testing" 7 "time" 8 9 "github.com/docker/docker/testutil/daemon" 10 "github.com/pkg/errors" 11 "gotest.tools/v3/assert" 12 "gotest.tools/v3/icmd" 13 ) 14 15 // Daemon represents a Docker daemon for the testing framework. 16 type Daemon struct { 17 *daemon.Daemon 18 dockerBinary string 19 } 20 21 // New returns a Daemon instance to be used for testing. 22 // This will create a directory such as d123456789 in the folder specified by $DOCKER_INTEGRATION_DAEMON_DEST or $DEST. 23 // The daemon will not automatically start. 24 func New(t testing.TB, dockerBinary string, dockerdBinary string, ops ...daemon.Option) *Daemon { 25 t.Helper() 26 ops = append(ops, daemon.WithDockerdBinary(dockerdBinary)) 27 d := daemon.New(t, ops...) 28 return &Daemon{ 29 Daemon: d, 30 dockerBinary: dockerBinary, 31 } 32 } 33 34 // Cmd executes a docker CLI command against this daemon. 35 // Example: d.Cmd("version") will run docker -H unix://path/to/unix.sock version 36 func (d *Daemon) Cmd(args ...string) (string, error) { 37 result := icmd.RunCmd(d.Command(args...)) 38 return result.Combined(), result.Error 39 } 40 41 // Command creates a docker CLI command against this daemon, to be executed later. 42 // Example: d.Command("version") creates a command to run "docker -H unix://path/to/unix.sock version" 43 func (d *Daemon) Command(args ...string) icmd.Cmd { 44 return icmd.Command(d.dockerBinary, d.PrependHostArg(args)...) 45 } 46 47 // PrependHostArg prepend the specified arguments by the daemon host flags 48 func (d *Daemon) PrependHostArg(args []string) []string { 49 for _, arg := range args { 50 if arg == "--host" || arg == "-H" { 51 return args 52 } 53 } 54 return append([]string{"--host", d.Sock()}, args...) 55 } 56 57 // GetIDByName returns the ID of an object (container, volume, …) given its name 58 func (d *Daemon) GetIDByName(name string) (string, error) { 59 return d.inspectFieldWithError(name, "Id") 60 } 61 62 // InspectField returns the field filter by 'filter' 63 func (d *Daemon) InspectField(name, filter string) (string, error) { 64 return d.inspectFilter(name, filter) 65 } 66 67 func (d *Daemon) inspectFilter(name, filter string) (string, error) { 68 format := fmt.Sprintf("{{%s}}", filter) 69 out, err := d.Cmd("inspect", "-f", format, name) 70 if err != nil { 71 return "", errors.Errorf("failed to inspect %s: %s", name, out) 72 } 73 return strings.TrimSpace(out), nil 74 } 75 76 func (d *Daemon) inspectFieldWithError(name, field string) (string, error) { 77 return d.inspectFilter(name, fmt.Sprintf(".%s", field)) 78 } 79 80 // CheckActiveContainerCount returns the number of active containers 81 // FIXME(vdemeester) should re-use ActivateContainers in some way 82 func (d *Daemon) CheckActiveContainerCount(t *testing.T) (interface{}, string) { 83 t.Helper() 84 out, err := d.Cmd("ps", "-q") 85 assert.NilError(t, err) 86 if len(strings.TrimSpace(out)) == 0 { 87 return 0, "" 88 } 89 return len(strings.Split(strings.TrimSpace(out), "\n")), fmt.Sprintf("output: %q", out) 90 } 91 92 // WaitRun waits for a container to be running for 10s 93 func (d *Daemon) WaitRun(contID string) error { 94 args := []string{"--host", d.Sock()} 95 return WaitInspectWithArgs(d.dockerBinary, contID, "{{.State.Running}}", "true", 10*time.Second, args...) 96 } 97 98 // WaitInspectWithArgs waits for the specified expression to be equals to the specified expected string in the given time. 99 // Deprecated: use cli.WaitCmd instead 100 func WaitInspectWithArgs(dockerBinary, name, expr, expected string, timeout time.Duration, arg ...string) error { 101 after := time.After(timeout) 102 103 args := append(arg, "inspect", "-f", expr, name) 104 for { 105 result := icmd.RunCommand(dockerBinary, args...) 106 if result.Error != nil { 107 if !strings.Contains(strings.ToLower(result.Stderr()), "no such") { 108 return errors.Errorf("error executing docker inspect: %v\n%s", 109 result.Stderr(), result.Stdout()) 110 } 111 select { 112 case <-after: 113 return result.Error 114 default: 115 time.Sleep(10 * time.Millisecond) 116 continue 117 } 118 } 119 120 out := strings.TrimSpace(result.Stdout()) 121 if out == expected { 122 break 123 } 124 125 select { 126 case <-after: 127 return errors.Errorf("condition \"%q == %q\" not true in time (%v)", out, expected, timeout) 128 default: 129 } 130 131 time.Sleep(100 * time.Millisecond) 132 } 133 return nil 134 }