写点什么

为所有 PHP-FPM 容器构建单独的 NGinx Dock 镜像

  • 2018-07-22
  • 本文字数:4310 字

    阅读完需:约 14 分钟

最近,原文作者一直在使用 Docker 容器来开发 PHP 微服务套件。一个问题是 PHP 应用已经搭建,可以和 PHP-FPM 和 Nginx(取代了简单的Apche/PHP 环境)一起工作,因此每个PHP 微服务需要两个容器(以及两个Docker 镜像):一个PHP-FPM 容器和一个NGinx 容器。 

这个应用运行了 6 个以上的服务,如果做个乘法,在开发和生产之间会有约 30 个容器。作者决定构建一个单独的 NGinx Docker 镜像,它可以使用 PHP-FPM 的主机名作为环境变量并运行单独的配置文件,而没有为每个容器构建单独的 NGinx 镜像。



在本文中,原文作者简要说明从上图中的方法 1 到方法 2 的转换,最后采用的方案中采用了一种新的定制 Docker 镜像。该镜像的代码是开源的,如果读者碰到类似问题,可以随时签出该部分代码。

为什么用 NGinx?

NGinx 和 PHP-FPM 配合使用能使PHP 应用的性能更好,但不好的是和PHP Apache 镜像不同, PHP-FPM Docker 镜像缺省并没有和 NGinx 进行绑定。如果需要通过 NGinx 容器和 PHP-FPM 连接,需要在 NGind 配置里为该后端增加 DNS 记录。比如,如果名为 php-fpm-api 的 PHP-FPM 容器正在运行,NGinx 配置文件应该包含下面部分:

复制代码
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
# This line passes requests through to the PHP-FPM container
fastcgi_pass php-fpm-api:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}

如果只服务于单独的 NGinx 容器,NGinx 配置中容器名字写死还可以接受,但如上所述,需要允许多个 NGinx 容器,每个对应于一个 PHP 服务。创建一个新的 NGinx 镜像(以后需要进行维护和升级)会有些痛苦,即使管理一批不同的数据卷,仅仅改变变量名看起来也有很多工作。

第一种方案: 使用 Docker 文档中的方法

最初,作者认为这会很简单。 Docker 文档中有少许的几个章节讨论如何使用 envsubst 来完成该工作,但不幸的是,在其 NGinx 配置文件中,这种方法不奏效。 

vhosts.conf

