測試您的 Go 部署

先決條件

概述

在本節中,您將學習如何使用 Docker Desktop 將您的應用程式部署到開發機器上的功能齊全的 Kubernetes 環境。這使您可以在部署之前在本地 Kubernetes 上測試和除錯工作負載。

建立 Kubernetes YAML 檔案

在您的專案目錄中,建立一個名為 docker-go-kubernetes.yaml 的檔案。在 IDE 或文字編輯器中開啟該檔案,並新增以下內容。將 DOCKER_USERNAME/REPO_NAME 替換為您的 Docker 使用者名稱和您在為您的 Go 應用程式配置 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:
        - env:
            - name: PGDATABASE
              value: mydb
            - name: PGPASSWORD
              value: whatever
            - name: PGHOST
              value: db
            - name: PGPORT
              value: "5432"
            - name: PGUSER
              value: postgres
          image: DOCKER_USERNAME/REPO_NAME
          name: server
          imagePullPolicy: Always
          ports:
            - containerPort: 8080
              hostPort: 8080
              protocol: TCP
          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: mydb
            - name: POSTGRES_PASSWORD
              value: whatever
            - 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: "8080"
      port: 8080
      targetPort: 8080
      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 在為您的 Go 應用程式配置 CI/CD中構建的映象建立。
  • NodePort 服務,它將把來自主機上的埠 30001 的流量路由到它路由到的 Pod 內部的埠 8080,從而允許您從網路訪問您的應用程式。

要詳細瞭解 Kubernetes 物件,請參閱Kubernetes 文件

部署和檢查您的應用程式

  1. 在終端中,導航到專案目錄並將您的應用程式部署到 Kubernetes。

    $ kubectl apply -f docker-go-kubernetes.yaml
    

    您應該看到類似以下內容的輸出,表明您的 Kubernetes 物件已成功建立。

    deployment.apps/db created
    service/db created
    deployment.apps/server created
    service/server created
  2. 列出您的部署以確保一切正常。

    $ kubectl get deployments
    

    您的部署應列出如下

    NAME     READY   UP-TO-DATE   AVAILABLE   AGE
    db       1/1     1            1           76s
    server   1/1     1            1           76s

    這表示所有 Pod 都已啟動並執行。對您的服務執行相同的檢查。

    $ kubectl get services
    

    您應該獲得如下內容的輸出。

    NAME         TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
    db           ClusterIP   10.96.156.90    <none>        5432/TCP         2m8s
    kubernetes   ClusterIP   10.96.0.1       <none>        443/TCP          164m
    server       NodePort    10.102.94.225   <none>        8080:30001/TCP   2m8s

    除了預設的 kubernetes 服務之外,您還可以看到您的 server 服務和 db 服務。server 服務正在埠 30001/TCP 上接受流量。

  3. 開啟一個終端並 curl 您的應用程式以驗證它是否正常工作。

    $ curl --request POST \
      --url https://:30001/send \
      --header 'content-type: application/json' \
      --data '{"value": "Hello, Oliver!"}'
    

    您應該獲得以下訊息。

    {"value":"Hello, Oliver!"}
  4. 執行以下命令來拆卸您的應用程式。

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

總結

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

相關資訊