vincenthcui/tencentcloud-cloud-controller-manager

腾讯云Kubernetes云控制器管理器

注意：中文文档可参考https://github.com/tencentcloud/tencentcloud-cloud-controller-manager/blob/master/README_zhCN.md%E3%80%82

tencentcloud-cloud-controller-manager是腾讯云容器服务的Kubernetes云控制器管理器实现，详细了解云控制器管理器可参考Kubernetes官方文档。

警告：本项目仍在开发中，可能未达到生产就绪状态，目前仅支持Kubernetes 1.10.x版本。

核心功能

当前实现以下功能：

• nodecontroller：更新节点的云服务特定标签和地址
• routecontroller：负责在VPC中创建路由
• servicecontroller：当Kubernetes中创建Type: LoadBalancer类型的服务时，负责创建负载均衡器

使用场景

适用于在腾讯云上部署Kubernetes集群，需要集成云服务能力的场景，包括：

• 自动同步K8s节点与腾讯云实例的标签及地址信息
• 管理VPC内的网络路由以支持集群网络通信
• 为服务自动创建腾讯云负载均衡器并关联到对应服务

配置说明

必须设置--cloud-provider=external

集群中的所有kubelet必须设置--cloud-provider=external标志；kube-apiserver和kube-controller-manager不得设置--cloud-provider标志（默认不使用原生云服务提供方）。

警告：设置--cloud-provider=external会给集群所有节点添加taint: node.cloudprovider.kubernetes.io/uninitialized，云控制器管理器完成节点初始化后会移除该污点。在此之前，大部分Pod将无法调度。

K8s节点名称必须匹配实例私有IPv4地址

默认情况下，kubelet会基于节点主机名命名节点。在腾讯云容器服务中，节点主机名基于实例私有IPv4地址设置。若通过--hostname-override覆盖kubelet主机名，也会覆盖K8s中的节点名称。需确保K8s节点名称与实例私有IPv4地址一致，否则云控制器管理器无法关联节点与对应实例。

部署示例

以下为在Kubernetes集群中部署该控制器的简化示例（建议参考官方文档获取完整配置）：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: tencentcloud-cloud-controller-manager
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: tencentcloud-cloud-controller-manager
  template:
    metadata:
      labels:
        app: tencentcloud-cloud-controller-manager
    spec:
      serviceAccountName: cloud-controller-manager
      containers:
      - name: tencentcloud-cloud-controller-manager
        image: vincenthcui/tencentcloud-cloud-controller-manager
        command:
        - /tencentcloud-cloud-controller-manager
        - --cloud-provider=tencentcloud
        - --cluster-name=your-cluster-name
        - --leader-elect=true
      tolerations:
      - key: node.cloudprovider.kubernetes.io/uninitialized
        value: "true"
        effect: NoSchedule
      - key: node-role.kubernetes.io/master
        effect: NoSchedule

需替换your-cluster-name为实际集群名称，并确保服务账户cloud-controller-manager已配置相应权限。