### 如何使用 `docker stop` 命令停止正在运行的 Docker 容器 `docker stop` 是一种安全的方式用来终止一个或多个正在运行的 Docker 容器。此命令会先向容器发送一个 SIGTERM 信号，给容器一定的时间来完成其当前的任务并优雅地关闭。如果在规定时间内容器未能正常退出，则会发送 SIGKILL 信号强制结束该容器。 #### 基本语法 以下是 `docker stop` 的基本用法： ```bash docker stop [OPTIONS] CONTAINER [CONTAINER...] ``` - `[OPTIONS]`: 可选参数，默认超时时间为10秒。 - `CONTAINER`: 要停止的一个或多个容器的名字或者ID。 #### 参数说明 | 参数 | 描述 | |------|------| | `-t`, `--time=int` | 设置停止前等待的最大时间（单位：秒），默认为10秒。 | #### 示例演示 假设存在两个正在运行的容器，分别是名为 `es01-test` 和 `kib01-test` 的 Elasticsearch 和 Kibana 容器： ##### 单独停止单个容器 ```bash docker stop es01-test ``` 这条命令将会尝试向 `es01-test` 发送SIGTERM信号，并等待最多10秒钟让容器自行关闭；如果超过设定时间仍未响应，则强制杀死容器[^5]。 ##### 批量停止多个容器 ```bash docker stop es01-test kib01-test ``` 这将依次对每个列出的目标执行相同的逻辑操作直到全部成功停运为止[^5]。 ##### 自定义延长时间 如果您预计某个特定的应用程序需要更多时间来进行清理工作，在这种情况下可以增加延迟期限： ```bash docker stop --time=30 es01-test ``` 这里设置了最长等待周期为30秒再决定是否采取强硬措施中断进程活动。 #### 注意事项 - 当利用 `docker stop` 来关停实例的时候，请确认内部的服务已经配置好接收以及应对来自宿主机发出的相关系统调用事件(SIGTERM)，从而实现平稳过渡而不会丢失任何未保存的数据或者其他异常情况发生。 - 若目标处于非活跃状态(即已经被暂停pause或是先前就已被销毁remove),那么再次对其发起此类请求实际上没有任何效果也不会报错提示失败消息返回给用户界面层面上来看待整个流程依旧顺利完成而已[^5]。 ```python import subprocess def stop_container(container_name, timeout=None): command = ['docker', 'stop'] if timeout is not None: command.extend(['--time={}'.format(timeout)]) command.append(container_name) result = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE) if result.returncode != 0: raise Exception(f"Failed to stop container {container_name}: {result.stderr.decode('utf-8')}") # Example usage of the function defined above try: stop_container("my_running_container", timeout=20) except Exception as e: print(e) ```