Human Made Docker Nginx容器

概述

Human Made Docker Nginx容器是Human Made项目的Docker配置，用于构建Nginx服务容器，由@nathanielks和@joehoyle维护。该容器继承自***Nginx容器的Alpine变体，提供安全、可定制的Nginx服务环境。

核心功能

• 应用挂载：待服务的应用需以卷形式挂载到容器内/usr/src/app目录
• HTTPS通信：仅通过HTTPS协议在8080端口提供服务，SSL证书内置（可扩展为运行时配置）
• 版本定制：支持通过构建参数指定Nginx版本，灵活适配不同需求
• 压缩控制：默认禁用Gzip压缩（推荐配合Cloudfront的brotli压缩），可通过环境变量在本地开发时启用

发布管理

分支策略

• master分支：跟踪最新稳定变更，不进行构建
• 版本分支：命名格式为v<major>.<minor>-branch（如v3.0-branch、v3.1-branch等），作为对应版本的权威源码并进行构建

拉取请求流程

1. 提交PR时，以master分支为基准分支
2. 添加backport vX.Y-branch标签，使Backport机器人将变更合并到目标版本分支
3. 若Backport无法自动应用变更到旧版本分支，需直接向对应版本分支提交PR

本地构建Nginx

基础信息

容器继承自***Nginx容器的Alpine变体，支持通过构建参数自定义Nginx版本，默认版本为1.15。

指定Nginx版本构建

可通过--build-arg参数指定Nginx版本，例如构建1.15.6版本：

docker build --build-arg FROM_NGINX=1.15.6 -t nginx .

Dockerfile中动态版本定义：

ARG FROM_NGINX=1.15
FROM nginx:${FROM_NGINX}-alpine

可在***Nginx容器标签列表查看所有可用版本标签

Gzip压缩配置

默认禁用Gzip压缩，本地开发时可通过环境变量启用：

docker run -d -p 8080:8080 -v $(pwd)/test/urls:/usr/src/app --env GZIP_STATUS=on --name nginx-test docker-wordpress-nginx

测试

测试框架

使用inspec作为测试框架，安装方法参考其***安装指南。

测试要求

需设置环境变量BASE_URL，格式为<protocol>://<host:port>，用于测试HTTP请求。

测试步骤

1. 构建容器镜像：

   docker build -t docker-wordpress-nginx .
   

2. 运行测试容器：

   docker run -d -p 8080:8080 -v $(pwd)/test/urls:/usr/src/app --name nginx-test docker-wordpress-nginx
   

3. 导出BASE_URL环境变量：

   export BASE_URL="[***] inspect $(docker ps -q --filter name=nginx-test --latest) --format='{{(index (index .NetworkSettings.Ports "8080/tcp") 0).HostPort}}')"
   

4. 执行测试：

   inspec exec test/inspec/nginx --reporter cli junit:/tmp/test-results/inspec/junit.xml --chef-license accept