测试您的 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://127.0.0.1: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 环境。

相关信息