cbeneke/hcloud-cloud-controller-manager

Hetzner Cloud Kubernetes云控制器管理器

https://travis-ci.org/hetznercloud/hcloud-cloud-controller-manager.svg?branch=master](https://travis-ci.org/hetznercloud/hcloud-cloud-controller-manager)

Hetzner Cloud云控制器管理器用于将您的Kubernetes集群与Hetzner Cloud API集成。关于Kubernetes云控制器管理器的更多信息，请参考https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/%E3%80%82

核心功能

• 实例接口：为节点添加beta.kubernetes.io/instance-type标签（服务器类型），设置外部IPv4和IPv6地址，并删除已从Hetzner Cloud中移除的Kubernetes节点。
• 区域接口：通过设置failure-domain.beta.kubernetes.io/region和failure-domain.beta.kubernetes.io/zone标签，让Kubernetes感知服务器的故障域。

使用场景

适用于在Hetzner Cloud环境中部署Kubernetes集群的场景，帮助集群管理节点的实例信息、故障域等云服务相关功能，提升集群与云平台的集成度。

配置与部署示例

以下部署示例使用kubeadm引导Kubernetes集群，搭配https://github.com/coreos/flannel%E4%BD%9C%E4%B8%BA%E8%A6%86%E7%9B%96%E7%BD%91%E7%BB%9C%E4%BB%A3%E7%90%86%E3%80%82%E8%AF%B7%E6%A0%B9%E6%8D%AE%E5%AE%9E%E9%99%85%E9%9C%80%E6%B1%82%E8%B0%83%E6%95%B4%E6%AD%A5%E9%AA%A4%E3%80%82

前提条件

需具备Kubernetes、kubeadm及相关组件的基础知识。

部署步骤

1. 配置kubelet
   在初始化集群前，需向kubelet添加--cloud-provider=external标志。创建systemd drop-in单元文件/etc/systemd/system/kubelet.service.d/20-hcloud.conf：

   [Service]
   Environment="KUBELET_EXTRA_ARGS=--cloud-provider=external"
   

   重新加载systemd并重启kubelet：

   sh
   sudo systemctl daemon-reload
   sudo systemctl restart kubelet
   

2. 初始化集群 master

   sh
   sudo kubeadm init --pod-network-cidr=10.244.0.0/16
   

3. 配置kubectl

   sh
   mkdir -p $HOME/.kube
   sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
   sudo chown $(id -u):$(id -g) $HOME/.kube/config
   

4. 部署flannel CNI插件

   sh
   kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.9.1/Documentation/kube-flannel.yml
   

5. 补丁flannel部署
   为flannel添加容忍uninitialized污点：

   sh
   kubectl -n kube-system patch ds kube-flannel-ds --type json -p '[{"op":"add","path":"/spec/template/spec/tolerations/-","value":{"key":"node.cloudprovider.kubernetes.io/uninitialized","value":"true","effect":"NoSchedule"}}]'
   

6. 创建Hetzner Cloud API令牌 secret

   sh
   kubectl -n kube-system create secret generic hcloud --from-literal=token=<您的Hetzner Cloud API令牌>
   

7. 部署hcloud-cloud-controller-manager

   sh
   kubectl apply -f https://raw.githubusercontent.com/hetznercloud/hcloud-cloud-controller-manager/master/deploy/v1.3.0.yaml
   

许可证

Apache License, Version 2.0