使用 docker-compose.yml 自动删除容器

1. 概述

在使用 Docker Compose 时，我们经常会运行一些生命周期较短的服务。这类服务在完成任务后就没有继续存在的必要了。此时，我们希望容器在退出后能够自动删除，以避免系统中堆积大量无用的容器。

为此，Docker 提供了 --rm 参数用于实现这一功能。然而，很多开发者会疑惑是否可以在 docker-compose.yml 文件中直接配置该行为。

在本文中，我们将探讨这一需求是否可以实现、为什么重要，以及如何正确使用 Docker Compose 来运行短生命周期容器。

2. 问题背景

假设我们在 docker-compose.yml 中定义了一个用于编译前端资源（如 JavaScript 或 CSS）的服务。这个容器在完成编译任务后就不再需要了。我们希望它在执行完毕后自动清理自己，避免占用系统资源。

那么问题来了：能否在 docker-compose.yml 中直接配置容器运行完成后自动删除？

✅ 答案是：不能。
docker-compose.yml 中并没有提供类似 --rm 的配置项来实现容器退出后自动删除的功能。因此我们需要通过其他方式来模拟这一行为。

3. 示例演示

在原生命令行中，我们可以使用如下命令运行一个自动删除的容器：

$ docker run --rm my-image

在 Docker Compose 中，对应命令是：

$ docker-compose run --rm compiler

其中 --rm 参数表示容器退出后自动删除。

我们以一个 Node.js 容器为例，演示如何实现这一功能。

✅ 编写 docker-compose.yml 文件

version: '3.8'

services:
  compiler:
    image: node:18
    working_dir: /app
    volumes:
      - .:/app
    command: ["npm", "run", "build"]

✅ 创建 package.json 文件

$ echo '{ "scripts": { "build": "echo Building..." } }' > package.json

✅ 使用 docker-compose up 启动服务

$ docker-compose up compiler
Creating auto-remove_compiler_1 ... done
Attaching to auto-remove_compiler_1
compiler_1  | 
compiler_1  | > build
compiler_1  | > echo Building...
compiler_1  | 
compiler_1  | Building...
auto-remove_compiler_1 exited with code 0

⚠️ 注意：docker-compose up 是用于启动长期运行服务的命令。即使容器执行完毕，它也会保留容器状态，不会自动删除。

✅ 查看容器状态

$ docker ps -a
CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS                     PORTS     NAMES
dfea9f20e95d   node:18   "docker-entrypoint.s…"   10 minutes ago   Exited (0) 5 minutes ago             auto-remove_compiler_1

✅ 使用 --rm 参数运行容器

$ docker-compose run --rm compiler
Creating auto-remove_compiler_run ... done

> build
> echo Building...

Building...

✅ 此时容器在执行完毕后会自动删除，无需手动清理。同时，由于使用了 volume 挂载，编译结果仍会保留在宿主机中。

4. 自动化流程

为了避免每次都要手动输入 docker-compose run --rm，我们可以将其封装成脚本。

✅ 创建 auto_remove_container.sh 脚本

#!/bin/bash
echo "Compiling project..."
docker-compose run --rm compiler

✅ 执行脚本

$ bash auto_remove_container.sh
Compiling project...
Creating auto-remove_compiler_run ... done

> build
> echo Building...

Building...

通过这种方式，我们可以统一操作入口，提高工作效率，也更容易集成到 CI/CD 流程中。

5. 总结

docker-compose.yml 文件不支持直接配置容器自动删除功能；
但我们可以通过 docker-compose run --rm <service> 命令来实现；
使用脚本可以将这一操作自动化，提升可维护性；
该方式非常适合处理一次性任务，如编译、测试、打包等；
通过 volume 挂载，可以确保容器执行结果持久化，容器本身则可安全删除。

✅ 总之，虽然 docker-compose.yml 不支持 --rm 配置，但结合命令行参数和脚本，我们完全可以实现类似效果，从而保持 Docker 环境干净整洁。

Persistence

REST

Security