如何在Kubernetes 上部署安装PHP + Nginx 多容器应用

创建 Deployment ，请使用你的编辑器打开一个名为php_ployment.yaml的新文件：

nano php_deployment.yaml

该部署将管理你的PHP-FPM Pod，因此你将把部署对象命名为php。实例属于后端层，因此你需要使用tier：backend标签将部署分组：

php_deployment.yaml

apiVersion: apps/v1kind: Deploymentmetadata:  name: php  labels:    tier: backend

对于部署spec，你将使用replicas参数指定要创建多少个该实例的副本。replicas的数量会根据你的需求和可用资源而有所不同。在本教程中，你将创建一个复制副本：

php_deployment.yaml

...spec:  replicas: 1

该部署将管理与app：php和tier：backend标签匹配的实例。在selector键下添加：

php_deployment.yaml

...  selector:    matchLabels:      app: php      tier: backend

接下来，部署spec需要实例对象定义的template。此模板将定义用于创建Pod的规范。首先，你需要添加为php服务选择器和部署的matchLabels指定的标签。在template.metadata.labels下添加app：php和tier：backend：

php_deployment.yaml

...  template:    metadata:      labels:        app: php        tier: backend

一个Pod可以有多个容器和卷，但每个都需要一个名称。通过为每个卷指定装载路径，你可以有选择地将卷装载到容器。

首先，指定容器将访问的卷。你创建了一个名为code的PVC来存放你的应用程序代码，因此也将该卷命名为code。在spec.template.spec.volumes下，添加以下内容：

php_deployment.yaml

...    spec:      volumes:      - name: code        persistentVolumeClaim:          claimName: code

接下来，指定要在此Pod中运行的容器。你可以在Docker hub找到各种镜像，在本教程中，你将使用php:7-fpm 这个镜像。

在spec.template.spec.tainers下，添加以下内容：

php_deployment.yaml

Php_ployment.yaml

...      containers:      - name: php        image: php:7-fpm

接下来，你将装载容器需要访问的卷。该容器将运行你的PHP代码，因此它需要访问code卷。你还将使用mountPath指定/code作为挂载点。

在文件 php_deployment.yaml spec.template.spec.tainers.volumemount下，添加：

...        volumeMounts:        - name: code          mountPath: /code

现在你已经挂载了卷，你需要将应用程序代码放到卷上。你可能以前使用过FTP/SFTP或通过SSH连接复制代码来完成此任务，但本步骤将向你展示如何使用Init容器复制代码。

根据安装过程的复杂程度，你可以使用单个initContainer来运行构建应用程序的脚本，也可以每个命令使用一个initContainer。请确保卷已挂载到initContainer。

在本教程中，你将使用带有busybox的单个Init容器来下载代码。busybox是一个小镜像，其中包含你将用来完成此操作的wget实用程序。

Under spec.template.spec, add your initContainer and specify the busybox image:

在文件 php_deployment.yaml spec.template.spec下，添加你的initContainer，并指定busybox镜像：

...      initContainers:      - name: install        image: busybox

你的Init Container需要访问code卷，以便它可以下载该位置的代码。在spec.template.spec.initContainers下，挂载/code路径下的code卷：

php_deployment.yaml 文件相关内容

...        volumeMounts:        - name: code          mountPath: /code

每个Init容器都需要运行一个命令。你的Init容器将使用wget将代码从gitcode下载到/code工作目录。-o选项为下载的文件命名，你可以将该文件命名为index.php。

注意：请确保信任你提取的代码。在将其放到服务器上之前，请检查源代码，以确保你对代码的功能感到满意。

在文件php_deployment.yaml spec.template.spec.initContainers中的install容器下，添加以下行：

...        command:        - wget        - "-O"        - "/code/index.php"        - https://gitcode.net/hjue/k8s-samples/-/raw/master/php-k8s/index.php

完成的php_ployment.yaml文件将如下所示：

apiVersion: apps/v1kind: Deploymentmetadata:  name: php  labels:    tier: backendspec:  replicas: 1  selector:    matchLabels:      app: php      tier: backend  template:    metadata:      labels:        app: php        tier: backend    spec:      volumes:      - name: code        persistentVolumeClaim:          claimName: code      containers:      - name: php        image: php:7-fpm        volumeMounts:        - name: code          mountPath: /code      initContainers:      - name: install        image: busybox        volumeMounts:        - name: code          mountPath: /code        command:        - wget        - "-O"        - "/code/index.php"        - https://gitcode.net/hjue/k8s-samples/-/raw/master/php-k8s/index.php

