容器与云原生 / 系统课时
编排数据库与缓存
编排数据库与缓存
本课将完成应用、数据库和缓存服务的 Compose 编排,让开发环境具备接近生产的依赖关系。通过网络、数据卷、初始化脚本和健康检查配置,最终实现服务重建后数据可恢复、启动顺序可控。
学习目标
- 理解 Compose 中服务网络、数据卷和依赖关系的组合方式
- 编写包含数据库与缓存的完整服务配置
- 验证容器重建后的数据持久化和健康状态
设计数据库与缓存服务关系
应用通常不会直接依赖单个容器,而是依赖一组协同服务。数据库负责持久化业务数据,缓存负责降低访问延迟。Compose 会为同一个项目自动创建网络,使服务可以通过服务名互相访问。
例如应用容器连接数据库时,不应使用 localhost,而应该使用 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 数据是否需要持久化。对于纯缓存场景,可以根据业务要求选择是否保留数据卷。
按自己的节奏,确认真正理解。