写点什么

为所有 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:002269

评论 1 条评论

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

后端开发【一大波干货知识】tcp/ip定时器与滑动窗口详解

Linux服务器开发

网络协议 TCP/IP 后端开发 Linux服务器开发 C++后台开发

眼见为实,看看MySQL中的隐藏列!

码农参上

MVCC MySQL 数据库 4月月更

浅谈Vue开发小程序

Speedoooo

小程序 Vue 开发框架 小程序容器

好代码和坏代码

博文视点Broadview

vulnhub靶场解题笔记——THE PLANETS:EARTH

L0kt4r

渗透测试

实践GoF的设计模式:单例模式

华为云开发者联盟

程序设计 设计模式 单例模式 GoF 共享实例

新手指南,带你启航:如何给OpenMLDB社区贡献代码

第四范式开发者社区

机器学习 数据库 开源 开源社区

活动预告 | 对话ACE:Oracle停服俄罗斯,国产数据库未来发展

OceanBase 数据库

oceanbase

基于 KubeVela 的机器学习实践

阿里巴巴云原生

百度程序员开发避坑指南(前端篇)

百度Geek说

前端

厉害!我带的实习生仅用四步就整合好SpringSecurity+JWT实现登录认证!

沉默王二

Java

局部变量是线程安全的,原因是什么?

华为云开发者联盟

线程 高并发 变量 线程安全 局部变量

图文并茂|彻底搞懂零拷贝(Zero-Copy)技术

简说Linux内核

内存管理 Linux内核 进程管理 嵌入式开发 设备驱动

pip:带你认识一个 Python 开发工作流程中的重要工具

华为云开发者联盟

Python 项目管理 pip 依赖关系 包管理器

jackson学习之二:jackson-core

程序员欣宸

4月月更

资产设备信息管理系统的功能

低代码小观

资产管理 CRM 企业管理系统 CRM系统 企业设备管理

硅谷区块链公司Espresso Systems因涉嫌知识产权盗窃被起诉

西柚子

TASKCTL-调度监控常见问题

敏捷调度TASKCTL

kettle 分布式任务调度 ETL任务 ETL系统

"三高"Mysql - Mysql备份概览

懒时小窝

MySQL 高可用 MySQL 数据库

多场景实现供应链可视化,小家电产业出海焕发新活力

数商云

产业数字化 供应链 供应链系统

使用混合云平台企业,怎样才能做好运维?

行云管家

私有云 混合云 多云管理 云管平台

做网工还是运维好?小白求解!

行云管家

云计算 运维 网络 IT运维

一场由TiCDC异常引发的GC不干活导致的Tikv硬盘使用问题

TiDB 社区干货传送门

CentOS8安装erlang 和 RabbitMQ

阿Q说代码

4月月更 RabbitMQ安装 erlang安装

解读加密市场13种NFT类型

CECBC

为什么要做网站SEO优化?

源字节1号

SEO优化

王者荣耀商城异地多活架构设计

阿卷

架构实战营

实例解析网络编程中的另类内存泄漏

华为云开发者联盟

TCP 网络编程 网络 压力测试 内存泄漏

使用APICloud开发多端短视频应用

YonBuilder低代码开发平台

前端开发 APP开发 APICloud 多端开发 小程序开发

如何为网站建立一个FAQ页面?

小炮

FAQ

fastposter v2.7.0 发布 电商海报编辑器

物有本末

海报 fastposter 海报生成器 海报编辑器 主图编辑器

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