保存文件并退出编辑器。

使用kubectl创建PHP-fpm部署：

kubectl apply -f php_deployment.yaml

命令执行后，你将看到以下输出：

deployment.apps/php created

此部署将从下载指定的映像，然后向你的PersistentVolumeClaim请求PersistentVolume，并运行你的initContainers。完成后，容器将运行并将volumes挂载到指定的挂载点。一旦完成所有这些步骤，你的Pod就可以启动并运行了。

你可以通过运行以下命令来查看：

kubectl get deployments

你将看到输出：

NAME   READY   UP-TO-DATE   AVAILABLE   AGEphp    0/1     1            0           7s

以上输出可以帮助你了解部署的当前状态。Deployment 是保持所需状态的控制器之一。你创建的template指定DESIRED状态将有一个名为php的实例的副本。CURRENT字段表示有多少副本正在运行，因此这应该与DESIRED状态匹配。你可以阅读Kubernetes部署文档中的了解其余字段的说明。

你可以使用以下命令查看此部署启动的Pod：

kubectl get pods

此命令的输出会根据创建 Deployment 后经过的时间而有所不同。如果在创建后不久运行它，输出可能如下所示：

NAME                   READY     STATUS     RESTARTS   AGEphp-6b4d5555d4-dknb4   0/1       Init:0/1   0          9s

这些列表示以下信息：

• Ready: 运行该实例的副本个数。

• Status: 实例的状态。Init表示Init容器正在运行。在此输出中，1个Init容器中有0个已经运行完毕。

• Restarts: 该进程重新启动Pod的次数。如果你的任何Init容器出现故障，这个数字将会增加。部署将重新启动它，直到它达到所需的状态。

根据启动脚本的复杂程度，状态可能需要几分钟才能变为podInitializing。

OutputNAME                   READY     STATUS            RESTARTS   AGEphp-6b4d5555d4-dknb4   0/1       podInitializing   0          39s

这意味着Init容器已完成，容器正在初始化。如果在所有容器都在运行的情况下运行该命令，你会看到实例状态变为Running。

NAME                   READY     STATUS            RESTARTS   AGEphp-6b4d5555d4-dknb4   1/1       Running   0          1m

现在你可以看到Pod正在成功运行。如果你的Pod没有启动，你可以使用以下命令进行调试：

• 查看 pod 的详细信息，用实际的pod-name代替:

kubectl describe pods <pod-name>

• 查看 pod 日志:

kubectl logs <pod-name>

• 查看pod 中指定container的日志

kubectl logs <pod-name> <container-name>

你的应用程序代码已经挂载，PHP-fpm服务可以处理连接了。现在你可以创建你的Nginx部署了。

步骤6 - 创建Nginx部署

在本步骤中，你将使用ConfigMap配置Nginx。ConfigMap以键-值格式保存你的配置，你可以在其他Kubernetes对象定义中引用该格式。这种方法将使你可以灵活地重复使用镜像，或者在需要时使用不同的Nginx版本镜像。更新ConfigMap将自动更改复制到装载它的任何Pod。

使用你的编辑器为你的ConfigMap创建一个nginx_configMap.yaml文件：

nano nginx_configMap.yaml

文件nginx_configMap.yaml中将ConfigMap命名为nginx-config，并分组到tier：backend微服务中：

apiVersion: v1kind: ConfigMapmetadata:  name: nginx-config  labels:    tier: backend

接下来，你将为ConfigMap添加data。将密钥命名为config，并添加你的Nginx配置文件的内容作为该值。

由于Kubernetes可以将请求路由到服务的相应主机，因此你可以在fast cgi_pass参数中输入你的PHP-fpm服务的名称，而不是其IP地址。将以下内容添加到你的nginx_configMap.yaml文件中：

