centos/nginx-110-centos7

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

用户可选择基于RHEL、CentOS和Fedora的镜像。RHEL镜像可在Red Hat容器目录获取，CentOS镜像可在https://hub.docker.com/r/centos/%E8%8E%B7%E5%8F%96%EF%BC%8CFedora%E9%95%9C%E5%83%8F%E5%8F%AF%E5%9C%A8Fedora Registry获取。生成的镜像可使用https://github.com/containers/libpod%E8%BF%90%E8%A1%8C%E3%80%82

注意：虽然本文档中的示例使用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中构建简单的https://github.com/sclorg/nginx-container/tree/master/1.10/test/test-app%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E6%AD%A5%E9%AA%A4%E5%AE%9E%E7%8E%B0%EF%BC%9A

bash
oc new-app nginx:1.10~https://github.com/sclorg/nginx-container.git --context-dir=1.10/test/test-app/

也可在安装了独立https://github.com/openshift/source-to-image%E5%B7%A5%E5%85%B7%E7%9A%84%E7%B3%BB%E7%BB%9F%E4%B8%8A%E6%9E%84%E5%BB%BA%E7%9B%B8%E5%90%8C%E5%BA%94%E7%94%A8%EF%BC%9A

bash
$ s2i build https://github.com/sclorg/nginx-container.git --context-dir=1.10/test/test-app/ rhscl/nginx-110-rhel7 nginx-sample-app

访问应用：

bash
$ curl 127.0.0.1:8080

S2I构建支持

该镜像可通过OpenShift的Source构建策略或独立的https://github.com/openshift/source-to-image%E5%B7%A5%E5%85%B7%EF%BC%88%E5%A6%82%E5%B7%B2%E5%AE%89%E8%A3%85%EF%BC%89%E8%BF%9B%E8%A1%8C%E6%89%A9%E5%B1%95%E3%80%82S2I%E6%9E%84%E5%BB%BA%E6%96%87%E4%BB%B6%E5%A4%B9%E7%BB%93%E6%9E%84%E5%A6%82%E4%B8%8B%EF%BC%9A

• ./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根目录：

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

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

故障排除

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

bash
podman logs <container>

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

参见

该容器镜像的Dockerfile和其他源代码可在https://github.com/sclorg/nginx-container%E8%8E%B7%E5%8F%96%E3%80%82%E5%9C%A8%E8%AF%A5%E4%BB%93%E5%BA%93%E4%B8%AD%E8%BF%98%E5%8F%AF%E6%89%BE%E5%88%B0%E5%85%B6%E4%BB%96%E7%89%88%E6%9C%AC%E7%9A%84Python%E7%8E%AF%E5%A2%83Dockerfile%E3%80%82CentOS%E7%9A%84Dockerfile%E5%90%8D%E4%B8%BA%60Dockerfile%60%EF%BC%8CRHEL7%E7%9A%84%E4%B8%BA%60Dockerfile.rhel7%60%EF%BC%8CRHEL8%E7%9A%84%E4%B8%BA%60Dockerfile.rhel8%60%EF%BC%8CFedora%E7%9A%84%E4%B8%BA%60Dockerfile.fedora%60%E3%80%82