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

用户可选择基于RHEL、CentOS和Fedora的镜像。RHEL镜像可在Red Hat容器目录获取，CentOS镜像可在Docker Hub获取，Fedora镜像可在Fedora Registry获取。生成的镜像可使用podman运行。

注意：虽然本文档中的示例使用podman，但您可以将所有此类调用替换为docker，参数保持不变。

概述和主要用途

Nginx是一个Web服务器和HTTP、SMTP、POP3及IMAP协议的反向代理服务器，专注于高并发、高性能和低内存使用。该容器镜像提供了nginx 1.10守护进程的容器化包装，可作为基于nginx 1.10 Web服务器的其他应用程序的基础镜像。Nginx服务器镜像可通过OpenShift的Source构建功能进行扩展。

核心功能和特性

• 多协议支持：作为Web服务器和反向代理服务器，支持HTTP、SMTP、POP3和IMAP协议
• 性能优化：注重高并发处理能力、高性能和低内存占用
• 容器化包装：提供nginx 1.10的容器化部署，便于快速启动和扩展
• 可扩展性：可作为基础镜像，支持通过OpenShift的Source构建功能扩展应用

使用场景和适用范围

• 需要运行nginx 1.10 Web服务器的场景
• 构建基于nginx的Web应用程序，作为基础镜像使用
• 在OpenShift环境中部署和扩展nginx服务
• 需要高并发、低内存占用的Web服务场景

使用方法和配置说明

基础使用示例

假设使用rhscl/nginx-110-rhel7镜像（在OpenShift中通过nginx:1.10镜像流标签可用）。在OpenShift中构建简单的示例应用可通过以下步骤实现：

oc new-app nginx:1.10~[***] --context-dir=1.10/test/test-app/

也可在安装了独立S2I工具的系统上构建相同应用：

$ s2i build [***] --context-dir=1.10/test/test-app/ rhscl/nginx-110-rhel7 nginx-sample-app

访问应用：

$ curl 127.0.0.1:8080

S2I构建支持

该镜像可通过OpenShift的Source构建策略或独立的source-to-image工具（如已安装）进行扩展。S2I构建文件夹结构如下：

• ./nginx-cfg/*.conf：应包含所有要纳入镜像的nginx配置文件
• ./nginx-default-cfg/*.conf：包含要纳入默认服务器块的nginx配置片段
• ./nginx-start/*.sh：包含在nginx启动前执行的shell脚本
• ./：应包含nginx应用程序源代码

环境变量和卷

环境变量

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

• NGINX_LOG_TO_VOLUME：当设置此变量时，nginx日志将写入/var/opt/rh/rh-nginx110/log/nginx/

卷使用

可通过以下方式挂载自定义web根目录：

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

其中<DIR>为web根目录的路径（需为绝对路径，符合podman要求）。

故障排除

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

podman logs <container>

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

参见

该容器镜像的Dockerfile和其他源代码可在[***]Dockerfile，RHEL7的为Dockerfile.rhel7，RHEL8的为Dockerfile.rhel8，Fedora的为Dockerfile.fedora。