...data:  config : |    server {      index index.php index.html;      error_log  /var/log/nginx/error.log;      access_log /var/log/nginx/access.log;      root /code;      location / {          try_files $uri $uri/ /index.php?$query_string;      }      location ~ \.php$ {          try_files $uri =404;          fastcgi_split_path_info ^(.+\.php)(/.+)$;          fastcgi_pass php: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_configMap.yaml文件将如下所示：

apiVersion: v1kind: ConfigMapmetadata:  name: nginx-config  labels:    tier: backenddata:  config : |    server {      index index.php index.html;      error_log  /var/log/nginx/error.log;      access_log /var/log/nginx/access.log;      root /code;            location / {          try_files $uri $uri/ /index.php?$query_string;      }      location ~ \.php$ {          try_files $uri =404;          fastcgi_split_path_info ^(.+\.php)(/.+)$;          fastcgi_pass php:9000;          fastcgi_index index.php;          include fastcgi_params;          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;          fastcgi_param PATH_INFO $fastcgi_path_info;        }    }

保存文件并退出编辑器。

创建ConfigMap：

kubectl apply -f nginx_configMap.yaml

你将看到以下输出：

configmap/nginx-config created

你已经完成了ConfigMap的创建，现在可以构建你的Nginx部署了。

首先，在编辑器中创建一个新的nginx_ployment.yaml文件：

nano nginx_deployment.yaml

文件nginx_deployment.yaml 中 将Deployment命名为nginx，并添加标签tier：backend：

apiVersion: apps/v1kind: Deploymentmetadata:  name: nginx  labels:    tier: backend

文件 nginx_deployment.yaml 中指定在部署spec中需要一个副本。该部署将管理标签为app：nginx和tier：backend的实例。添加以下参数和值：

...spec:  replicas: 1  selector:    matchLabels:      app: nginx      tier: backend

接下来，文件nginx_deployment.yaml中添加Podtemplate。你需要使用你为部署seletor.matchLabels添加的相同标签。添加以下内容：

...  template:    metadata:      labels:        app: nginx        tier: backend

将你之前创建的codepvc的访问权限授予nginx。在nginx_deployment.yaml中spec.template.spec.volumes`下，添加：

...    spec:      volumes:      - name: code        persistentVolumeClaim:          claimName: code

Pod可以将ConfigMap挂载为卷。指定文件名和密钥将创建一个以其值作为内容的文件。要使用ConfigMap，请将path设置为存放key内容的文件的名称。你想要从密钥config创建一个文件site.conf。在spec.template.spec.volumes下，添加以下内容：

...      - name: config        configMap:          name: nginx-config          items:          - key: config            path: site.conf

警告：如果没有指定文件，则key的内容将替换卷的mountPath。这意味着如果未明确指定路径，你将丢失目标文件夹中的所有内容。

接下来，你将指定用于创建Pod的镜像。本教程将使用nginx：1.7.9镜像，但你可以在Docker hub中找到其他版本的nginx镜像。另外，让nginx在80端口可用。在文件nginx_deployment.yaml中spec.template.spec`下添加：

...      containers:      - name: nginx        image: nginx:1.7.9        ports:        - containerPort: 80

Nginx和php-fpm需要访问同一路径下的文件，因此需要在文件nginx_deployment.yaml中挂载code卷：

...        volumeMounts:        - name: code          mountPath: /code

The nginx:1.7.9 image will automatically load any configuration files under the /etc/nginx/conf.d directory. Mounting the config volume in this directory will create the file /etc/nginx/conf.d/site.conf. Under volumeMounts add the following:

nginx：1.7.9镜像会自动加载/etc/nginx/conf.d目录下的所有配置文件。在该目录下挂载config卷，将创建/etc/nginx/conf.d/site.conf文件。在volumeMounts下添加以下内容：

...        - name: config          mountPath: /etc/nginx/conf.d

你的nginx_ployment.yaml文件将如下所示：

apiVersion: apps/v1kind: Deploymentmetadata:  name: nginx  labels:    tier: backendspec:  replicas: 1  selector:    matchLabels:      app: nginx      tier: backend  template:    metadata:      labels:        app: nginx        tier: backend    spec:      volumes:      - name: code        persistentVolumeClaim:          claimName: code      - name: config        configMap:          name: nginx-config          items:          - key: config            path: site.conf      containers:      - name: nginx        image: nginx:1.7.9        ports:        - containerPort: 80        volumeMounts:        - name: code          mountPath: /code        - name: config          mountPath: /etc/nginx/conf.d

保存文件并退出编辑器。

创建Nginx部署：

kubectl apply -f nginx_deployment.yaml

以下输出表明你的展开现在已创建：

deployment.apps/nginx created

使用以下命令列出你的部署：

kubectl get deployments

你将看到Nginx和PHP-FPM部署：

NAME    READY   UP-TO-DATE   AVAILABLE   AGEphp     1/1     1            1           35mnginx   1/1     1            1           60s

列出这两种部署管理的Pod：

kubectl get pods

你将看到正在运行的Pod：

NAME                     READY   STATUS    RESTARTS   AGEphp-6b4d5555d4-dknb4     1/1     Running   0          35mnginx-6bc5d4dfc7-xdb6m   1/1     Running   0          87s

现在所有的Kubernetes对象都处于活动状态，你可以在浏览器上访问Nginx服务。

列出正在运行的服务：

kubectl get services -o wide

获取你的Nginx服务的外部IP：

NAME         TYPE        CLUSTER-IP     EXTERNAL-IP      PORT(S)    AGE     SELECTORkubernetes   ClusterIP   10.43.0.1                 443/TCP    5d20h   php          ClusterIP   10.43.76.123              9000/TCP   72m     app=php,tier=backendnginx        ClusterIP   10.43.42.97    116.196.125.86   80/TCP     71m     app=nginx,tier=backend

此时已完成了 php 和 nginx 的部署 ，你可以使用curl命令访问nginx cluster-ip ，你将看到php_info()的输出。

这时你还不能在公网访问 nginx 服务。你可以尝试在你的浏览器上，访问你的服务器的ip 地址，你将看到 404 page not found的输出。

接下来你将配置 ingress 完成最终的公网访问。

步骤7 - 创建Ingress 资源

Ingress使用路由规则配置Traefik。这个示例将使用基于路径的路由规则。通过检查传入网址的上下文来评估基于路径的路由规则。此处，路径前缀为**/。路径/**捕捉所有传入的流量。将以下内容保存为文件ingress.yaml：

apiVersion: networking.k8s.io/v1kind: Ingressmetadata:  name: nginx  annotations:    kubernetes.io/ingress.class: traefikspec:  rules:  - http:      paths:      - path: /        pathType: Prefix        backend:          service:            name: nginx            port:              number: 80

执行命令创建ingress 资源

kubectl create -f ingress.yaml

使用 get 命令查看ingress资源

kubectl get ingress

你将看到你刚刚创建的ingress，172.28.0.48 是我们 k8s 集群的INTERNAL-IP

NAME    CLASS    HOSTS   ADDRESS       PORTS   AGEnginx      *       172.28.0.48   80      15s

在你的浏览器上，输入http://your_public_ip以访问你的服务器，你将看到php_info()的输出。

步骤8 - 扩展练习

删除以上部署php 应用的所有资源

kubectl delete -f code_volume.yaml -f code_claim.yaml \   -f php_deployment.yaml  -f php_service.yaml  \   -f nginx_configMap.yaml -f nginx_deployment.yaml -f nginx_service.yaml \   -f ingress.yaml

一条命令重新部署php 应用

kubectl create -f code_volume.yaml -f code_claim.yaml \   -f php_deployment.yaml  -f php_service.yaml  \   -f nginx_configMap.yaml -f nginx_deployment.yaml -f nginx_service.yaml \   -f ingress.yaml

扩容，使用如下命令将Deployment php 的副本数增加到 3

kubectl scale --replicas=3  deployment/php

可以看到如下输出

deployment.apps/php scaled

你立即使用 kubectl get pod -o wide查看 pods，可以看到k8s集群增加了两个 php Pod，当前状态是开始初始化容器

再次使用 kubectl get pod -o wide查看 pods，新建的 pod 状态变为PodInitializing

几秒钟后，再次使用 kubectl get pod -o wide查看 pods，可以看到 两个新增的pod，已经完成初始化，处于运行状态

结论

本文所有代码的 git 仓库地址： https://gitcode.net/hjue/k8s-samples

在本教程中，你掌握了创建PHP-fpm和nginx服务，并独立管理它们。这种方法不仅可以随着你应用的发展提高项目的可伸缩性，还可以让你高效地使用资源。你还将应用程序代码存储在卷上，以便将来可以轻松更新你的服务。

原文地址： https://www.digitalocean.com/community/tutorials/how-to-deploy-a-php-application-with-kubernetes-on-ubuntu-18-04
译文地址： https://blog.csdn.net/hjue/article/details/125749041
译者：多鱼的夏天
译文出自：CSDN开发云翻译计划

来源地址：https://blog.csdn.net/hjue/article/details/125749041