Jelastic/NginxPHP镜像本地运行与定制教程

本文旨在解决Jelastic/NginxPHP Docker镜像在本地运行时无法正常启动Nginx和PHP-FPM的问题。通过深入分析该镜像的设计初衷及其默认启动命令，我们发现需要通过覆盖容器的CMD来直接启动Nginx服务。文章将提供详细的解决方案、代码示例，并探讨在此基础上构建自定义应用镜像的方法，同时提醒用户注意Jelastic平台与本地运行环境的差异。

引言：理解Jelastic/NginxPHP镜像的特殊性

Jelastic提供的jelastic/nginxphp Docker镜像与其他通用Nginx或PHP-FPM镜像有所不同。它专为Virtuozzo DevOps平台设计，旨在充分利用该平台提供的自动化和功能支持。这种设计导致其默认启动行为与在标准Docker环境中独立运行的期望有所差异。具体来说，该镜像的默认命令（CMD）被设置为启动systemd，而非直接启动Nginx或PHP-FPM服务。在Jelastic平台上，systemd会负责管理容器内的多个服务（如Nginx和PHP-FPM），但在本地独立运行Docker容器时，这种默认行为会导致服务无法正常启动。

本地运行问题诊断

当用户尝试使用默认的docker run命令启动jelastic/nginxphp镜像时，可能会遇到以下问题：

docker run -p 8080:80 jelastic/nginxphp:1.14.2-php-7.2.9

容器启动后，尝试访问http://127.0.0.1:8080会收到“Empty reply from server”的错误：

curl 127.0.0.1:8080
# curl: (52) Empty reply from server

通过docker exec进入容器并查看进程列表，会发现只有systemd在运行，而Nginx或PHP-FPM等服务并未启动：

docker exec  ps aux
# USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
# root         1  0.0  0.0 191276 10172 ?        Ssl  07:58   0:00 /usr/bin/qemu-x86_64 /usr/lib/systemd/systemd
# ...

进一步检查镜像的配置，我们可以使用docker inspect命令来查看其默认的CMD：

docker inspect jelastic/nginxphp:1.14.2-php-7.2.9
# ...
#     "Cmd": [
#         "/usr/lib/systemd/systemd"
#     ],
# ...

这证实了镜像的默认启动命令是/usr/lib/systemd/systemd。在非systemd托管的本地Docker环境中，systemd的启动并不会自动拉起Nginx和PHP-FPM，导致服务不可用。

解决方案：覆盖默认CMD以启动Nginx

为了在本地环境中正确运行jelastic/nginxphp镜像并启动Nginx服务，我们需要在docker run命令中覆盖其默认的CMD。通过直接指定Nginx的启动命令，并确保它在前台运行，可以使容器保持活跃并提供服务。

以下是正确的docker run命令示例：

docker run -p 8080:80 jelastic/nginxphp:1.14.2-php-7.2.9 /usr/sbin/nginx '-g daemon off;'

在上述命令中：

• -p 8080:80：将容器的80端口映射到主机的8080端口。
• jelastic/nginxphp:1.14.2-php-7.2.9：指定要运行的镜像及其版本。
• /usr/sbin/nginx '-g daemon off;'：这是关键部分，它覆盖了镜像默认的CMD。
  • /usr/sbin/nginx：Nginx的可执行文件路径。
  • -g daemon off;：这个参数告诉Nginx不要作为守护进程在后台运行，而是保持在前台。这是Docker容器的最佳实践，因为容器的主进程必须在前台运行，以便Docker能够监控其状态并在进程终止时停止容器。

验证容器运行状态

容器启动后，可以再次使用curl命令验证Nginx服务是否已正常响应：

curl 127.0.0.1:8080
# 此时应该会收到Nginx的默认欢迎页面或配置的响应

如果需要确认容器内的进程状态，可以使用docker exec：

docker exec  ps aux
# 此时应该能看到Nginx主进程在前台运行

关于PHP-FPM的额外考量

上述解决方案仅启动了Nginx服务。在jelastic/nginxphp镜像中，PHP处理通常通过PHP-FPM完成，并由Nginx配置代理。在Jelastic平台上，systemd会负责同时启动和管理Nginx和PHP-FPM。然而，当我们直接覆盖CMD启动Nginx时，PHP-FPM可能并未随之启动。

如果你的应用需要PHP处理能力，而不仅仅是Nginx静态文件服务，你可能需要更复杂的启动策略。一种常见的方法是编写一个自定义的entrypoint.sh脚本，在该脚本中同时启动PHP-FPM（通常在后台运行）和Nginx（在前台运行）。

例如，一个简化的entrypoint.sh可能如下所示：

#!/bin/bash
# 启动 PHP-FPM，通常它会作为守护进程运行
php-fpm -D

# 启动 Nginx 并在前台保持运行
exec /usr/sbin/nginx -g "daemon off;"

然后，在你的Dockerfile中将其作为ENTRYPOINT：

# ... (其他指令)
COPY entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD [] # CMD 可以留空，或者提供默认参数给 ENTRYPOINT

请注意，具体php-fpm的启动命令和配置路径可能因镜像版本而异，需要根据实际情况调整。

构建自定义应用镜像

一旦你理解了如何正确启动jelastic/nginxphp基础镜像，就可以在此基础上构建包含你自己的应用程序代码的自定义镜像。以下是一个示例Dockerfile，展示了如何添加应用代码并确保Nginx服务正确启动：

# 使用 jelastic/nginxphp 作为基础镜像
FROM jelastic/nginxphp:1.14.2-php-7.2.9

# 设置维护者信息 (可选)
LABEL maintainer="Your Name "

# 复制你的应用程序文件到Nginx的Web根目录
# 假设你的应用代码在当前目录下的 'app' 文件夹中
COPY ./app /var/www/webroot

# 设置工作目录 (可选，取决于你的应用结构)
WORKDIR /var/www/webroot

# 暴露端口80 (基础镜像可能已经暴露，但明确声明是好习惯)
EXPOSE 80

# 覆盖默认的CMD，直接启动Nginx并在前台运行
# 如果需要启动PHP-FPM，请考虑使用自定义的ENTRYPOINT脚本
CMD ["/usr/sbin/nginx", "-g", "daemon off;"]

构建镜像：

docker build -t my-custom-jelastic-nginxphp-app .

运行自定义镜像：

docker run -p 8080:80 my-custom-jelastic-nginxphp-app

通过这种方式，你的自定义应用将能够利用jelastic/nginxphp提供的环境，并在本地Docker环境中正常运行。

总结

jelastic/nginxphp Docker镜像由于其特定的设计目标，在本地独立运行时需要特别处理。核心问题在于其默认CMD是systemd而非直接的Web服务。通过在docker run命令中覆盖CMD以直接启动Nginx并使其在前台运行，可以有效地解决服务不可用的问题。对于需要PHP处理的应用，可能需要进一步定制ENTRYPOINT脚本来确保PHP-FPM也能正常启动。理解这些特性对于在此类专业平台定制镜像并进行本地开发至关重要。