设置 Konnectivity 服务

    你需要有一个 Kubernetes 集群,并且 kubectl 命令可以与集群通信。 建议在至少有两个不充当控制平面主机的节点的集群上运行本教程。 如果你还没有集群,可以使用 创建一个集群。

    配置 Konnectivity 服务

    接下来的步骤需要出口配置,比如:

    你需要配置 API 服务器来使用 Konnectivity 服务,并将网络流量定向到集群节点:

    1. 创建一个出站流量配置文件,比如 。

    2. 将 API 服务器的 --egress-selector-config-file 参数设置为你的 API 服务器的离站流量配置文件路径。

    3. 如果你在使用 UDS 连接,须将卷配置添加到 kube-apiserver:

      1. spec:
      2. containers:
      3. volumeMounts:
      4. - name: konnectivity-uds
      5. mountPath: /etc/kubernetes/konnectivity-server
      6. readOnly: false
      7. volumes:
      8. - name: konnectivity-uds
      9. hostPath:
      10. path: /etc/kubernetes/konnectivity-server
      11. type: DirectoryOrCreate

    为 konnectivity-server 生成或者取得证书和 kubeconfig 文件。 例如,你可以使用 OpenSSL 命令行工具,基于存放在某控制面主机上 /etc/kubernetes/pki/ca.crt 文件中的集群 CA 证书来发放一个 X.509 证书。

    在控制面节点上部署 Konnectivity 服务。 下面提供的 konnectivity-server.yaml 配置清单假定在你的集群中 Kubernetes 组件都是部署为静态 Pod 的。 如果不是,你可以将 Konnectivity 服务部署为 DaemonSet。

    设置 Konnectivity 服务 - 图2

    1. apiVersion: v1
    2. kind: Pod
    3. metadata:
    4. name: konnectivity-server
    5. namespace: kube-system
    6. spec:
    7. priorityClassName: system-cluster-critical
    8. hostNetwork: true
    9. containers:
    10. - name: konnectivity-server-container
    11. image: registry.k8s.io/kas-network-proxy/proxy-server:v0.0.32
    12. command: ["/proxy-server"]
    13. args: [
    14. "--logtostderr=true",
    15. # 下一行需与 egressSelectorConfiguration 中设置的值一致。
    16. "--uds-name=/etc/kubernetes/konnectivity-server/konnectivity-server.socket",
    17. # 下面两行假定 Konnectivity 服务器被部署在与 apiserver 相同的机器上,
    18. # 并且该 API 服务器的证书和密钥位于指定的位置。
    19. "--cluster-cert=/etc/kubernetes/pki/apiserver.crt",
    20. # 下一行需与 egressSelectorConfiguration 中设置的值一致。
    21. "--server-port=0",
    22. "--agent-port=8132",
    23. "--admin-port=8133",
    24. "--health-port=8134",
    25. "--agent-namespace=kube-system",
    26. "--agent-service-account=konnectivity-agent",
    27. "--kubeconfig=/etc/kubernetes/konnectivity-server.conf",
    28. "--authentication-audience=system:konnectivity-server"
    29. ]
    30. livenessProbe:
    31. httpGet:
    32. scheme: HTTP
    33. host: 127.0.0.1
    34. port: 8134
    35. path: /healthz
    36. initialDelaySeconds: 30
    37. timeoutSeconds: 60
    38. ports:
    39. - name: agentport
    40. containerPort: 8132
    41. hostPort: 8132
    42. - name: adminport
    43. containerPort: 8133
    44. hostPort: 8133
    45. - name: healthport
    46. containerPort: 8134
    47. hostPort: 8134
    48. volumeMounts:
    49. - name: k8s-certs
    50. mountPath: /etc/kubernetes/pki
    51. readOnly: true
    52. - name: kubeconfig
    53. mountPath: /etc/kubernetes/konnectivity-server.conf
    54. readOnly: true
    55. readOnly: false
    56. volumes:
    57. - name: k8s-certs
    58. hostPath:
    59. path: /etc/kubernetes/pki
    60. - name: kubeconfig
    61. hostPath:
    62. path: /etc/kubernetes/konnectivity-server.conf
    63. type: FileOrCreate
    64. - name: konnectivity-uds
    65. hostPath:
    66. path: /etc/kubernetes/konnectivity-server
    67. type: DirectoryOrCreate

    在你的集群中部署 Konnectivity 代理:

    admin/konnectivity/konnectivity-agent.yaml

    设置 Konnectivity 服务 - 图4

    1. apiVersion: rbac.authorization.k8s.io/v1
    2. kind: ClusterRoleBinding
    3. metadata:
    4. name: system:konnectivity-server
    5. labels:
    6. kubernetes.io/cluster-service: "true"
    7. addonmanager.kubernetes.io/mode: Reconcile
    8. roleRef:
    9. apiGroup: rbac.authorization.k8s.io
    10. kind: ClusterRole
    11. name: system:auth-delegator
    12. subjects:
    13. - apiGroup: rbac.authorization.k8s.io
    14. kind: User
    15. name: system:konnectivity-server
    16. ---
    17. apiVersion: v1
    18. kind: ServiceAccount
    19. metadata:
    20. name: konnectivity-agent
    21. namespace: kube-system
    22. labels:
    23. addonmanager.kubernetes.io/mode: Reconcile