容器与云原生 / 系统课时

Compose 为什么自动创建网络

Compose 为什么自动创建网络

一个 Compose 项目往往同时包含 Web、数据库和缓存服务。即使 compose.yaml 没写 networks,这些容器仍能互通。本课用最小实验说明默认网络何时创建、服务怎样加入,以及什么时候才需要显式定义网络。

学习目标

  • 解释 Compose Project 与默认网络的关系。
  • 验证未声明 networks 的服务会加入同一默认网络。
  • 判断默认网络足够使用与需要自定义网络的场景。

默认网络解决了什么

当前 Compose 会为应用准备一个默认网络;没有显式声明 networks 的服务会连接到它。默认情况下,这个网络使用 bridge 驱动,并通常按 <project-name>_default 命名。连接在同一网络上的服务可以通过服务名发现彼此。([Docker Documentation][1])

这一步把“创建网络、把容器接入网络、提供服务发现”放进了 docker compose up 的生命周期。开发者不必先手工执行 docker network create,也不必把容器 IP 写进配置。不同 Project 默认使用不同网络,也能减少无关服务之间的直接可达关系。

Compose Project 自动创建并连接默认网络

用最小项目验证默认网络

保存下面的配置为 compose.yaml。文件没有顶层 networks,两个服务也没有服务级 networks。

yaml
services:
  web:
    image: nginx:alpine

  worker:
    image: alpine:3.20
    command: ["sh", "-c", "while true; do sleep 3600; done"]

使用固定 Project 名启动,然后检查网络,并从 worker 访问 web。示例要求本机已安装 Docker Engine 与 Docker Compose 插件。

bash
set -e
docker compose -p network-demo up -d >/dev/null 2>&1
docker network inspect network-demo_default --format '{{.Name}} {{.Driver}}'
docker compose -p network-demo exec -T worker sh -c "wget -qO- http://web:80 | grep -o 'Welcome to nginx!'"

预期输出

text
network-demo_default bridge
Welcome to nginx!

第一行证明 Compose 已创建 Project 默认网络;第二行证明两个服务在没有手工配置 IP 的情况下已经能够通信。若首次执行需要拉取镜像,启动耗时会更长,但上述检查结果不受影响。

网络名为什么带 Project

Compose 用 Project 把一组服务、网络和其他资源归到同一应用边界。指定 -p network-demo 后,默认网络名可预测为 network-demo_default;如果不显式指定 Project 名,Compose 会根据项目配置与运行位置确定名称,因此不要在业务代码里硬编码这个网络名。

真正应该稳定依赖的是 Compose 模型里的服务名和网络声明,而不是某次运行生成的容器 IP。容器被重新创建后 IP 可能变化,但服务仍可重新加入同一个项目网络。

什么时候显式声明网络

只有一个内部通信平面时,隐式 default 通常已经够用。需要隔离前端与数据库、让某个服务同时连接两个网络、复用预先创建的外部网络,或为网络指定额外参数时,再声明顶层 networks。

例如,代理只应访问应用,而不应直接访问数据库时,可以把服务分到 frontend 与 backend 两张网络。此时网络声明表达的是架构边界,而不是为了让最基本的容器通信“能够工作”。

因此,Compose 自动创建网络的核心价值不是省掉一条命令,而是让同一 Project 的服务天然拥有一个受管理、可发现、可随项目生命周期创建的通信边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Compose 为什么自动创建网络

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通