Docker Compose 部署 Nginx 用于开发调试

Docker Compose 部署 Nginx 用于开发调试

Nginx 是一个高性能的 HTTP 服务器和反向代理服务器，广泛用于处理静态文件、负载均衡和反向代理服务。本文介绍如何使用 Docker Compose 部署 Nginx，并讲解如何检测和重新加载扩展配置文件的变化。

环境要求

• Docker 19.03 或更高版本
• Docker Compose 1.27.0 或更高版本

Docker Compose 配置详解

以下是 docker-compose.yml 文件配置，用于启动一个 Nginx 容器，并映射配置文件目录，支持 HTTP 和 HTTPS 端口。

docker-compose.yml

services:
  nginx:
    image: nginx:1.27.0
    restart: always
    mem_limit: 512MB
    ports:
      - "80:80"
      - "443:443"
    networks:
      - custom
    volumes:
      - ./conf.d:/etc/nginx/conf.d
    container_name: nginx
    hostname: nginx

networks:
  custom:
    external: true
    driver: bridge

配置说明

• 镜像与容器：

  • 使用 Nginx 1.27.0 官方镜像，适合用于开发和调试。
  • container_name 设置为 nginx，便于管理。
  • hostname 设置为 nginx，用于容器内的主机名解析。

• 端口映射：

  • 80:80 将宿主机的 80 端口映射到容器的 80 端口，用于 HTTP 服务。
  • 443:443 将宿主机的 443 端口映射到容器的 443 端口，用于 HTTPS 服务。

• 挂载卷：

  • ./conf.d:/etc/nginx/conf.d 将本地的 ./conf.d 目录挂载到容器内的 /etc/nginx/conf.d 目录。可以在 ./conf.d 中创建自定义的 Nginx 配置文件，Nginx 会根据这些文件自动加载配置。

• 网络配置：

  • 使用 custom 网络以确保 Nginx 可以与其他容器服务互通。

启动 Nginx

确保已经安装了 Docker 和 Docker Compose，并在项目根目录下创建了 docker-compose.yml 文件。

1. 使用以下命令启动 Nginx 服务：

   docker-compose up -d
   

2. 查看容器状态：

   docker-compose ps
   

   输出示例：

   Name                Command               State          Ports
   --------------------------------------------------------------------------------
   nginx     /docker-entrypoint.sh ngin ...  Up      0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp
   

配置文件修改检测

Nginx 支持通过挂载 conf.d 目录来加载自定义的配置文件。如果配置文件发生变化，可以通过以下步骤检测配置并重新加载 Nginx。

1. 检测配置是否正确

在 Nginx 容器内可以使用以下命令检查新的配置文件是否正确：

docker exec -it nginx nginx -t

如果配置文件没有错误，输出如下：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

如果配置有错误，Nginx 会输出详细的错误信息，以帮助你修复问题。

2. 重新加载配置文件

当检测到配置文件正确后，你可以通过以下命令重新加载 Nginx 配置，而无需重启整个容器：

docker exec -it nginx nginx -s reload

该命令会使 Nginx 重新加载所有配置文件，并应用新的配置，而不会中断当前的连接。

通过日志查看变更

Nginx 的容器日志可以帮助你排查配置文件变更的情况。可以使用以下命令查看 Nginx 容器的日志输出：

docker logs nginx

日志中可能包含错误或警告信息，帮助你定位问题。

总结

通过 Docker Compose 部署 Nginx 可以大大简化开发调试过程。本文提供了一个基础的 Nginx 配置，并讲解了如何挂载扩展配置文件、检测配置变化以及重新加载 Nginx 配置。通过这些步骤，你可以灵活地修改和测试 Nginx 的配置，快速响应变化而无需停止服务。