Web 服务器与网关 / 系统课时

使用 Compose 部署网关

使用 Compose 部署网关

本篇介绍如何使用 Docker Compose 编排 Nginx 网关与多个后端服务实例,通过统一网络、服务发现、健康检查和日志持久化完成可重复部署。学习完成后,可以快速搭建本地或测试环境中的网关拓扑。

学习目标

  • 理解 Compose 管理 Nginx 网关和后端服务的方式
  • 掌握内部网络、服务发现和健康依赖配置
  • 能够验证部署结果并定位常见启动问题

设计 Compose 网关架构

使用 Compose 部署网关时,核心目标不是简单启动多个容器,而是让容器之间形成稳定的通信关系。Nginx 作为入口服务,通过 Compose 创建的内部网络访问后端服务,不需要依赖固定 IP 地址。

Compose 网关部署拓扑图

Compose 会通过服务名提供 DNS 解析。例如服务名称为 app,则 Nginx 可以直接代理到 http://app:<PORT>,容器重建后地址变化也不会影响配置。

编写 Compose 部署文件

下面示例定义一个 Nginx 网关、两个后端实例和一个持久化日志目录。实际镜像版本和端口可以根据项目环境调整。

yaml
services:
  gateway:
    image: nginx:stable
    ports:
      - "<PORT>:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - nginx-logs:/var/log/nginx
    depends_on:
      app:
        condition: service_healthy
    networks:
      - gateway-net

  app:
    image: example/backend:latest
    expose:
      - "8080"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 10s
      timeout: 3s
      retries: 5
    networks:
      - gateway-net

networks:
  gateway-net:

volumes:
  nginx-logs:

启动 Compose 项目:

bash
docker compose up -d

预期输出

text
Container gateway Started
Container app Started

该配置中,Nginx 不直接绑定后端容器 IP,而是依赖 Compose 服务发现。健康检查通过后,网关才进入可用状态。

配置 Nginx 转发后端服务

Nginx 配置中使用 Compose 服务名作为 upstream 地址,使配置与容器生命周期解耦。

nginx
http {
    upstream backend_pool {
        server app:8080;
    }

    server {
        listen 80;

        location / {
            proxy_pass http://backend_pool;
        }
    }
}

预期结果

text
客户端请求 http://<HOST>:<PORT>/
Nginx 转发到 app:8080
后端服务返回响应

如果服务名无法解析,通常说明容器没有加入同一个网络,或者 Compose 服务名称与 Nginx 配置不一致。

验证部署和处理失败情况

部署完成后,应分别检查容器状态、网络连接和日志目录。

bash
docker compose ps
docker compose logs gateway

预期输出

text
NAME        STATUS
 gateway    running
 app        healthy

常见问题包括健康检查路径错误、挂载配置文件失败以及端口冲突。排查时优先确认 Compose 配置解析结果,再检查容器内部日志。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Compose 部署网关

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

登录哪都通