测试你的 Rust 部署

前提条件

完成本指南的前面几节，从开发你的 Rust 应用程序开始。
在 Docker Desktop 中开启 Kubernetes。

概述

在本节中，你将学习如何使用 Docker Desktop 将你的应用程序部署到开发机器上的全功能 Kubernetes 环境。这使你能够在部署之前在本地 Kubernetes 上测试和调试你的工作负载。

创建 Kubernetes YAML 文件

在你的 docker-rust-postgres 目录下，创建一个名为 docker-rust-kubernetes.yaml 的文件。在 IDE 或文本编辑器中打开该文件，并添加以下内容。将 DOCKER_USERNAME/REPO_NAME 替换为你创建的 Docker 用户名和仓库名称，该仓库在配置你的 Rust 应用程序的 CI/CD中创建。

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    service: server
  name: server
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      service: server
  strategy: {}
  template:
    metadata:
      labels:
        service: server
    spec:
      initContainers:
        - name: wait-for-db
          image: busybox:1.28
          command:
            [
              "sh",
              "-c",
              'until nc -zv db 5432; do echo "waiting for db"; sleep 2; done;',
            ]
      containers:
        - image: DOCKER_USERNAME/REPO_NAME
          name: server
          imagePullPolicy: Always
          ports:
            - containerPort: 8000
              hostPort: 5000
              protocol: TCP
          env:
            - name: ADDRESS
              value: 0.0.0.0:8000
            - name: PG_DBNAME
              value: example
            - name: PG_HOST
              value: db
            - name: PG_PASSWORD
              value: mysecretpassword
            - name: PG_USER
              value: postgres
            - name: RUST_LOG
              value: debug
          resources: {}
      restartPolicy: Always
status: {}
---
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    service: db
  name: db
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      service: db
  strategy:
    type: Recreate
  template:
    metadata:
      labels:
        service: db
    spec:
      containers:
        - env:
            - name: POSTGRES_DB
              value: example
            - name: POSTGRES_PASSWORD
              value: mysecretpassword
            - name: POSTGRES_USER
              value: postgres
          image: postgres
          name: db
          ports:
            - containerPort: 5432
              protocol: TCP
          resources: {}
      restartPolicy: Always
status: {}
---
apiVersion: v1
kind: Service
metadata:
  labels:
    service: server
  name: server
  namespace: default
spec:
  type: NodePort
  ports:
    - name: "5000"
      port: 5000
      targetPort: 8000
      nodePort: 30001
  selector:
    service: server
status:
  loadBalancer: {}
---
apiVersion: v1
kind: Service
metadata:
  labels:
    service: db
  name: db
  namespace: default
spec:
  ports:
    - name: "5432"
      port: 5432
      targetPort: 5432
  selector:
    service: db
status:
  loadBalancer: {}

在此 Kubernetes YAML 文件中，有四个对象，由 --- 分隔。除了数据库的 Service 和 Deployment，另外两个对象是

一个 Deployment，描述了一组可伸缩的相同 Pod。在此示例中，你将获得一个副本（或 Pod 的一个拷贝）。该 Pod 在 template 下描述，其中只有一个容器。该容器是使用配置你的 Rust 应用程序的 CI/CD 中 GitHub Actions 构建的镜像创建的。
一个 NodePort Service，它将把来自你的主机上的 30001 端口的流量路由到它所路由到的 Pod 内部的 5000 端口，从而允许你从网络访问你的应用。

要了解更多关于 Kubernetes 对象的信息，请参阅Kubernetes 文档。

部署并检查你的应用

在终端中，导航到 docker-rust-postgres 目录，然后将你的应用部署到 Kubernetes。
$ kubectl apply -f docker-rust-kubernetes.yaml
你应该会看到类似如下的输出，这表明你的 Kubernetes 对象已成功创建。
deployment.apps/server created deployment.apps/db created service/server created service/db created

通过列出你的 Deployment 来确保一切正常工作。

$ kubectl get deployments

你的 Deployment 应该如下所示

NAME                 READY   UP-TO-DATE   AVAILABLE   AGE
db       1/1     1            1           2m21s
server   1/1     1            1           2m21s

这表明你在 YAML 中请求的所有 Pod 都已启动并运行。对你的 Service 也进行同样的检查。

$ kubectl get services

你应该会获得类似如下的输出。

NAME         TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
db           ClusterIP   10.105.167.81    <none>        5432/TCP         109s
kubernetes   ClusterIP   10.96.0.1        <none>        443/TCP          9d
server       NodePort    10.101.235.213   <none>        5000:30001/TCP   109s

除了默认的 kubernetes service 外，你还会看到你的 service-entrypoint service，它接受来自 30001/TCP 端口的流量。

在终端中，使用 curl 命令访问该 Service。

$ curl http://localhost:30001/users
[{"id":1,"login":"root"}]

运行以下命令来移除你的应用程序。

$ kubectl delete -f docker-rust-kubernetes.yaml

总结

在本节中，你学习了如何使用 Docker Desktop 将你的应用部署到开发机器上的全功能 Kubernetes 环境。