humanmade/altis-local-server-nginx

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

基础信息

容器继承自https://hub.docker.com/_/nginx/%E7%9A%84Alpine%E5%8F%98%E4%BD%93%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E6%9E%84%E5%BB%BA%E5%8F%82%E6%95%B0%E8%87%AA%E5%AE%9A%E4%B9%89Nginx%E7%89%88%E6%9C%AC%EF%BC%8C%E9%BB%98%E8%AE%A4%E7%89%88%E6%9C%AC%E4%B8%BA1.15%E3%80%82

指定Nginx版本构建

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

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

Dockerfile中动态版本定义：

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

可在https://hub.docker.com/_/nginx/%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%E6%A0%87%E7%AD%BE

Gzip压缩配置

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

sh
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. 构建容器镜像：

   sh
   docker build -t docker-wordpress-nginx .
   

2. 运行测试容器：

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

3. 导出BASE_URL环境变量：

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

4. 执行测试：

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