dwpdigital/nginx-s3

Nginx S3配置容器镜像

镜像概述

本Docker镜像基于官方Nginx镜像构建，核心功能是在容器启动阶段从AWS S3存储服务获取Nginx配置文件，实现配置的动态加载与集中化管理。适用于需要跨环境统一配置或动态更新Nginx配置的场景。

核心功能与特性

• S3配置拉取：启动时自动从指定S3路径下载Nginx配置文件（.conf）
• 与标准Nginx兼容：保留官方Nginx镜像的所有功能和配置特性
• 环境变量配置：通过环境变量灵活设置S3访问参数和配置路径
• 轻量级集成：在标准Nginx基础上仅添加必要的S3客户端工具，保持镜像精简

使用场景

• 多环境（开发/测试/生产）共享统一配置
• 集中式管理多个Nginx实例的配置
• 需要动态更新配置而无需重新构建镜像的场景
• 配置文件版本化管理（结合S3版本控制功能）

使用方法

前提条件

• 拥有AWS S3存储桶及配置文件（如nginx.conf、sites-enabled/*.conf等）
• 具备访问S3的IAM凭证（Access Key和Secret Key），且具有读取目标S3路径的权限

Docker Run命令示例

bash
docker run -d \
  -p 80:80 \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e S3_CONFIG_PATH="s3://your-bucket/path/to/nginx/config/" \
  --name nginx-s3-config \
  [镜像名称]

Docker Compose配置示例

yaml
version: '3'
services:
  nginx:
    image: [镜像名称]
    ports:
      - "80:80"
    environment:
      - AWS_ACCESS_KEY_ID=your-access-key
      - AWS_SECRET_ACCESS_KEY=your-secret-key
      - S3_CONFIG_PATH=s3://your-bucket/path/to/nginx/config/
      - AWS_REGION=us-east-1  # 可选，默认为us-east-1
    restart: always

配置参数说明

工作流程说明

1. 容器启动时，初始化AWS CLI配置（使用提供的Access Key和Region）
2. 通过s3 sync命令将S3_CONFIG_PATH指定路径下的所有文件同步到NGINX_CONFIG_DEST
3. 启动Nginx服务，应用同步后的配置文件
4. 后续配置更新需重启容器以重新拉取S3配置（或结合外部监控工具实现自动重启）