lightningai/nginx-test

NGINX部署集成测试镜像

镜像概述

该镜像基于NGINX构建，专门用于部署集成测试场景，提供轻量级Web服务器环境。其核心用途是帮助开发和测试团队在集成测试阶段验证部署流程、配置文件及相关功能在实际部署环境中的正确性。

核心功能与特性

• 基础功能稳定：基于官方NGINX镜像构建，确保Web服务器基础功能的稳定性和兼容性
• 轻量级设计：镜像体积小，适合在测试环境中快速部署和销毁，降低测试资源消耗
• 配置灵活性：支持标准NGINX配置，可通过挂载配置文件自定义服务器行为（如反向代理、负载均衡等）
• 部署验证支持：模拟生产环境Web服务器配置，验证部署流程的完整性和配置文件的有效性

使用场景与适用范围

• CI/CD流程集成：开发团队在持续集成/持续部署流程中，作为部署前的集成测试环境
• 配置验证：验证NGINX配置文件（如反向代理规则、SSL配置、缓存策略等）在部署环境中的实际效果
• 环境模拟：模拟生产环境Web服务器，测试应用部署后的访问性能、路由规则及功能正确性
• 教学与演示：在教学或技术演示场景中，快速搭建NGINX服务器进行配置测试和功能展示

使用方法与配置说明

基本使用流程

1. 拉取镜像

假设镜像已上传至容器仓库，通过以下命令拉取：

bash
docker pull [仓库地址]/nginx-integration-test:latest

2. 启动容器

使用默认配置运行容器（映射容器80端口到主机80端口）：

bash
docker run -d -p 80:80 --name nginx-test [仓库地址]/nginx-integration-test:latest

自定义配置

如需使用自定义NGINX配置，可通过挂载本地配置文件覆盖容器内默认配置：

bash
docker run -d -p 80:80 \
  -v /本地路径/nginx.conf:/etc/nginx/nginx.conf \
  -v /本地路径/conf.d:/etc/nginx/conf.d \
  --name nginx-test [仓库地址]/nginx-integration-test:latest

环境变量配置

该镜像支持通过环境变量调整基础配置（具体取决于基础镜像版本）：

• NGINX_HOST: 服务器主机名（默认值：localhost）
• NGINX_PORT: 监听端口（默认值：80）
• NGINX_ROOT: 网站根目录（默认值：/usr/share/nginx/html）

示例：指定自定义主机名和端口

bash
docker run -d -p 8080:8080 \
  -e NGINX_HOST=test.example.com \
  -e NGINX_PORT=8080 \
  --name nginx-test [仓库地址]/nginx-integration-test:latest

部署示例

docker-compose配置

创建docker-compose.yml文件，定义集成测试环境：

yaml
version: '3.8'
services:
  nginx-test:
    image: [仓库地址]/nginx-integration-test:latest
    ports:
      - "8080:80"  # 主机端口:容器端口
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf  # 挂载自定义配置
      - ./html:/usr/share/nginx/html        # 挂载测试静态文件
    environment:
      - NGINX_HOST=integration-test.local
      - NGINX_PORT=80
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

验证服务运行状态：

bash
docker-compose ps  # 查看容器状态
curl http://localhost:8080  # 访问测试页面