一点记录：docker-compose 编排不同项目间的网络

假设有项目 A，名为 awesome-project-a，运行两个容器，一个 web，一个数据库，由 docker-compose.yml 是这个样子

version: '3'
services:
    web:
        # ...
        # ...
    db:
        # ...
        # ...

由 docker-compose 把项目启动之后，会自动创建一个叫做 awesome-project-a_default 的 docker 网络。可以通过命令 docker network ls 查到这个新创建的网络，使用 docker network inspect awesome-project-a_default 查看有哪些容器在用这个网络。

新项目使用已存在的 docker 网络

官方文档：Use a pre-existing network

如果此时新加入一个项目 B，它需要跟项目 A 之间网络互通，但是由于一些原因，不能或者不想把项目 B 也写进上面的 docker-compose.yml，而是项目 B 单独维护一份 docker-compose.yml，项目 B 的 docker-compose.yml 中要指定 awesome-project-a_default 这个名字，具体写法如下：

version: '3'
services:
    # ...
    # ...

networks:
  default:
    external:
      name: awesome-project-a_default

如果要做地更细致一些，项目 B 只要能跟项目 A 的数据库——也就是 db 容器相通，但是要跟 web 容器隔离开，那就需要项目 A 的 db 容器和项目 B 在同一个网络。项目 A 的 docker-compose.yml 修改成：

version: '3'
services:
    web:
        # ...
        # ...
    db:
        # ...
        # ...
        networks:
            default:
            with-project-b:

networks:
    default:
    with-project-b:

不要忘记 default:，否则项目 A 的 web 和 db 就不通了。

别名

官方文档：aliases

容器默认的主机名是在 docker-compose.yml 中指定的服务名，比如项目 B 可以在它的容器内部通过 db 这个名字作为主机名去连接数据库，这时如果项目 B 希望通过一个更特别的名字，比如 db.from.a.local 去连它，这需要修改项目 A 的 docker-compose.yml，使用 aliases 功能给 db 容器加一个别名。

version: '3'
services:
    web:
        # ...
        # ...
    db:
        # ...
        # ...
        networks:
            default:
            with-project-b:
                aliases:
                    - db.from.a.local

networks:
    default:
    with-project-b:

也可以给一个容器在一个网络中设置多个别名。给一个容器在多个不同的网络中设置不同的别名，也是可以的。