前面几篇把 Secret、ConfigMap、PV/PVC 拆开讲了,但真实站点要把它们拼在一起:密码进 Secret、nginx 配置进 ConfigMap、站点代码进 PV/PVC、证书再进一个 tls Secret。这篇用 WordPress 做靶子,给两套能跑通的架构------三个 Pod 分工的「正规版」和一个 Pod 打包加反代的「速成版」,顺带说清各自的取舍。
本文概要:
| 项目 | 内容 |
|---|---|
| 文章主题 | 用 Secret + ConfigMap + PV/PVC 部署 WordPress 并启用 https 的两种架构 |
| 所属类别 | 云计算 → Kubernetes → 综合实战 |
| 知识关键字 | wordpress · php-fpm · nginx.conf · tls Secret · PV/PVC · hostNetwork · subPath |
主线是「先搭起来,再谈优化」:第一、二章把需求拆成四类资源并逐个准备好,其中 2.5 专门讲 nginx.conf 怎么覆盖进容器;第三章按三个 Pod 分工部署,用 port-forward 验证 https;第四章换成单 Pod 打包 + 外层反代的写法,对比两种拓扑的差异;第五章给取舍标准,第六章是这套组合最容易踩的坑。
一、目标与架构
需求逐条落到资源上:
| 需求 | 用什么实现 |
|---|---|
| mysql 的用户名密码不能写死在 YAML | generic 类型 Secret |
| 站点必须 https 访问 | tls 类型 Secret 存证书 + nginx 监听 443 |
| 站点代码与上传的图片要持久 | NFS 上的 PV + PVC |
| nginx 配置要能改、能版本化 | ConfigMap 存 nginx.conf |
三者的分工正好是一条链路:Secret 管敏感值、ConfigMap 管非敏感配置、PV/PVC 管数据。
二、准备工作
2.1 命名空间与 NFS 目录
bash
[root@master30 ~]# kubectl create ns web
[root@master30 ~]# kubectl config set-context --current --namespace web
# master30 同时充当 NFS 服务端,导出目录 /nfsshares
[root@master30 ~]# mkdir -p /nfsshares && chmod -R 777 /nfsshares
[root@master30 ~]# echo '/nfsshares 10.1.8.0/24(rw,sync,no_root_squash)' >> /etc/exports
[root@master30 ~]# exportfs -av
exporting 10.1.8.0/24:/nfsshares
2.2 站点代码落到 NFS
把 WordPress 中文版压缩包(官方下载页 https://cn.wordpress.org/download/,示例用 wordpress-4.9.4-zh_CN.zip)放到 NFS 目录并解开:
bash
[root@master30 ~]# cd /nfsshares
[root@master30 nfsshares]# unzip wordpress-4.9.4-zh_CN.zip
[root@master30 nfsshares]# cp -a wordpress/* .
[root@master30 nfsshares]# chmod -R 777 /nfsshares
[root@master30 nfsshares]# ls | head -5
index.php
wp-admin
wp-content
wp-includes
wp-load.php
⚠️ 注意 :
chmod -R 777只为省事。php-fpm 容器里运行的是www-data,NFS 默认root_squash情况下它写不了上传目录,表现是后台传图片报「无法创建目录」。真要做权限,就在 exports 里配all_squash,anonuid=33,anongid=33。
2.3 Secret:mysql 密码
bash
# --from-literal 每项一个 key=value,键名直接对应 mysql 镜像约定的环境变量
[root@master30 ~]# kubectl create secret generic mysql \
--from-literal=MYSQL_ROOT_PASSWORD=123 \
--from-literal=MYSQL_USER=wordpress \
--from-literal=MYSQL_PASSWORD=123 \
--from-literal=MYSQL_DATABASE=wordpress
secret/mysql created
四个键名正好对上 mysql 官方镜像约定的四个环境变量名,后面 secretKeyRef 直接同名引用。
2.4 ConfigMap:nginx.conf
nginx
worker_processes auto;
events { worker_connections 1024; }
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
server {
listen 443 ssl;
server_name www.zhb.cloud;
ssl_certificate "/etc/ssl/certs/www.zhb.cloud/tls.crt";
ssl_certificate_key "/etc/ssl/certs/www.zhb.cloud/tls.key";
# 关掉绝对路径重定向,否则反代后会跳到容器内部的 host
absolute_redirect off;
root /usr/share/nginx/html;
index index.php index.html;
location ~ \.php$ {
# 指向 php-fpm 容器的 IP,Pod 重建后要同步改
fastcgi_pass 10.224.19.19:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
}
bash
[root@master30 ~]# kubectl create cm nginx-config --from-file nginx.conf
configmap/nginx-config created
整份文件做 ConfigMap 的价值在这里体现:配置从镜像里搬到了集群对象里,改配置不用碰镜像,也能进 Git 管版本。
2.5 怎么用这份配置覆盖镜像里的 nginx.conf
「覆盖」这两个字要落到具体路径上才算说清。官方 nginx 镜像里已经有两层配置:
| 镜像里的文件 | 内容 | 为什么要管它 |
|---|---|---|
/etc/nginx/nginx.conf |
主配置,末尾有一行 include /etc/nginx/conf.d/*.conf; |
我们的配置要替换的就是它 |
/etc/nginx/conf.d/default.conf |
默认站点,listen 80、root /usr/share/nginx/html |
靠上面那行 include 才被加载,主配置换了它就自动失效 |
/etc/nginx/mime.types、fastcgi_params |
主配置要 include 的配套文件 | 必须保留,缺了 nginx 直接起不来 |
覆盖的做法只有两种,差别就在挂载的是目录还是文件:
做法一:整目录挂,把 /etc/nginx 整个换掉
yaml
volumeMounts:
- name: webconfig
mountPath: /etc/nginx
volumes:
- name: webconfig
configMap:
name: nginx-config
ConfigMap 里只有 nginx.conf 一个键,挂上去之后 /etc/nginx 里就只剩这一个文件。而我们的配置里写着 include /etc/nginx/mime.types; 和 include fastcgi_params;------这两个文件已经被覆盖没了,nginx 启动时直接报:
bash
# 中文:打开 /etc/nginx/mime.types 失败(没有那个文件或目录)
nginx: [emerg] open() "/etc/nginx/mime.types" failed (2: No such file or directory)
做法二:单文件覆盖,用 subPath 只换 nginx.conf(本文采用)
yaml
volumeMounts:
- name: webconfig
# mountPath 必须写到文件名,否则 subPath 无从对应
mountPath: /etc/nginx/nginx.conf
# subPath 必须等于 ConfigMap 里的键名,也就是 --from-file 时的文件名
subPath: nginx.conf
volumes:
- name: webconfig
configMap:
name: nginx-config
mountPath 指向文件、subPath 指向卷里的键,kubelet 就把这一个文件绑到那个路径上,/etc/nginx 下的 mime.types、fastcgi_params、conf.d 全部原样保留。
覆盖生效后,进容器看两眼就能确认:
bash
# 1) 主配置已经是我们的内容:能搜到 443
[root@master30 ~]# kubectl exec wordpress -- grep listen /etc/nginx/nginx.conf
listen 443 ssl;
# 2) 被 include 的配套文件还在,目录没被清空
[root@master30 ~]# kubectl exec wordpress -- ls /etc/nginx
conf.d fastcgi_params mime.types nginx.conf
# 3) nginx 真正加载的是这份配置,-T 会打印合并后的完整配置
[root@master30 ~]# kubectl exec wordpress -- nginx -T 2>/dev/null | grep -c "listen 443 ssl"
1
两个必须记住的后果:
- 镜像自带的默认站点消失了 ------不是被删掉,而是没人再 include 它。原
nginx.conf里那行include /etc/nginx/conf.d/*.conf;随整份文件一起被替换,default.conf里的listen 80自然不再生效。自己写的 server 块是唯一入口,端口、证书、root全由这份 ConfigMap 决定。 - 改了 ConfigMap 不会自动进容器 。
subPath绑的是具体文件,不是..data软链,kubectl edit cm nginx-config改完容器里纹丝不动,再nginx -s reload也白搭------配置根本没变。要生效只能让容器重建:kubectl delete pod wordpress重新拉起。想保留「改完 reload 就生效」的热更新,就得放弃subPath。改成整目录挂到/etc/nginx/conf.d就行:原主配置会 include 这个目录,卷更新后 reload 即生效,而该目录原有文件被清掉,正好把默认站点挤掉。
顺带一句命令层面的对应:上面说的「删 Pod 重建」,写成命令就是
kubectl replace --force -f pod-wp.yaml--------force先删后建,Pod IP 会变、emptyDir会清空。改 ConfigMap 本身可以用kubectl replace -f nginx-config.yaml整份替换,代价是文件里没写的键会被删掉。edit、replace、apply三者的分工在第 2 篇第六章讲过。
2.6 PV 与 PVC
yaml
apiVersion: v1
kind: PersistentVolume
metadata:
name: wordpress
spec:
capacity:
storage: 10Gi
volumeMode: Filesystem
accessModes:
- ReadWriteOnce
nfs:
path: /nfsshares
server: 10.1.8.30
yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: wpclaim
spec:
volumeMode: Filesystem
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 10Gi
bash
[root@master30 ~]# kubectl apply -f pv-wp.yaml -f pvc-wp.yaml
persistentvolume/wordpress created
persistentvolumeclaim/wpclaim created
[root@master30 ~]# kubectl get pvc
NAME STATUS VOLUME CAPACITY ACCESS MODES AGE
wpclaim Bound wordpress 10Gi RWO 8s
STATUS 变成 Bound 才算绑定成功。
2.7 TLS 证书
bash
[root@master30 ~]# mkdir certs && cd certs
[root@master30 certs]# openssl genrsa -out www.key 2048
[root@master30 certs]# openssl req -new -key www.key -out www.csr \
-subj "/C=CN/ST=JS/L=NJ/O=ZHB/OU=DEVOPS/CN=www.zhb.cloud/emailAddress=admin@zhb.cloud"
[root@master30 certs]# openssl x509 -req -days 3650 -in www.csr -signkey www.key -out www.crt
[root@master30 certs]# kubectl create secret tls nginx-tls --cert=./www.crt --key=./www.key
secret/nginx-tls created
挂进容器后会是两个文件:tls.crt 与 tls.key,正好对应 nginx.conf 里那两行 ssl_certificate。
三、方案 A:三个 Pod 分开部署
3.1 mysql
yaml
apiVersion: v1
kind: Pod
metadata:
name: wp-db
labels:
name: wp-db
spec:
containers:
- image: hub.zhb.cloud/library/mysql:5.7
imagePullPolicy: IfNotPresent
name: wp-db
ports:
- containerPort: 3306
name: mysql
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
secretKeyRef:
name: mysql
key: MYSQL_ROOT_PASSWORD
- name: MYSQL_USER
valueFrom:
secretKeyRef:
name: mysql
key: MYSQL_USER
- name: MYSQL_PASSWORD
valueFrom:
secretKeyRef:
name: mysql
key: MYSQL_PASSWORD
- name: MYSQL_DATABASE
valueFrom:
secretKeyRef:
name: mysql
key: MYSQL_DATABASE
bash
[root@master30 ~]# kubectl apply -f pod-mysql.yaml
[root@master30 ~]# kubectl get pod wp-db -o wide
NAME READY STATUS RESTARTS AGE IP NODE
wp-db 1/1 Running 0 34s 10.224.19.20 worker31.zhb.cloud
3.2 php-fpm
php 容器不对外暴露端口,只把代码目录挂上:
yaml
apiVersion: v1
kind: Pod
metadata:
name: wp-php
labels:
name: wp-php
spec:
containers:
- image: hub.zhb.cloud/library/php:7.2-fpm-wordpress
name: wp-php
volumeMounts:
- name: web-persistent-storage
mountPath: /usr/share/nginx/html
volumes:
- name: web-persistent-storage
persistentVolumeClaim:
claimName: wpclaim
bash
[root@master30 ~]# kubectl apply -f pod-php.yaml
[root@master30 ~]# kubectl get pod wp-php -o wide
NAME READY STATUS RESTARTS AGE IP NODE
wp-php 1/1 Running 0 39s 10.224.19.19 worker31.zhb.cloud
记下这个 IP 10.224.19.19------nginx.conf 里的 fastcgi_pass 就是它。Pod 一重建 IP 就变,nginx 那边必须同步改,这是方案 A 最脆弱的环节。
3.3 nginx
yaml
apiVersion: v1
kind: Pod
metadata:
name: wordpress
labels:
name: wordpress
spec:
containers:
- image: hub.zhb.cloud/library/nginx
name: web
ports:
- containerPort: 443
name: web-port
volumeMounts:
# 站点代码:与 php-fpm 共用同一个 PVC
- name: web-persistent-storage
mountPath: /usr/share/nginx/html
# 配置文件:subPath 只覆盖 nginx.conf 这一个文件
- name: webconfig
mountPath: /etc/nginx/nginx.conf
subPath: nginx.conf
# 证书目录:Secret 里两个文件都挂进来
- name: webcerts
mountPath: /etc/ssl/certs/www.zhb.cloud
volumes:
- name: web-persistent-storage
persistentVolumeClaim:
claimName: wpclaim
- name: webconfig
configMap:
name: nginx-config
- name: webcerts
secret:
secretName: nginx-tls
三处挂载各有一个讲究:
- 代码用 PVC :
/usr/share/nginx/html与 php-fpm 挂的是同一个wpclaim,两边看到同一份文件,php 生成的页面 nginx 立刻能读。 - 配置用 subPath 单文件覆盖 :
mountPath精确写到/etc/nginx/nginx.conf,只换主配置这一个文件,/etc/nginx下的mime.types、fastcgi_params留着不动------写成挂整个/etc/nginx就会把这几个被 include 的文件一起清掉,nginx 起不来(2.5 节有报错原文)。 - 证书整卷挂 :Secret
nginx-tls里正好是tls.crt与tls.key两个键,挂成目录后文件名就是 nginx 配置里写的路径,不需要items改名。
bash
[root@master30 ~]# kubectl apply -f pod-wp.yaml
[root@master30 ~]# kubectl get pod wordpress
NAME READY STATUS RESTARTS AGE
wordpress 1/1 Running 0 20s
3.4 验证 https
Pod 的 443 端口不在宿主机上,用 port-forward 把它暴露到 master30:
bash
[root@master30 ~]# kubectl port-forward pod/wordpress --address 10.1.8.30 443:443
Forwarding from 10.1.8.30:443 -> 443
浏览器访问 https://10.1.8.30,能看到 WordPress 的安装欢迎页,就可以走安装流程了。
bash
# 命令行验证:-k 跳过自签证书校验
[root@master30 ~]# curl -k https://10.1.8.30 | head -5
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<title>WordPress › 安装</title>
⚠️ 注意 :证书的 CN 是
www.zhb.cloud,直接访问 IP 浏览器一定报「证书名称不匹配」。要么在本地hosts里把www.zhb.cloud指到10.1.8.30,要么只把它当自签证书的预期行为------这不影响功能验证。
四、方案 B:同 Pod 打包 + 外层反代
如果只想十分钟看到页面,可以把 mysql 和 wordpress 塞进同一个 Pod,外面再套一个反代。
4.1 单 Pod 跑 mysql + wordpress
同 Pod 的两个容器共享网络命名空间,wordpress 连数据库可以直接走回环地址:
yaml
apiVersion: v1
kind: Pod
metadata:
name: wp-stack
labels:
app: wp-stack
spec:
volumes:
# 数据库数据放 emptyDir,Pod 删了数据就没了,仅适合演示
- name: mysql-data
emptyDir: {}
containers:
- name: mysql
image: hub.zhb.cloud/library/mysql:latest
imagePullPolicy: IfNotPresent
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
secretKeyRef:
name: mysql
key: root_pass
- name: MYSQL_USER
valueFrom:
secretKeyRef:
name: mysql
key: user
- name: MYSQL_PASSWORD
valueFrom:
secretKeyRef:
name: mysql
key: pass
- name: MYSQL_DATABASE
value: wordpress
volumeMounts:
- mountPath: /var/lib/mysql
name: mysql-data
# 不写 ports:3306 只在 Pod 内部可见
- name: wordpress
image: hub.zhb.cloud/library/wordpress:latest
imagePullPolicy: IfNotPresent
ports:
- name: http
containerPort: 80
protocol: TCP
env:
# 同 Pod 共享网络,直接连回环
- name: WORDPRESS_DB_HOST
value: 127.0.0.1:3306
- name: WORDPRESS_DB_NAME
value: wordpress
- name: WORDPRESS_DB_USER
valueFrom:
secretKeyRef:
name: mysql
key: user
- name: WORDPRESS_DB_PASSWORD
valueFrom:
secretKeyRef:
name: mysql
key: pass
restartPolicy: Always
这套 Secret 的键名是 root_pass / user / pass:
bash
[root@master30 ~]# kubectl create secret generic mysql \
--from-literal=root_pass=123 --from-literal=user=wordpress --from-literal=pass=123123
4.2 外层 nginx:hostNetwork + 反代
yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: wp-nginx-conf
data:
default.conf: |
server {
listen 80;
server_name _;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name www.zhb.cloud;
ssl_certificate /etc/nginx/tls/tls.crt;
ssl_certificate_key /etc/nginx/tls/tls.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
client_max_body_size 64m;
location / {
# 填 wp-stack 的 Pod IP,Pod 重建后要改
proxy_pass http://10.224.148.196:80;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Port 443;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
}
yaml
apiVersion: v1
kind: Pod
metadata:
name: wp-nginx
labels:
app: nginx
spec:
# 直接用宿主机网络,省掉 NodePort / port-forward
hostNetwork: true
containers:
- name: nginx
image: hub.zhb.cloud/library/nginx:latest
imagePullPolicy: IfNotPresent
volumeMounts:
- name: conf
mountPath: /etc/nginx/conf.d/default.conf
subPath: default.conf
readOnly: true
- name: tls
mountPath: /etc/nginx/tls
readOnly: true
volumes:
- name: conf
configMap:
name: wp-nginx-conf
- name: tls
secret:
secretName: wordpress-tls
hostNetwork: true 让这个 Pod 直接占用宿主机的 80/443,访问 https://10.1.8.30 就行,不用再 port-forward。
bash
[root@master30 ~]# kubectl create secret tls wordpress-tls --cert=./www.crt --key=./www.key
[root@master30 ~]# kubectl apply -f config-proxy-wp.yaml -f pod-proxy-wp.yaml
configmap/wp-nginx-conf created
pod/wp-nginx created
五、两套方案怎么选

| 维度 | 方案 A:三个 Pod | 方案 B:同 Pod + 反代 |
|---|---|---|
| 资源数量 | Pod × 3 + PVC + CM + Secret × 2 | Pod × 2 + CM + Secret × 2 |
| 数据持久 | 站点走 PV/PVC,数据库靠自己 | 数据库用 emptyDir,Pod 删即丢 |
| 改配置影响面 | 只重建 nginx | 改反代配置要重建整条链路 |
| 扩容 | 各层可独立扩 | 只能整体复制,数据库随之复制 |
| 换数据库 IP | 改 fastcgi_pass |
改 proxy_pass |
| 适合 | 长期维护的站点 | 十分钟看效果的演示 |
两条路的共同点值得记牢:密码进 Secret、配置进 ConfigMap、代码进 PV/PVC、证书进 tls Secret 。
拓扑怎么变,这四条分工不变。
⚠️ 注意 :方案 B 用
emptyDir存 mysql 数据,Pod 一删数据全丢。要保留就把mysql-data换成指向 PVC 的卷;但 mysql 数据目录在 NFS 上会有锁与权限问题,生产上更稳的是给数据库单独的块存储。
六、排错速查
| 现象 | 原因 | 处理 |
|---|---|---|
ImagePullBackOff |
私有仓库没带凭据 | 加 imagePullSecrets 引用 docker-registry 类型 Secret |
| 访问首页 502 | fastcgi_pass 指向的 Pod IP 已失效 |
取出 php-fpm 的新 IP 改 nginx.conf,再删 Pod 重建(见下一条) |
| 改了 ConfigMap,容器里配置没变 | subPath 挂载不热更新,绑的是具体文件 |
kubectl delete pod wordpress 重建;或改成整目录挂载再 nginx -s reload |
| 打开是 403 / 404 | NFS 目录权限不对,或 index.php 没解压到位 |
chmod -R 777 /nfshares,确认目录里有 index.php |
| 浏览器报证书名称不匹配 | 证书 CN 是域名,访问用的是 IP | 配本地 hosts,或改证书 CN 为访问用的名字 |
| 后台传图失败 | php 进程对上传目录无写权限 | exports 配 all_squash,anonuid=33,anongid=33 |
| 页面一直跳回容器内地址 | 反代后 nginx 用了绝对路径重定向 | 加 absolute_redirect off |
七、清理
bash
[root@master30 ~]# kubectl delete pod wp-db wp-php wordpress wp-stack wp-nginx --force
[root@master30 ~]# kubectl delete pvc wpclaim && kubectl delete pv wordpress
[root@master30 ~]# kubectl delete cm nginx-config wp-nginx-conf
[root@master30 ~]# kubectl delete secret mysql nginx-tls wordpress-tls
[root@master30 ~]# kubectl delete ns web
📚 参考资料(官方文档)
英文原版
中文版
附:命令英文全称速查表
| 缩写/字段 | 英文全称 | 含义 |
|---|---|---|
wordpress |
WordPress | 开源建站系统 |
php-fpm |
PHP FastCGI Process Manager | PHP 的 FastCGI 进程管理器 |
PVC |
PersistentVolumeClaim | 持久卷申领 |
PV |
PersistentVolume | 持久卷 |
NFS |
Network File System | 网络文件系统 |
hostNetwork |
host network | 直接使用宿主机网络命名空间 |
fastcgi_pass |
fastcgi pass | nginx 把 PHP 请求转给谁 |
proxy_pass |
proxy pass | nginx 反向代理目标 |
absolute_redirect |
absolute redirect | 是否用绝对路径做重定向 |
总结 :把四类资源拼成一个站点,关键是分工别乱------Secret 放密码与证书、ConfigMap 放
nginx.conf、PV/PVC 放代码、subPath只覆盖单个配置文件。方案 A 三个 Pod 各管一段,职责清晰但要盯着 Pod IP;方案 B 一个 Pod 打包加反代,十分钟能跑起来但数据库数据不持久。真正决定能不能长期用的是持久化与 IP 稳定性,而不是镜像本身。
💬 你部署 WordPress 这类站点时,是拆开跑还是塞一个 Pod?数据库有没有上过 NFS?评论区聊聊你踩过的坑。
