容器与云原生 / 系统课时
认识 Compose 项目结构
认识 Compose 项目结构
本课介绍 Docker Compose 项目的核心组织方式,帮助你使用 compose.yaml 描述多服务应用。完成学习后,可以理解 services、networks、volumes 三类资源的职责,并建立可维护的项目结构。
学习目标
- 理解 Compose 文件中核心资源的组织关系。
- 编写基础 compose.yaml 定义应用服务。
- 掌握项目名称对资源命名的影响。
Compose 文件描述什么
Docker Compose 使用声明式配置描述一组关联容器。开发者不需要逐个执行创建网络、启动容器等命令,而是通过文件定义目标状态,由 Compose 创建对应资源。
一个典型项目通常包含服务、网络和数据卷三部分:服务负责运行容器,网络负责通信,数据卷负责持久化数据。

编写基础 compose.yaml
下面示例定义一个应用服务和一个数据库服务,并让两个服务加入同一个网络。
yaml
services:
app:
image: nginx:latest
ports:
- "8080:80"
networks:
- app-net
db:
image: mysql:8
environment:
MYSQL_ROOT_PASSWORD: example
volumes:
- db-data:/var/lib/mysql
networks:
- app-net
networks:
app-net:
volumes:
db-data:预期结果
text
Compose 创建 app 和 db 两个服务,并生成对应网络与数据卷资源。实际生产项目中通常会进一步增加健康检查、环境变量文件和资源限制,但核心结构仍围绕这三类资源展开。
理解项目级资源命名
Compose 会根据项目名称生成资源名称。例如项目名为 demo 时,网络和数据卷可能被命名为 demo_app-net、demo_db-data。项目名称默认来自目录名,也可以显式指定。
bash
docker compose -p <PROJECT_NAME> up -d预期输出
text
Network <PROJECT_NAME>_app-net Created
Container <PROJECT_NAME>-app-1 Started统一项目名称可以避免不同环境之间资源混淆,也方便在服务器上管理多个 Compose 应用。
验证 Compose 项目状态
启动后可以使用 Compose 命令查看当前项目资源。
bash
docker compose ps预期输出
text
NAME SERVICE STATUS
app-1 app running
db-1 db running如果服务未启动,应优先检查 compose.yaml 语法、镜像拉取状态以及环境变量配置。
按自己的节奏,确认真正理解。