Nginx 1.8 服务器和反向代理服务器容器镜像

该容器镜像包含 Nginx 1.8 服务器和反向代理服务器，适用于 OpenShift 和一般用途。用户可选择基于 RHEL 或 CentOS 的镜像：RHEL 镜像可在 Red Hat Container Catalog 获取，镜像名为 registry.access.redhat.com/rhscl/nginx-18-rhel7；CentOS 镜像可在 Docker Hub 获取，镜像名为 centos/nginx-18-centos7。

描述

Nginx 是一款用于 HTTP、SMTP、POP3 和 IMAP 协议的 Web 服务器和反向代理服务器，专注于高并发、高性能和低内存占用。本容器镜像提供了 nginx 1.8 守护进程的容器化打包，可用作基于 nginx 1.8 Web 服务器的其他应用的基础镜像。Nginx 服务器镜像可通过 source-to-image 工具进行扩展。

使用方法

要使用独立的 S2I 构建简单的 sample-app 应用，并使用 Docker 运行生成的镜像，请执行以下命令：

对于基于 RHEL 的镜像

$ s2i build [***] --context-dir=1.8/test/test-app/ rhscl/nginx-18-rhel7 nginx-sample-app
$ docker run -p 8080:8080 nginx-sample-app

对于基于 CentOS 的镜像

$ s2i build [***] --context-dir=1.8/test/test-app/ centos/nginx-18-centos7 nginx-sample-app
$ docker run -p 8080:8080 nginx-sample-app

访问应用

$ curl 127.0.0.1:8080

S2I 构建支持

Nginx 服务器镜像可使用 S2I 工具扩展（参见使用方法部分）。S2I 构建的文件夹结构如下：

• ./nginx-cfg/*.conf
  应包含所有要纳入镜像的 nginx 配置文件。

• ./nginx-default-cfg/*.conf
  包含要纳入默认服务器块的任何 nginx 配置片段。

• ./nginx-start/*.sh
  包含在 nginx 启动前会被加载的 shell 脚本。

• ./
  应包含 nginx 应用的源代码。

环境变量和卷

nginx 容器镜像支持以下配置变量，可通过 docker run 命令的 -e 选项设置：

NGINX_LOG_TO_VOLUME

当设置 NGINX_LOG_TO_VOLUME 时，nginx 日志会写入 /var/opt/rh/rh-nginx18/log/nginx/。

挂载自定义 Web 根目录

可按以下方式挂载自定义 Web 根目录：

$ docker run -v <DIR>:/var/www/html/ <container>

将 <DIR> 替换为你的 Web 根目录位置。请注意，由于 Docker 要求，此路径必须为绝对路径。

故障排除

默认情况下，nginx 日志输出到标准输出，因此日志可在容器日志中查看。通过以下命令检查日志：

docker logs <container>

如果设置了 NGINX_LOG_TO_VOLUME 变量，nginx 日志会写入 /var/opt/rh/rh-nginx18/log/nginx/，可通过容器卷将此目录挂载到主机系统。

另请参阅

此容器镜像的 Dockerfile 和其他源代码可在 [***] 获取。该仓库中，CentOS 的 Dockerfile 名为 Dockerfile，RHEL 的 Dockerfile 名为 Dockerfile.rhel7。