示例：部署带有 Redis 的 PHP Guestbook 应用程序

本教程向您展示如何使用 Kubernetes 和 Docker 构建和部署一个简单的（非生产就绪的）多层 Web 应用程序。此示例包含以下组件

一个用于存储留言簿条目的单实例 Redis
多个 Web 前端实例

目标

启动 Redis Leader。
启动两个 Redis Follower。
启动留言簿前端。
公开并查看前端服务。
清理。

开始之前

您需要有一个 Kubernetes 集群，并且必须配置 kubectl 命令行工具以与您的集群进行通信。建议在至少有两个不充当控制平面主机的节点上运行本教程。如果您还没有集群，可以使用 minikube 创建一个，或者您可以使用以下 Kubernetes 游乐场之一

您的 Kubernetes 服务器必须是 v1.14 或更高版本。要检查版本，请输入 kubectl version。

启动 Redis 数据库

留言簿应用程序使用 Redis 来存储其数据。

创建 Redis Deployment

下面包含的清单文件指定了一个 Deployment 控制器，该控制器运行一个单副本 Redis Pod。

application/guestbook/redis-leader-deployment.yaml

# SOURCE: https://cloud.google.com/kubernetes-engine/docs/tutorials/guestbook
apiVersion: apps/v1
kind: Deployment
metadata:
  name: redis-leader
  labels:
    app: redis
    role: leader
    tier: backend
spec:
  replicas: 1
  selector:
    matchLabels:
      app: redis
  template:
    metadata:
      labels:
        app: redis
        role: leader
        tier: backend
    spec:
      containers:
      - name: leader
        image: "docker.io/redis:6.0.5"
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
        ports:
        - containerPort: 6379

在您下载清单文件的目录中启动一个终端窗口。

从 redis-leader-deployment.yaml 文件应用 Redis Deployment

kubectl apply -f https://k8s.io/examples/application/guestbook/redis-leader-deployment.yaml

查询 Pod 列表以验证 Redis Pod 是否正在运行

kubectl get pods

响应应该类似于这样

NAME                           READY   STATUS    RESTARTS   AGE
redis-leader-fb76b4755-xjr2n   1/1     Running   0          13s

运行以下命令以查看 Redis Leader Pod 的日志
```
kubectl logs -f deployment/redis-leader
```

创建 Redis Leader 服务

留言簿应用程序需要与 Redis 通信以写入其数据。您需要应用一个 Service 以将流量代理到 Redis Pod。Service 定义了访问 Pod 的策略。

application/guestbook/redis-leader-service.yaml

# SOURCE: https://cloud.google.com/kubernetes-engine/docs/tutorials/guestbook
apiVersion: v1
kind: Service
metadata:
  name: redis-leader
  labels:
    app: redis
    role: leader
    tier: backend
spec:
  ports:
  - port: 6379
    targetPort: 6379
  selector:
    app: redis
    role: leader
    tier: backend

从以下 redis-leader-service.yaml 文件应用 Redis Service

kubectl apply -f https://k8s.io/examples/application/guestbook/redis-leader-service.yaml

查询 Service 列表以验证 Redis Service 是否正在运行

kubectl get service

响应应该类似于这样

NAME           TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)    AGE
kubernetes     ClusterIP   10.0.0.1     <none>        443/TCP    1m
redis-leader   ClusterIP   10.103.78.24 <none>        6379/TCP   16s

注意

此清单文件创建一个名为 redis-leader 的 Service，其标签集与之前定义的标签匹配，因此 Service 将网络流量路由到 Redis Pod。

设置 Redis Follower

虽然 Redis Leader 是一个单独的 Pod，但您可以通过添加一些 Redis Follower 或副本使其具有高可用性并满足流量需求。

application/guestbook/redis-follower-deployment.yaml

# SOURCE: https://cloud.google.com/kubernetes-engine/docs/tutorials/guestbook
apiVersion: apps/v1
kind: Deployment
metadata:
  name: redis-follower
  labels:
    app: redis
    role: follower
    tier: backend
spec:
  replicas: 2
  selector:
    matchLabels:
      app: redis
  template:
    metadata:
      labels:
        app: redis
        role: follower
        tier: backend
    spec:
      containers:
      - name: follower
        image: us-docker.pkg.dev/google-samples/containers/gke/gb-redis-follower:v2
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
        ports:
        - containerPort: 6379

从以下 redis-follower-deployment.yaml 文件应用 Redis Deployment

kubectl apply -f https://k8s.io/examples/application/guestbook/redis-follower-deployment.yaml

通过查询 Pod 列表验证两个 Redis Follower 副本是否正在运行

kubectl get pods

响应应该类似于这样