复制代码
server {
listen 80;
index index.php index.html;
root /var/www/public;
client_max_body_size 32M;
location / {
try_files $uri /index.php?$args;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass ${NGINX_HOST}:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
}

vhosts.conf文件使用了 NGinx 内置变量,因此当依照文档运行 Docker 命令 (/bin/bash -c "envsubst < /etc/nginx/conf.d/mysite.template > /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'") 时,得到错误提示$uri$fastcgi_script_name没有定义。这些变量通常通过 NGinx 传入,因此不能简单的识别出它们是什么并传给自身,而且这使容器的动态性变差。

用另一个 Docker 镜像来救急,差点成功

接下来,作者开始研究不同的 NGinx 镜像。找到的两个,但它们都在随后的几年中都没有任何更新。作者开始使用 martin/nginx ,试图找到可以工作的原型。 

Martin 镜像和其它镜像有点不一样,因为它要求特定的文件夹结构。在 root 下增加Dockerfile

复制代码
FROM martin/nginx

接下来,我添加了一个app/空目录和conf/目录,conf/目录下只有一个文件vhosts.conf

复制代码
server {
listen 80;
index index.php index.html;
root /var/www/public;
client_max_body_size 32M;
location / {
try_files $uri /index.php?$args;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass $ENV{"NGINX_HOST"}:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
}

这个文件和之前的配置文件几乎一样,除了有一行的改动:

fastcgi_pass $ENV{"NGINX_HOST"}:9000;。现在想要启动带命名为 php-fpm-api 的 PHP 容器的 NGinx 容器,就可以构建一个新的镜像,让它在以下环境变量下运行:

复制代码
docker build -t shiphp/nginx-env:test .
docker run -it --rm -e NGINX_HOST=php-fpm-api shiphp/nginx-env:test

它可以正常工作了。但是,这种方法有两个困扰的地方: 

  1. 正在使用的基础镜像已经有两年了。这会引入安全和性能风险。 
  2. 有个空的/app目录看起来并不必需,因为文件会被存储在一个不同的目录中。

最终解决方案

作者认为作为定制解决方案,从 Martin 镜像开始比较好,因此给项目建了分叉创建了新的NGinx 基础镜像并修复了上述两个问题。现在,如果要在NGinx 容器中允许动态命名的后端,可以参照:

复制代码
# 从 Docker Hub 得到最新版本
docker pull shiphp/nginx-env:latest
# 运行名为"php-fpm-api"的 PHP 容器
docker run --name php-fpm-api -v $(pwd):/var/www php:fpm
# 允许链接到 PHP-FPM 容器的 NGinx 容器
docker run --link php-fpm-api -e NGINX_HOST=php-fpm-api shiphp/nginx-env

如果想增加自己的文件或 NGinx 配置文件,来定制镜像,用Dockerfile来扩展它就可以:

复制代码
FROM shiphp/nginx-env
ONBUILD ADD <PATH_TO_YOUR_CONFIGS> /etc/nginx/conf.d/
...

现在所有的 PHP-FPM 容器都使用了它们自己的 Docker 镜像实例,这样在升级 NGinx,改变权限或做某些调整时,就变得非常轻松了。

所有的代码都在Github 上,如果读者看到任何问题或有改进建议,可以直接创建一个问题单。如果有疑问或任何Docker 相关的,可以在Twitter 上找到我继续探讨。

查看英文原文:  https://www.shiphp.com/blog/2018/nginx-php-fpm-with-env

感谢张婵对本文的审校。

2018-07-22 19:002283

评论 1 条评论

发布
暂无评论
发现更多内容

架构师训练营第二周总结

王铭铭

基于docker部署的Java应用jmx无法远程访问的问题

qihuajun

架构师训练营第二次作业0616

Geek_10

领域驱动设计(DDD)学习笔记

Chank

DDD

全网唯一秃头数据集:20 万张人像,网罗各类秃头

神经星星

人工智能 程序员 人脸识别 科技互联网

第二周总结

andy

极客大学架构师训练营第一天总结

Ethan

架构师训练营第二周课后作业三

不谈

极客大学架构师训练营

架构师训练营第二周学习总结

不谈

极客大学架构师训练营

ElasticSearch原理解析

Chank

elasticsearch

教程序员使用Jekyll搭建漂亮的个人博客

小傅哥

小傅哥 Jekyll GitHub Pages 个人博客

杜克大学提出 AI 算法,拯救渣画质马赛克秒变高清

神经星星

人工智能 算法 分辨率 GAN

第二周作业

新世界

架构

架构训练营-第二节

刘志刚

架构师week2 作业

李锦

极客大学架构师训练营

构架师训练营-第二周总结

Dawn

极客大学架构师训练营

第二周总结

王锟

编程的本质

陈皮

Architecture Programing

架构师培训 -02 面向对象基本设计原则

刘敏

Week2学习总结

Frank Zeng

架构师训练营第二周作业

王铭铭

面向对象设计学习总结

周冬辉

架构师训练营 week2

devfan

设计模式

极客大学架构师训练营第一天作业

Ethan

架构师训练营week2 学习小结

李锦

依赖倒置及Cache重构设计

架构5班杨娟Jessie

极客大学架构师训练营

架构师训练营第二周学习总结

James-Pang

极客大学架构师训练营

架构师训练营Week2

Frank Zeng

架构师训练营-第二周作业

Linuxer

极客大学架构师训练营

GitHub 热榜:适合初学者学习的 Prometheus 监控系统

JackTian

GitHub 开源 运维 Prometheus 监控系统

对进入面向对象世界的思考

云飞

UML 面向对象设计原则

为所有PHP-FPM容器构建单独的NGinx Dock镜像_PHP_Karl Hughes_InfoQ精选文章