使用服务访问集群中的应用程序

此页面展示了如何创建一个 Kubernetes 服务对象,外部客户端可以使用它来访问集群中运行的应用程序。该服务为运行两个实例的应用程序提供负载均衡。

开始之前

您需要拥有一个 Kubernetes 集群,并且 kubectl 命令行工具必须配置为与您的集群通信。建议您在至少有两个节点的集群上运行本教程,这些节点不充当控制平面主机。如果您还没有集群,可以使用 minikube 创建一个,或者您可以使用以下 Kubernetes 游乐场之一

目标

  • 运行两个 HelloWorld 应用程序实例。
  • 创建暴露节点端口的服务对象。
  • 使用服务对象访问运行的应用程序。

为在两个 Pod 中运行的应用程序创建服务

以下是应用程序部署的配置文件

apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello-world
spec:
  selector:
    matchLabels:
      run: load-balancer-example
  replicas: 2
  template:
    metadata:
      labels:
        run: load-balancer-example
    spec:
      containers:
        - name: hello-world
          image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:2.0
          ports:
            - containerPort: 8080
              protocol: TCP
  1. 在您的集群中运行 HelloWorld 应用程序:使用上面的文件创建应用程序部署

    kubectl apply -f https://k8s.io/examples/service/access/hello-application.yaml
    

    前面的命令创建一个 Deployment 和一个相关的 ReplicaSet。ReplicaSet 有两个 Pod,每个 Pod 运行 HelloWorld 应用程序。

  2. 显示有关部署的信息

    kubectl get deployments hello-world
    kubectl describe deployments hello-world
    
  3. 显示有关您的 ReplicaSet 对象的信息

    kubectl get replicasets
    kubectl describe replicasets
    
  4. 创建暴露部署的服务对象

    kubectl expose deployment hello-world --type=NodePort --name=example-service
    
  5. 显示有关服务的信息

    kubectl describe services example-service
    

    输出类似于此

    Name:                   example-service
    Namespace:              default
    Labels:                 run=load-balancer-example
    Annotations:            <none>
    Selector:               run=load-balancer-example
    Type:                   NodePort
    IP:                     10.32.0.16
    Port:                   <unset> 8080/TCP
    TargetPort:             8080/TCP
    NodePort:               <unset> 31496/TCP
    Endpoints:              10.200.1.4:8080,10.200.2.5:8080
    Session Affinity:       None
    Events:                 <none>
    

    记下服务的 NodePort 值。例如,在上面的输出中,NodePort 值为 31496。

  6. 列出运行 HelloWorld 应用程序的 Pod

    kubectl get pods --selector="run=load-balancer-example" --output=wide
    

    输出类似于此

    NAME                           READY   STATUS    ...  IP           NODE
    hello-world-2895499144-bsbk5   1/1     Running   ...  10.200.1.4   worker1
    hello-world-2895499144-m1pwt   1/1     Running   ...  10.200.2.5   worker2
    
  7. 获取运行 HelloWorld Pod 的一个节点的公网 IP 地址。如何获取此地址取决于您如何设置集群。例如,如果您使用的是 Minikube,则可以通过运行 kubectl cluster-info 来查看节点地址。如果您使用的是 Google Compute Engine 实例,则可以使用 gcloud compute instances list 命令查看节点的公网地址。

  8. 在您选择的节点上,创建一个允许 TCP 流量通过您的节点端口的防火墙规则。例如,如果您的服务有一个 NodePort 值为 31568,则创建一个允许 TCP 流量通过端口 31568 的防火墙规则。不同的云提供商提供不同的防火墙规则配置方式。

  9. 使用节点地址和节点端口访问 HelloWorld 应用程序

    curl http://<public-node-ip>:<node-port>
    

    其中 <public-node-ip> 是您节点的公网 IP 地址,<node-port> 是您服务的 NodePort 值。成功请求的响应是 hello 消息

    Hello, world!
    Version: 2.0.0
    Hostname: hello-world-cdd4458f4-m47c8
    

使用服务配置文件

作为使用 kubectl expose 的替代方法,您可以使用 服务配置文件 来创建服务。

清理

要删除服务,请输入以下命令

kubectl delete services example-service

要删除运行 HelloWorld 应用程序的部署、ReplicaSet 和 Pod,请输入以下命令

kubectl delete deployment hello-world

下一步

按照 使用服务连接应用程序 教程进行操作。

上次修改于 2024 年 5 月 28 日下午 9:50 PST:将节点 hello 镜像更新为 Google 的新镜像 (fa033cd15f)