NAME                             READY   STATUS    RESTARTS   AGE
redis-follower-dddfbdcc9-82sfr   1/1     Running   0          37s
redis-follower-dddfbdcc9-qrt5k   1/1     Running   0          38s
redis-leader-fb76b4755-xjr2n     1/1     Running   0          11m

创建 Redis Follower 服务

留言簿应用程序需要与 Redis Follower 通信以读取数据。为了使 Redis Follower 可被发现，您必须设置另一个 Service。

application/guestbook/redis-follower-service.yaml

# SOURCE: https://cloud.google.com/kubernetes-engine/docs/tutorials/guestbook
apiVersion: v1
kind: Service
metadata:
  name: redis-follower
  labels:
    app: redis
    role: follower
    tier: backend
spec:
  ports:
    # the port that this service should serve on
  - port: 6379
  selector:
    app: redis
    role: follower
    tier: backend

从以下 redis-follower-service.yaml 文件应用 Redis Service

kubectl apply -f https://k8s.io/examples/application/guestbook/redis-follower-service.yaml

查询 Service 列表以验证 Redis Service 是否正在运行

kubectl get service

响应应该类似于这样

NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
kubernetes       ClusterIP   10.96.0.1       <none>        443/TCP    3d19h
redis-follower   ClusterIP   10.110.162.42   <none>        6379/TCP   9s
redis-leader     ClusterIP   10.103.78.24    <none>        6379/TCP   6m10s

注意

此清单文件创建一个名为 redis-follower 的 Service，其标签集与之前定义的标签匹配，因此 Service 将网络流量路由到 Redis Pod。

设置和公开留言簿前端

现在您的留言簿 Redis 存储已启动并正在运行，请启动留言簿 Web 服务器。与 Redis Follower 类似，前端使用 Kubernetes Deployment 部署。

留言簿应用程序使用 PHP 前端。它被配置为与 Redis Follower 或 Leader Service 通信，具体取决于请求是读操作还是写操作。前端公开一个 JSON 接口，并提供一个基于 jQuery-Ajax 的 UX。

创建留言簿前端 Deployment

application/guestbook/frontend-deployment.yaml

# SOURCE: https://cloud.google.com/kubernetes-engine/docs/tutorials/guestbook
apiVersion: apps/v1
kind: Deployment
metadata:
  name: frontend
spec:
  replicas: 3
  selector:
    matchLabels:
        app: guestbook
        tier: frontend
  template:
    metadata:
      labels:
        app: guestbook
        tier: frontend
    spec:
      containers:
      - name: php-redis
        image: us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5
        env:
        - name: GET_HOSTS_FROM
          value: "dns"
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
        ports:
        - containerPort: 80

从 frontend-deployment.yaml 文件应用前端 Deployment

kubectl apply -f https://k8s.io/examples/application/guestbook/frontend-deployment.yaml

查询 Pod 列表以验证三个前端副本是否正在运行

kubectl get pods -l app=guestbook -l tier=frontend

响应应该类似于这样

NAME                        READY   STATUS    RESTARTS   AGE
frontend-85595f5bf9-5tqhb   1/1     Running   0          47s
frontend-85595f5bf9-qbzwm   1/1     Running   0          47s
frontend-85595f5bf9-zchwc   1/1     Running   0          47s

创建前端服务

您应用的 Redis Service 只能在 Kubernetes 集群中访问，因为 Service 的默认类型是 ClusterIP。ClusterIP 为 Service 指向的一组 Pod 提供单个 IP 地址。此 IP 地址只能在集群中访问。

如果您希望访客能够访问您的留言簿，则必须将前端 Service 配置为外部可见，以便客户端可以从 Kubernetes 集群外部请求 Service。但是，Kubernetes 用户可以使用 kubectl port-forward 访问该服务，即使它使用 ClusterIP。

注意

一些云提供商（如 Google Compute Engine 或 Google Kubernetes Engine）支持外部负载均衡器。如果您的云提供商支持负载均衡器并且您想使用它，请取消注释 type: LoadBalancer。

application/guestbook/frontend-service.yaml

# SOURCE: https://cloud.google.com/kubernetes-engine/docs/tutorials/guestbook
apiVersion: v1
kind: Service
metadata:
  name: frontend
  labels:
    app: guestbook
    tier: frontend
spec:
  # if your cluster supports it, uncomment the following to automatically create
  # an external load-balanced IP for the frontend service.
  # type: LoadBalancer
  #type: LoadBalancer
  ports:
    # the port that this service should serve on
  - port: 80
  selector:
    app: guestbook
    tier: frontend

从 frontend-service.yaml 文件应用前端 Service

kubectl apply -f https://k8s.io/examples/application/guestbook/frontend-service.yaml

查询 Service 列表以验证前端 Service 是否正在运行

kubectl get services

响应应该类似于这样

NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
frontend         ClusterIP   10.97.28.230    <none>        80/TCP     19s
kubernetes       ClusterIP   10.96.0.1       <none>        443/TCP    3d19h
redis-follower   ClusterIP   10.110.162.42   <none>        6379/TCP   5m48s
redis-leader     ClusterIP   10.103.78.24    <none>        6379/TCP   11m

通过 `kubectl port-forward` 查看前端服务

运行以下命令将本地计算机上的端口 8080 转发到服务上的端口 80。

kubectl port-forward svc/frontend 8080:80

响应应该类似于这样

Forwarding from 127.0.0.1:8080 -> 80
Forwarding from [::1]:8080 -> 80

在浏览器中加载页面 https://127.0.0.1:8080 以查看您的留言簿。

通过 `LoadBalancer` 查看前端服务

如果部署了类型为 LoadBalancer 的 frontend-service.yaml 清单，则需要找到 IP 地址才能查看留言簿。

运行以下命令以获取前端 Service 的 IP 地址。

kubectl get service frontend

响应应该类似于这样

NAME       TYPE           CLUSTER-IP      EXTERNAL-IP        PORT(S)        AGE
frontend   LoadBalancer   10.51.242.136   109.197.92.229     80:32372/TCP   1m

复制外部 IP 地址，并在浏览器中加载该页面以查看您的留言簿。

注意

尝试通过输入消息并单击“提交”来添加一些留言簿条目。您输入的消息将显示在前端。此消息表示数据已通过您先前创建的 Service 成功添加到 Redis 中。

扩展 Web 前端

您可以根据需要进行扩展或缩小，因为您的服务器被定义为使用 Deployment 控制器的 Service。

运行以下命令以扩大前端 Pod 的数量

kubectl scale deployment frontend --replicas=5

查询 Pod 列表以验证正在运行的前端 Pod 的数量

kubectl get pods

响应应该类似于这样

NAME                             READY   STATUS    RESTARTS   AGE
frontend-85595f5bf9-5df5m        1/1     Running   0          83s
frontend-85595f5bf9-7zmg5        1/1     Running   0          83s
frontend-85595f5bf9-cpskg        1/1     Running   0          15m
frontend-85595f5bf9-l2l54        1/1     Running   0          14m
frontend-85595f5bf9-l9c8z        1/1     Running   0          14m
redis-follower-dddfbdcc9-82sfr   1/1     Running   0          97m
redis-follower-dddfbdcc9-qrt5k   1/1     Running   0          97m
redis-leader-fb76b4755-xjr2n     1/1     Running   0          108m

运行以下命令以缩小前端 Pod 的数量

kubectl scale deployment frontend --replicas=2

查询 Pod 列表以验证正在运行的前端 Pod 的数量

kubectl get pods

响应应该类似于这样

NAME                             READY   STATUS    RESTARTS   AGE
frontend-85595f5bf9-cpskg        1/1     Running   0          16m
frontend-85595f5bf9-l9c8z        1/1     Running   0          15m
redis-follower-dddfbdcc9-82sfr   1/1     Running   0          98m
redis-follower-dddfbdcc9-qrt5k   1/1     Running   0          98m
redis-leader-fb76b4755-xjr2n     1/1     Running   0          109m

清理

删除 Deployment 和 Service 也会删除任何正在运行的 Pod。使用标签可以通过一个命令删除多个资源。

运行以下命令以删除所有 Pod、Deployment 和 Service。

kubectl delete deployment -l app=redis
kubectl delete service -l app=redis
kubectl delete deployment frontend
kubectl delete service frontend

响应应该类似于这样

deployment.apps "redis-follower" deleted
deployment.apps "redis-leader" deleted
deployment.apps "frontend" deleted
service "frontend" deleted

查询 Pod 列表以验证是否没有 Pod 正在运行
```
kubectl get pods
```
响应应该类似于这样
```
No resources found in default namespace.
```

下一步

完成 Kubernetes 基础知识交互式教程
使用 Kubernetes 通过用于 MySQL 和 Wordpress 的持久卷创建博客
阅读有关使用服务连接应用程序的更多信息
阅读有关有效使用标签的更多信息

上次修改时间：2023 年 8 月 24 日下午 6:38 PST: 使用 code_sample 短代码代替 code 短代码 (e8b136c3b3)

示例：部署带有 Redis 的 PHP Guestbook 应用程序

目标

开始之前

启动 Redis 数据库

创建 Redis Deployment

创建 Redis Leader 服务

注意

设置 Redis Follower

创建 Redis Follower 服务

注意

设置和公开留言簿前端

创建留言簿前端 Deployment

创建前端服务

注意

通过 kubectl port-forward 查看前端服务

通过 LoadBalancer 查看前端服务

注意

扩展 Web 前端

清理

下一步

反馈

通过 `kubectl port-forward` 查看前端服务

通过 `LoadBalancer` 查看前端服务