容器与云原生 / 系统课时

编排数据库与缓存

编排数据库与缓存

本课将完成应用、数据库和缓存服务的 Compose 编排,让开发环境具备接近生产的依赖关系。通过网络、数据卷、初始化脚本和健康检查配置,最终实现服务重建后数据可恢复、启动顺序可控。

学习目标

  • 理解 Compose 中服务网络、数据卷和依赖关系的组合方式
  • 编写包含数据库与缓存的完整服务配置
  • 验证容器重建后的数据持久化和健康状态

设计数据库与缓存服务关系

应用通常不会直接依赖单个容器,而是依赖一组协同服务。数据库负责持久化业务数据,缓存负责降低访问延迟。Compose 会为同一个项目自动创建网络,使服务可以通过服务名互相访问。

例如应用容器连接数据库时,不应使用 localhost,而应该使用 Compose 服务名作为主机地址。这样容器迁移或重新创建后,连接配置仍然稳定。

Compose 多服务网络与数据卷关系图

配置 Compose 服务

数据库与缓存配置需要同时考虑连接方式、存储位置和启动条件。下面示例使用 PostgreSQL 保存数据,Redis 提供缓存能力,健康检查用于判断数据库是否真正可用。

yaml
services:
  app:
    image: example/app:<ID>
    environment:
      DATABASE_HOST: db
      CACHE_HOST: redis
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started

  db:
    image: postgres:16
    environment:
      POSTGRES_DB: appdb
      POSTGRES_USER: appuser
      POSTGRES_PASSWORD: change-me
    volumes:
      - db-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U appuser -d appdb"]
      interval: <TIME>s
      timeout: <TIME>s
      retries: 5

  redis:
    image: redis:7
    volumes:
      - redis-data:/data

volumes:
  db-data:
  redis-data:

预期结果

text
Compose 配置加载成功,app 服务能够通过 db 和 redis 服务名访问依赖服务。

depends_on 只控制启动依赖,不代表数据库业务一定准备完成,因此生产配置中通常需要结合健康检查、应用重试机制和连接超时处理。

初始化数据与验证持久化

数据库初始化文件可以放入官方镜像支持的初始化目录,在首次创建数据卷时自动执行。需要注意,初始化通常只会在空数据目录时执行,已有数据卷不会重复运行。

bash
docker compose up -d
docker compose ps
docker compose exec db psql -U appuser -d appdb -c "SELECT now();"

预期输出

text
NAME        SERVICE     STATUS
app         app         running
 db         db          healthy
redis       redis       running

              now
-------------------------------
 2026-08-10 06:00:00+00

验证完成后可以重新创建应用容器,确认数据库卷仍然存在。删除容器不会删除命名卷,除非主动执行卷清理操作。

常见失败处理

数据库连接失败时,优先检查服务名、网络和健康状态,而不是立即修改应用代码。常见问题包括数据库密码不一致、容器启动但数据库尚未完成初始化,以及误删除数据卷。

缓存异常时,需要确认应用连接的是 Redis 服务名,而不是宿主机地址,同时检查 Redis 数据是否需要持久化。对于纯缓存场景,可以根据业务要求选择是否保留数据卷。

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

目录与阅读设置

阅读设置

17

记录一个想法

编排数据库与缓存

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

登录哪都通