测试您的 Rust 部署

先决条件

概述

在本节中,您将学习如何使用 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 下描述,其中只有一个容器。该容器由 GitHub Actions 在 为您的 Rust 应用程序配置 CI/CD 中构建的镜像创建。
  • NodePort 服务,它将把主机上端口 30001 的流量路由到它路由到的 Pod 中的端口 5000,允许您从网络访问您的应用程序。

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

部署和检查您的应用程序

  1. 在终端中,导航到 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
  2. 通过列出您的部署来确保一切正常。

    $ kubectl get deployments
    

    您的部署应列出如下

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

    这表示您在 YAML 中请求的所有 Pod 都已启动并正在运行。对您的服务执行相同的检查。

    $ 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-entrypoint 服务,它在端口 30001/TCP 上接受流量。

  3. 在终端中,使用 curl 命令访问该服务。

    $ curl https://127.0.0.1:30001/users
    [{"id":1,"login":"root"}]
    
  4. 运行以下命令以拆除您的应用程序。

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

总结

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

相关信息