github.com/tonistiigi/docker@v0.10.1-0.20240229224939-974013b0dc6a/integration/container/kill_test.go (about)

     1  package container // import "github.com/docker/docker/integration/container"
     2  
     3  import (
     4  	"runtime"
     5  	"testing"
     6  	"time"
     7  
     8  	containertypes "github.com/docker/docker/api/types/container"
     9  	"github.com/docker/docker/integration/internal/container"
    10  	"github.com/docker/docker/testutil"
    11  	"github.com/docker/docker/testutil/request"
    12  	"gotest.tools/v3/assert"
    13  	is "gotest.tools/v3/assert/cmp"
    14  	"gotest.tools/v3/poll"
    15  	"gotest.tools/v3/skip"
    16  )
    17  
    18  func TestKillContainerInvalidSignal(t *testing.T) {
    19  	ctx := setupTest(t)
    20  	apiClient := testEnv.APIClient()
    21  	id := container.Run(ctx, t, apiClient)
    22  
    23  	err := apiClient.ContainerKill(ctx, id, "0")
    24  	assert.ErrorContains(t, err, "Error response from daemon:")
    25  	assert.ErrorContains(t, err, "nvalid signal: 0") // match "(I|i)nvalid" case-insensitive to allow testing against older daemons.
    26  	poll.WaitOn(t, container.IsInState(ctx, apiClient, id, "running"), poll.WithDelay(100*time.Millisecond))
    27  
    28  	err = apiClient.ContainerKill(ctx, id, "SIG42")
    29  	assert.ErrorContains(t, err, "Error response from daemon:")
    30  	assert.ErrorContains(t, err, "nvalid signal: SIG42") // match "(I|i)nvalid" case-insensitive to allow testing against older daemons.
    31  	poll.WaitOn(t, container.IsInState(ctx, apiClient, id, "running"), poll.WithDelay(100*time.Millisecond))
    32  }
    33  
    34  func TestKillContainer(t *testing.T) {
    35  	ctx := setupTest(t)
    36  	apiClient := testEnv.APIClient()
    37  
    38  	testCases := []struct {
    39  		doc    string
    40  		signal string
    41  		status string
    42  		skipOs string
    43  	}{
    44  		{
    45  			doc:    "no signal",
    46  			signal: "",
    47  			status: "exited",
    48  			skipOs: "",
    49  		},
    50  		{
    51  			doc:    "non killing signal",
    52  			signal: "SIGWINCH",
    53  			status: "running",
    54  			skipOs: "windows",
    55  		},
    56  		{
    57  			doc:    "killing signal",
    58  			signal: "SIGTERM",
    59  			status: "exited",
    60  			skipOs: "",
    61  		},
    62  	}
    63  
    64  	var pollOpts []poll.SettingOp
    65  	if runtime.GOOS == "windows" {
    66  		pollOpts = append(pollOpts, poll.WithTimeout(StopContainerWindowsPollTimeout))
    67  	}
    68  
    69  	for _, tc := range testCases {
    70  		tc := tc
    71  		t.Run(tc.doc, func(t *testing.T) {
    72  			skip.If(t, testEnv.DaemonInfo.OSType == tc.skipOs, "Windows does not support SIGWINCH")
    73  			ctx := testutil.StartSpan(ctx, t)
    74  			id := container.Run(ctx, t, apiClient)
    75  			err := apiClient.ContainerKill(ctx, id, tc.signal)
    76  			assert.NilError(t, err)
    77  
    78  			poll.WaitOn(t, container.IsInState(ctx, apiClient, id, tc.status), pollOpts...)
    79  		})
    80  	}
    81  }
    82  
    83  func TestKillWithStopSignalAndRestartPolicies(t *testing.T) {
    84  	ctx := setupTest(t)
    85  	apiClient := testEnv.APIClient()
    86  
    87  	testCases := []struct {
    88  		doc        string
    89  		stopsignal string
    90  		status     string
    91  	}{
    92  		{
    93  			doc:        "same-signal-disables-restart-policy",
    94  			stopsignal: "TERM",
    95  			status:     "exited",
    96  		},
    97  		{
    98  			doc:        "different-signal-keep-restart-policy",
    99  			stopsignal: "CONT",
   100  			status:     "running",
   101  		},
   102  	}
   103  
   104  	var pollOpts []poll.SettingOp
   105  	if runtime.GOOS == "windows" {
   106  		pollOpts = append(pollOpts, poll.WithTimeout(StopContainerWindowsPollTimeout))
   107  	}
   108  
   109  	for _, tc := range testCases {
   110  		tc := tc
   111  		t.Run(tc.doc, func(t *testing.T) {
   112  			ctx := testutil.StartSpan(ctx, t)
   113  			id := container.Run(ctx, t, apiClient,
   114  				container.WithRestartPolicy(containertypes.RestartPolicyAlways),
   115  				func(c *container.TestContainerConfig) {
   116  					c.Config.StopSignal = tc.stopsignal
   117  				})
   118  			err := apiClient.ContainerKill(ctx, id, "TERM")
   119  			assert.NilError(t, err)
   120  
   121  			poll.WaitOn(t, container.IsInState(ctx, apiClient, id, tc.status), pollOpts...)
   122  		})
   123  	}
   124  }
   125  
   126  func TestKillStoppedContainer(t *testing.T) {
   127  	ctx := setupTest(t)
   128  	apiClient := testEnv.APIClient()
   129  	id := container.Create(ctx, t, apiClient)
   130  	err := apiClient.ContainerKill(ctx, id, "SIGKILL")
   131  	assert.Assert(t, is.ErrorContains(err, ""))
   132  	assert.Assert(t, is.Contains(err.Error(), "is not running"))
   133  }
   134  
   135  func TestKillDifferentUserContainer(t *testing.T) {
   136  	// TODO Windows: Windows does not yet support -u (Feb 2016).
   137  	skip.If(t, testEnv.DaemonInfo.OSType == "windows", "User containers (container.Config.User) are not yet supported on %q platform", testEnv.DaemonInfo.OSType)
   138  
   139  	ctx := setupTest(t)
   140  	apiClient := request.NewAPIClient(t)
   141  
   142  	id := container.Run(ctx, t, apiClient, func(c *container.TestContainerConfig) {
   143  		c.Config.User = "daemon"
   144  	})
   145  
   146  	err := apiClient.ContainerKill(ctx, id, "SIGKILL")
   147  	assert.NilError(t, err)
   148  	poll.WaitOn(t, container.IsInState(ctx, apiClient, id, "exited"), poll.WithDelay(100*time.Millisecond))
   149  }
   150  
   151  func TestInspectOomKilledTrue(t *testing.T) {
   152  	skip.If(t, testEnv.DaemonInfo.OSType == "windows")
   153  	skip.If(t, testEnv.DaemonInfo.CgroupDriver == "none")
   154  	skip.If(t, !testEnv.DaemonInfo.MemoryLimit || !testEnv.DaemonInfo.SwapLimit)
   155  	skip.If(t, testEnv.DaemonInfo.CgroupVersion == "2", "FIXME: flaky on cgroup v2 (https://github.com/moby/moby/issues/41929)")
   156  
   157  	ctx := setupTest(t)
   158  	apiClient := testEnv.APIClient()
   159  
   160  	cID := container.Run(ctx, t, apiClient, container.WithCmd("sh", "-c", "x=a; while true; do x=$x$x$x$x; done"), func(c *container.TestContainerConfig) {
   161  		c.HostConfig.Resources.Memory = 32 * 1024 * 1024
   162  	})
   163  
   164  	poll.WaitOn(t, container.IsInState(ctx, apiClient, cID, "exited"), poll.WithDelay(100*time.Millisecond))
   165  
   166  	inspect, err := apiClient.ContainerInspect(ctx, cID)
   167  	assert.NilError(t, err)
   168  	assert.Check(t, is.Equal(true, inspect.State.OOMKilled))
   169  }
   170  
   171  func TestInspectOomKilledFalse(t *testing.T) {
   172  	skip.If(t, testEnv.DaemonInfo.OSType == "windows" || !testEnv.DaemonInfo.MemoryLimit || !testEnv.DaemonInfo.SwapLimit)
   173  
   174  	ctx := setupTest(t)
   175  	apiClient := testEnv.APIClient()
   176  
   177  	cID := container.Run(ctx, t, apiClient, container.WithCmd("sh", "-c", "echo hello world"))
   178  
   179  	poll.WaitOn(t, container.IsInState(ctx, apiClient, cID, "exited"), poll.WithDelay(100*time.Millisecond))
   180  
   181  	inspect, err := apiClient.ContainerInspect(ctx, cID)
   182  	assert.NilError(t, err)
   183  	assert.Check(t, is.Equal(false, inspect.State.OOMKilled))
   184  }