【Docker学习】重启容器的docker restart

命令:

docker container restart

描述:

重启一个或多个容器

用法:

复制代码
docker container restart [OPTIONS] CONTAINER [CONTAINER...]

别名:

docker restart(docker的一些命令可以简写,docker restart就等同于docker container restart)

选项:

选项 描述
-s, --signal 给容器发送信号
-t, --time 在容器启动后,等待多少秒之后,如果容器没有按预期运行,则自动终止(kill)容器

实战:

如上图所示,我通过docker ps -a显示所有停止的容器,通过docker restart nginx重启nginx容器,最后docker ps显示nginx的状态为Up。

--signal,--time:

经过多次测试,没有迹象表明这个选项起了作用。网上查询,没有发现有对restart的这个-s选项的任何实战说明。为了一探究竟,只能查看docker源码了。

docker分为客户端和服务器两部分,其中客户端有关restart部分关键源码如下所示:

复制代码
func runRestart(ctx context.Context, dockerCli command.Cli, opts *restartOptions) error {
	var errs []string
	var timeout *int
	if opts.timeoutChanged {
		timeout = &opts.timeout
	}
	for _, name := range opts.containers {
		err := dockerCli.Client().ContainerRestart(ctx, name, container.StopOptions{
			Signal:  opts.signal,
			Timeout: timeout,
		})
		if err != nil {
			errs = append(errs, err.Error())
			continue
		}
		_, _ = fmt.Fprintln(dockerCli.Out(), name)
	}
	if len(errs) > 0 {
		return errors.New(strings.Join(errs, "\n"))
	}
	return nil
}

可以看到Signal和Timeout都是处于StopOptions结构体内。

复制代码
// StopOptions holds the options to stop or restart a container.
type StopOptions struct {
	// Signal (optional) is the signal to send to the container to (gracefully)
	// stop it before forcibly terminating the container with SIGKILL after the
	// timeout expires. If not value is set, the default (SIGTERM) is used.
	Signal string `json:",omitempty"`

	// Timeout (optional) is the timeout (in seconds) to wait for the container
	// to stop gracefully before forcibly terminating it with SIGKILL.
	//
	// - Use nil to use the default timeout (10 seconds).
	// - Use '-1' to wait indefinitely.
	// - Use '0' to not wait for the container to exit gracefully, and
	//   immediately proceeds to forcibly terminating the container.
	// - Other positive values are used as timeout (in seconds).
	Timeout *int `json:",omitempty"`
}

从结构体成员Signal上面的的注释可以看到,只有重启失败,经过timeout时间后,signal才会起作用,优雅地停止容器,然后再用 SIGKILL 强制终止容器。如果没有设置值,则使用默认值(SIGTERM)。

若是自己的容器项目经常因为一些原因而停止,这时可以使用这两个选项控制停止时长,以更快地进行后面的调试(这是我能想到的使用这个选项的一种情境)。

关于--signal和--time的使用,在我上一篇【Docker学习】docker stop深入研究有更为深入的使用,这里就不再演示了。

相关推荐
DO_Community23 分钟前
DigitalOcean Kubernetes 现已支持 Gateway API 托管服务
容器·kubernetes·gateway
脚踏实地的大梦想家43 分钟前
【Docker】P2 Docker环境构建准备:MacOS 与 Linux
linux·macos·docker
尚久龙2 小时前
安卓学习 之 SeekBar(音视频播放进度条)
android·java·学习·手机·android studio
人生游戏牛马NPC1号2 小时前
学习 Android (二十二) 学习 OpenCV (七)
android·opencv·学习
什么都想学的阿超3 小时前
【大语言模型 57】容器化训练环境:Docker + Kubernetes + Slurm
docker·语言模型·kubernetes
敲上瘾3 小时前
Docker网络实战:容器通信与隔离之道
linux·网络·docker·微服务·容器
FlYFlOWERANDLEAF4 小时前
DevExpress中Word Processing Document API学习记录
学习·c#·word
半夏知半秋4 小时前
基于跳跃表的zset实现解析(lua版)
服务器·开发语言·redis·学习·lua
AnySpaceOne4 小时前
PDF转Word在线转换教程:多种实用方法分享
学习·pdf·word
在路上`10 小时前
前端学习之后端java小白(四)之数据库设计
sql·学习