Share feedback
Answers are generated based on the documentation.

测试你的 Go 部署

Table of contents

先决条件

概述

在本节中，你将学习如何使用 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:18
          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 文件中，有四个对象，由 --- 分隔。除了数据库的服务（Service）和部署（Deployment）之外，另外两个对象是：

  • 一个 Deployment，描述了一组可扩展的相同 Pod。在这种情况下，你只会得到一个副本（replica），即你的 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 http://localhost: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 环境中。

相关信息：