容器与云原生 / 系统课时

认识 Compose 项目结构

认识 Compose 项目结构

本课介绍 Docker Compose 项目的核心组织方式,帮助你使用 compose.yaml 描述多服务应用。完成学习后,可以理解 services、networks、volumes 三类资源的职责,并建立可维护的项目结构。

学习目标

  • 理解 Compose 文件中核心资源的组织关系。
  • 编写基础 compose.yaml 定义应用服务。
  • 掌握项目名称对资源命名的影响。

Compose 文件描述什么

Docker Compose 使用声明式配置描述一组关联容器。开发者不需要逐个执行创建网络、启动容器等命令,而是通过文件定义目标状态,由 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 语法、镜像拉取状态以及环境变量配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

认识 Compose 项目结构

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

登录哪都通