容器与云原生 / 系统课时

services 区块应该怎么理解

services 区块应该怎么理解

services 是 Compose 文件描述“应用由哪些可独立运行组件组成”的核心区域。Web、数据库、缓存等组件分别成为一个服务,服务名作为键,下面填写镜像、端口、环境变量和挂载等运行配置。掌握这个结构后,读 Compose 文件就不再是逐行猜 YAML。

学习目标

  • 理解 services 顶层元素与“服务”的关系。
  • 能为两个组件分别编写服务定义,并识别常用配置项。
  • 使用 Compose 命令验证服务名是否被正确解析。

services 本质上是一张服务映射

services 的值是一个映射:每个一级键都是服务名,每个服务名下面的内容是该服务的定义。服务描述的是“这一类容器应该怎样运行”,而不是某个已经存在的具体容器。

例如,一个应用可以把 Web 服务器和数据库分别定义为 web、db。Compose 根据各自配置创建容器,并把它们纳入同一个项目生命周期管理。

yaml
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"

  db:
    image: postgres:17-alpine
    environment:
      POSTGRES_PASSWORD: example
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  db-data:

这里 web 和 db 是两个服务名,不是 Docker 镜像名。web 使用 Nginx 镜像并把宿主机 8080 端口映射到容器 80 端口;db 使用 PostgreSQL 镜像,通过环境变量完成最小初始化,并把数据目录挂载到命名卷。

从服务名向下读取配置

阅读一个服务时,先问“它从哪里获得可运行文件”,再看“运行时还需要什么”。常见字段可以按职责理解:

  • image 指定直接使用的镜像;如果项目需要本地构建镜像,通常改用或配合 build。
  • ports 定义宿主机与容器端口映射,主要用于让宿主机或外部客户端访问服务。
  • environment 向容器传入环境变量,适合运行时参数,但敏感信息不应直接硬编码进可共享文件。
  • volumes 挂载命名卷或宿主机路径,用于持久化数据或共享文件。
  • command 可以覆盖镜像默认命令。
  • depends_on 用来表达服务启动与停止的依赖顺序,但仅有短语法依赖并不等于被依赖服务已经“业务就绪”。

服务定义最终作用于该服务创建出的容器。不要把宿主机安装步骤、应用源码结构和容器运行配置混在 services 中;Compose 负责描述运行模型,而不是替代 Dockerfile 或应用自身配置。

验证 Compose 是否识别了服务

保存文件后,可以先不启动任何容器,直接让 Compose 解析配置并列出服务名。

bash
docker compose config --services

预期输出:

text
web
db

如果 YAML 缩进错误、字段位置不合法或结构无法解析,命令会直接报错;如果输出只有一个服务,则应优先检查另一个服务是否被错误缩进到了前一个服务内部。需要查看 Compose 规范化后的完整配置时,可以再运行 docker compose config。

服务名不等于容器名

服务名是 Compose 模型中的稳定标识。实际容器名称通常还会组合项目名、服务名和副本序号,因此业务配置不应依赖某个手写容器名。默认网络中,服务之间通常可以直接用服务名进行 DNS 解析,例如应用连接数据库时可把主机名写成 db,而不是绑定某个容器 IP。

同一个服务还可能产生多个容器副本,因此“服务”更接近可复制的运行模板,“容器”才是模板的一次具体实例。后续执行 docker compose up、stop、restart 或指定服务的命令时,Compose 都是先通过服务名定位这份定义,再管理对应容器。

当 Compose 文件变复杂时,先从 services 列出有哪些组件,再逐个向下读每个服务的镜像、网络入口、配置和持久化需求,通常比按 YAML 行号从上到下阅读更容易发现边界与依赖。

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

目录与阅读设置

阅读设置

17

记录一个想法

services 区块应该怎么理解

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

登录哪都通