Java 后端 / 系统课时

准备 PostgreSQL、Redis 与 Docker

准备 PostgreSQL、Redis 与 Docker

本课使用 Docker Compose 搭建可重复创建的 PostgreSQL 与 Redis 开发环境,固定端口、账号、数据卷和健康检查,并通过数据库与缓存客户端命令验证真实连通性。

学习目标

  • 确认 Docker Engine 与 Compose v2 可以正常运行
  • 使用一份 Compose 配置同时启动 PostgreSQL 和 Redis
  • 验证服务健康状态、认证信息与 Spring Boot 连接参数

规划本地服务

开发环境需要明确端口、账号和数据持久化位置,避免每次重建都改变连接信息。以下配置仅用于本地开发,生产环境必须改用独立密钥、受控网络和正式备份策略。

服务 宿主机端口 数据库或认证 持久化卷
PostgreSQL 5432 数据库 enterprise,用户 app pg_data
Redis 6379 密码 redis_dev_password redis_data

先确认 Docker 与 Compose 插件可用。

bash
docker version
docker compose version

预期输出

text
Client: Docker Engine - Community
Server: Docker Engine - Community
...
Docker Compose version v2.<MINOR>.<PATCH>

如果只有 Client 信息而没有 Server 信息,说明 Docker 守护进程尚未启动。桌面系统应启动 Docker Desktop,Linux 应检查 Docker 服务状态和当前用户是否有访问 Docker Socket 的权限。

编写 Compose 配置

新建目录 local-infra,在其中创建 compose.yaml。配置使用命名卷保存数据,并通过健康检查区分“容器已启动”和“服务已可用”。

yaml
services:
  postgres:
    image: postgres:16-alpine
    container_name: sb3-postgres
    environment:
      POSTGRES_DB: enterprise
      POSTGRES_USER: app
      POSTGRES_PASSWORD: app_dev_password
    ports:
      - "5432:5432"
    volumes:
      - pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app -d enterprise"]
      interval: 5s
      timeout: 3s
      retries: 10

  redis:
    image: redis:7-alpine
    container_name: sb3-redis
    command:
      - redis-server
      - --appendonly
      - "yes"
      - --requirepass
      - redis_dev_password
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    healthcheck:
      test: ["CMD-SHELL", "REDISCLI_AUTH=redis_dev_password redis-cli ping | grep PONG"]
      interval: 5s
      timeout: 3s
      retries: 10

volumes:
  pg_data:
  redis_data:

开发密码直接写入文件是为了便于首次复现。真实团队项目应改用不提交到 Git 的 .env 文件、Docker Secret 或外部密钥管理服务。启动前先检查 Compose 语法。

bash
docker compose config --quiet

预期结果

text
命令不输出内容且退出码为 0,表示 Compose 配置可以被正确解析。

启动并查看健康状态

在 compose.yaml 所在目录启动服务,再查看容器状态。

bash
docker compose up -d
docker compose ps

预期输出

text
NAME           SERVICE    STATUS
sb3-postgres   postgres   Up <TIME> (healthy)
sb3-redis      redis      Up <TIME> (healthy)

首次启动会拉取镜像,输出中可能出现下载进度。只有状态进入 healthy 才表示服务完成初始化;刚启动时短暂显示 starting 属于正常现象。

验证 PostgreSQL 与 Redis

从容器内调用 PostgreSQL 客户端,查询当前数据库与当前用户。这一步同时验证容器、数据库初始化和账号认证。

bash
docker compose exec -T postgres psql -U app -d enterprise -c "select current_database(), current_user;"

预期输出

text
 current_database | current_user
------------------+--------------
 enterprise       | app
(1 row)

再通过 Redis 客户端执行 PING。使用环境变量传递密码,可以避免命令行参数产生密码警告。

bash
docker compose exec -T -e REDISCLI_AUTH=redis_dev_password redis redis-cli ping

预期输出

text
PONG

两个命令都成功后,说明服务内部认证可用。宿主机应用还需要使用映射端口连接,因此端口被其他程序占用时,容器可能无法正常启动。

准备 Spring Boot 连接参数

后续项目可通过环境变量覆盖连接信息,避免把开发密码硬编码在 Java 源码中。以下变量可放入 IDE 的运行配置或本地启动脚本。

bash
export SPRING_DATASOURCE_URL="jdbc:postgresql://localhost:5432/enterprise"
export SPRING_DATASOURCE_USERNAME="app"
export SPRING_DATASOURCE_PASSWORD="app_dev_password"
export SPRING_DATA_REDIS_HOST="localhost"
export SPRING_DATA_REDIS_PORT="6379"
export SPRING_DATA_REDIS_PASSWORD="redis_dev_password"

生效行为

text
Spring Boot 启动时会读取上述环境变量,并覆盖对应的数据源与 Redis 配置项。

如果 Spring Boot 应用也运行在同一 Compose 网络中,主机名应改为服务名 postgres 和 redis,不能继续使用 localhost;容器内的 localhost 只代表当前应用容器。

定位失败并管理数据

服务未进入健康状态时,先查看最近日志。

bash
docker compose logs postgres redis --tail=100

预期结果

text
日志应显示 PostgreSQL 初始化或 Redis 启动过程;错误行通常会指出端口、权限、配置或认证问题。

日常暂停使用 Compose 的 stop 子命令,恢复使用 start。删除容器和网络使用 down,它默认保留命名卷;只有明确需要清空全部数据库与缓存数据时,才在 down 后增加 -v。

端口冲突时,可将 PostgreSQL 映射改为 "15432:5432",并同步修改 JDBC 地址。若修改密码后认证仍失败,通常是旧数据卷保留了首次初始化结果;确认数据可删除后再清空卷并重建。

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

目录与阅读设置

阅读设置

17

记录一个想法

准备 PostgreSQL、Redis 与 Docker

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

登录哪都通