Docker Compose 简介

1 为什么需要 Docker Compose

在创建容器过程中，特别是在代码调试阶段，一般需要重复运行一些命令， 如 docker build ，docker run 等等，这些命令有时冗长而复杂，手动逐个重复运行这些命令十分繁琐，对于多容器的复杂应用尤其如此。使用 Docker Compose 工具能极大地简化容器的创建、管理和维护。

2 什么是 Docker Compose

Docker Compose 工具相当于 C/C++ 的 make 工具，使用 make 需要 Makefile，所有的编译链接设置都在Makefile 中指定，不需要为了编译链接代码以生成 .exe 而每次都在终端重复手动输入长串的指令。

Docker Compose 同样也需要一个配置文件： docker-compose.yaml(文件扩展名也可以是 yml)，创建容器所需的一系列指令都在此文件中设定。

关于 yaml 格式：YAML 是一种人类可读的数据序列化语言，通常用于配置文件和存储或传输数据的应用程序，YAML 使用 python 那样的缩进以指示嵌套关系。缩进通常使用两个空格，但是实际上没有限制，同 python，使用 # 表示注释。

3 Docker Compose 的使用

如下是一个 Mern Stack App 项目结构：

docker-compose.yaml 文件内容如下：

# docker compose 规范的版本，下面的网站可查
# https://docs.docker.com/compose/compose-file/compose-versioning/
version: "3.8"  
# 此 mern 将创建3个容器，下面的3个服务
# mongodb, backend, frontend 将自动被翻译成3个容器
services:  
  mongodb:
  	# 从 hub.docker.com 获取官方image
    image: "mongo" 

	# 命名卷: 持久化保存数据库数据
    volumes:
      - data:/data/db
    
    # 环境变量，在文件 ./env/mongo.env 里保存
    env_file:
      - ./env/mongo.env

  backend:
    build: ./backend
    ports:
      - "80:80"
    volumes:
      # 命名卷
      - logs:/app/logs
      # 绑定挂载，不同于命令，此文件中可以使用相对路径，
      # 手动运行命令则需绝对路径
      - ./backend:/app
      # 匿名卷
      - /app/node_modules
    env_file:
      - ./env/backend.env
    depends_on:
      - mongodb
  frontend:
    build: ./frontend
    ports:
      - "3000:3000"
    volumes:
      - ./frontend/src:/app/src
	
	# stdin_open 和 tty 对应手动执行命令时的 -it
    stdin_open: true
    tty: true
    
    # 仅仅在容器 backend 运行后，才会运行此 frontend
    depends_on:
      - backend
      - 
# 这里是整个 App 的命名卷
# 匿名卷和 bind-mounts 不能在这里指定
volumes:
  data:
  logs:

3.1 启动容器

docker-compose up

对于上面的 mern app，运行此命令将同时生成3个容器：frontend, backend 和 mongoDB。

docker-compose up 默认以附加模式运行，如果需要以分离模式运行则在命令后加 -d:

docker-compose up -d

也因为此原因，docker-compose.yaml 里没有设置 -d 的选项。

3.2 停止并删除容器

docker-compose down

对于上面的 mern app，运行此命令将同时停止并删除3个容器：frontend, backend 和 mongoDB。

• 使用 Docker Compose， Dockerfile 文件仍然必不可少。 Docker
  Compose 创建一个默认网络并将所有容器添加到该网络，故 docker-compose.yaml 里不需要指定网络。

• docker-compose down 命令将停止并删除容器，因此 docker-compose.yaml 没有选项 --rm

不管是单容器还是多容器 App 都能使用 Docker Compose，Docker Compose 是一个强大的非常有用的工具。

4 常用命令总结

当前版本，命令里写 docker-compose 或 docker compose 都一样，两种格式都支持。

• docker compose up -> Builds, (re)creates, starts, and attaches to containers for a service.
• docker-compose down -> 此命令删除容器和自动创建的网络. Stops containers and removes containers, networks, volumes, and images created by up
• docker compose down -v -> 加了选项 -v，数据卷也会被删。
• docker compose down --rmi -> Remove images used by services.
• docker logs <container-name> -> 查看 log
• docker compose build -> 此命令 build image
• docker compose up --build 强制重新 build image，然后启动容器
• docker compose stop 停止但不删除容器
• docker compose start 启动已存在的容器
• docker compose rm 移除已停止的容器 -f 不确认就删除

5. 如果云服务器更新 docker image 并重新运行容器，可使用如下命令：

Stackoverflow :

5.1 可以用下面的代码

docker-compose stop
docker-compose rm -f
docker-compose pull   
docker-compose up -d

5.2 更简洁的命令

docker-compose down && docker-compose pull && docker-compose up -d