測試您的 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 檔案中，有四個物件，以 `---` 分隔。除了資料庫的服務和部署之外，其他兩個物件是

一個部署，描述了一組可擴展的相同 Pod。在這種情況下，您將只獲得一個 Pod 的複本或副本。該 Pod（在 `template` 下描述）中只有一個容器。該容器是由 GitHub Actions 在設定 Rust 應用程式的 CI/CD中建置的映像檔所建立。
一個 NodePort 服務，它會將主機上埠 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

透過列出您的部署來確保一切正常運作。

$ 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 上的流量。

在終端機中，使用 curl 連線到服務。

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

執行以下指令以刪除您的應用程式。

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

摘要

在本節中，您學習了如何使用 Docker Desktop 將您的應用程式部署到開發機器上功能齊全的 Kubernetes 環境。

相關資訊