创建 Compose 覆盖配置

在使用远程 yaml 或是应用商店创建 Compose 任务时，有时候需要修改 compose.yaml 中的一些参数，比如：端口、挂载目录等配置。 如果直接去修改 yaml 就会导致，当应用作者发布新版后，就需要人工去合并这部分的差异。

这时候使用覆盖 yaml 的方式去新建一个 yaml 文件把配置追加、覆盖到原始的 yaml 文件中。

创建覆盖配置文件

TIP

覆盖配置文件只需要添加想要调整的配置项

覆盖配置

假设原始的 yaml 文件内容为

name: easyimage
services:
  easyimage:
    image: ddsderek/easyimage:latest
    ports:
      - target: 80
        published: '8080'
        protocol: tcp
    restart: unless-stopped
    volumes:
      - type: bind
        source: /DATA/AppData/easyimage/config
        target: /app/web/config
      - type: bind
        source: /DATA/AppData/easyimage/i
        target: /app/web/i
    environment:
      TZ: Asia/Shanghai
      PUID: '1000'
      PGID: '1000'
      DEBUG: 'false'

新增配置

新增一个端口映射，可以配置为，部署时将同时映射 80 及 88

services:
  easyimage:
    ports:
      - 8888:88

更改配置

更改映射目录，其中一个重新指向宿主机目录，一个指向存储卷

services:
  easyimage:
    ports:
      - 8888:88
    volumes:
      - /home/easyimage/config:/app/web/config
      - easyimage_i:/app/web/i
volumes:
  easyimage_i:
    name: easyimage_i

强制覆盖配置

DANGER

群辉或是老旧 Docker 版本不支持此配置，如果有覆盖操作需要直接原始文件

# 此覆盖配置，最终会映射到 8888 9999 8080
services:
  easyimage:
    ports:
      - 8888:88
      - 9999:80

# 采用 !override 的写法，最终只会映射 8888 及 9999
services:
  easyimage:
    ports: !override
      - 8888:88
      - 9999:80

清空配置

采用 !reset 的写法，可以将映射端口配置清空掉，不暴露任何端口。

services:
  easyimage:
    ports: !reset

替换 yaml 中的服务为已存在的容器

用 compose 部署两个 wordpress 项目，会产多个 mysql 数据库。 但是在实际中，大部分的做法是让多个 wordpress 共用同一个 mysql 实例，用不同的数据库进行区分。

在下面的 yaml 中，如果不想部署 db 服务，让 phpmyadmin 管理你已经存在的 localmysql。可以定义以下覆盖配置。 在部署 compose 任务时，取消掉 db 服务的勾选，面板不再会部署 db 服务。

TIP

需要注意的 compose 中的 phpmyadmin 可以访问到 localmysql 时需要将他们加入到同一个网络中

services:
  db:
    image: mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    ports:
      - :3306
    environment:
      MYSQL_ROOT_PASSWORD: ${PASSWORD}
      MYSQL_DATABASE: ${DATABASE}
      MYSQL_PASSWORD: "123456"
    networks:
      - mysql-phpmyadmin
  phpmyadmin:
    depends_on:
      - db
    image: phpmyadmin
    restart: always
    ports:
      - 8080:80
    environment:
      - PMA_HOST=db
      - MYSQL_ROOT_PASSWORD=password
    networks:
      - mysql-phpmyadmin
networks:
  mysql-phpmyadmin: null
volumes:
  db_data: null

通过 !reset 重写依赖服务，此时 phpmyadmin 管理的就是外部已存在的 localmysql 容器

services:
  phpmyadmin:
    depends_on: !reset
    external_links:
      - localmysql:db