容器与云原生 / 系统课时

应用怎样连接数据库和 Redis

应用怎样连接数据库和 Redis

应用容器连接数据库和 Redis 时,主机名应写 Compose 服务名,而不是 localhost。因为每个容器都有自己的网络命名空间,localhost 只回到当前容器;本课用环境变量和健康检查固定正确地址并完成验证。

学习目标

  • 使用 db、redis 等服务名作为容器间连接主机
  • 理解容器内 localhost 与宿主机 localhost 的区别
  • 配置依赖健康检查,避免应用在依赖尚未就绪时立即启动

连接地址应该写什么

Compose 会为同一网络上的服务提供基于服务名的发现,容器重建后 IP 可能变化,但服务名保持可用。因此应用代码应依赖 db、redis 这样的名字,而不是写死容器 IP。服务之间使用目标容器自己的端口,例如 PostgreSQL 的 5432 和 Redis 的 6379。([Docker Documentation][1])

连接来源 目标 应使用的地址
app 容器 PostgreSQL db:5432
app 容器 Redis redis:6379
宿主机 某个容器服务 localhost:<宿主机映射端口>,前提是配置了 ports

容器内 localhost 与服务名连接路径

用 Compose 固定连接主机

下面的示例把三个服务放进同一张 backend 网络,并把数据库与 Redis 的主机名、端口作为环境变量传给应用。depends_on 使用 service_healthy 时,Compose 会等待对应健康检查通过后再启动依赖服务。([Docker Documentation][2])

yaml
services:
  app:
    image: busybox:1.36
    command: ["sh", "-c", "sleep 3600"]
    environment:
      DB_HOST: db
      DB_PORT: "5432"
      REDIS_HOST: redis
      REDIS_PORT: "6379"
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    networks:
      - backend

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: appdb
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app -d appdb"]
      interval: 5s
      timeout: 3s
      retries: 5
    networks:
      - backend

  redis:
    image: redis:7-alpine
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5
    networks:
      - backend

networks:
  backend:

示例中的口令只用于本地练习。真实项目应通过环境文件、Compose secrets 或部署平台的机密管理能力注入敏感值,而不要把生产口令直接提交到版本库。

验证应用拿到正确地址

启动服务后,从 app 容器打印连接配置。命令隐藏了启动阶段的动态容器名称与进度,只展示本课要验证的地址。

bash
docker compose up -d >/dev/null 2>&1 && docker compose exec app sh -c 'printf "%s:%s\n%s:%s\n" "$DB_HOST" "$DB_PORT" "$REDIS_HOST" "$REDIS_PORT"'

预期输出

text
db:5432
redis:6379

这两个地址都只依赖 Compose 服务名,不依赖容器 IP。即使 db 或 redis 因重建获得新 IP,应用仍应重新通过服务名解析并建立连接。([Docker Documentation][1])

为什么 localhost 经常连错

在 app 容器中,localhost:5432 的含义是“访问 app 容器自己的 5432 端口”,并不会跳到 db 容器;localhost:6379 也不会自动指向 Redis。只有当数据库或 Redis 与应用运行在同一个容器里时,这种写法才可能成立,而多服务 Compose 正是把这些进程拆到不同容器中。

宿主机上的 localhost 又是另一回事:只有目标服务配置了 ports,宿主机才能通过映射端口访问它。容器到容器优先使用“服务名 + 容器端口”,宿主机到容器才考虑“localhost + 宿主机映射端口”。把这两套地址分开,能避免绝大多数 Compose 本地连接错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

应用怎样连接数据库和 Redis

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

登录哪都通