linode/linode-cloud-controller-manager

Linode Cloud Controller Manager (CCM) 镜像文档

1. 镜像概述和主要用途

Linode Cloud Controller Manager (CCM) 是用于 Kubernetes 的云控制器管理器，旨在为运行于 Linode 基础设施上的 Kubernetes 集群提供全面支持。其核心用途是实现 Kubernetes 与 Linode 云服务的深度集成，自动处理基础设施资源与 Kubernetes 资源的联动，简化集群运维并提升服务可靠性。

2. 核心功能和特性

2.1 自动部署负载均衡器

当部署类型为 LoadBalancer 的 Kubernetes Service 时，CCM 会自动创建并配置 Linode Node***（负载均衡器），实现集群内服务的互联网可达性，无需手动配置基础设施层负载均衡。

2.2 Linode 资源与 Kubernetes 元数据关联

自动将 Linode 实例的主机名、私有/公有 IP 地址等网络信息关联到对应的 Kubernetes Node 资源，为 DNS 解析、服务发现等 Kubernetes 核心功能提供基础数据。

2.3 节点生命周期管理

当 Linode 实例（节点）关闭时，CCM 会自动将对应 Kubernetes Node 资源标记为不可调度状态，并触发 Pod 重调度逻辑，确保服务可用性。

2.4 区域标注与故障域调度

自动为 Kubernetes Node 资源添加 linode.region 标签，标注节点所在的 Linode 区域，支持基于区域的故障域调度策略，提升集群容灾能力。

3. 使用场景和适用范围

3.1 适用场景

• 互联网服务暴露：需通过 LoadBalancer 类型 Service 将集群内服务暴露到互联网的场景（如 Web 服务、API 服务）。
• 基础设施元数据联动：需 Kubernetes 资源（如 Node、Pod）与 Linode 基础设施元数据（如 IP、主机名、区域）关联的场景。
• 故障域调度：需基于 Linode 区域实现 Pod 跨故障域分布，提升服务可用性的场景。
• 节点生命周期自动化：需自动处理 Linode 实例启停导致的节点状态变更及 Pod 调度的场景。

3.2 适用范围

• 运行于 Linode 基础设施上的 Kubernetes 集群（支持官方推荐的 Kubernetes 版本，具体版本兼容性参见 https://github.com/linode/linode-cloud-controller-manager%EF%BC%89%E3%80%82
• 需与 Linode 云服务（如 Node***、实例管理）集成的 Kubernetes 环境。

4. 使用方法和配置说明

4.1 前提条件

• 已在 Linode 上部署 Kubernetes 集群（控制平面与节点均为 Linode 实例）。
• 拥有 Linode API 令牌（需具备 linodes:read_write、nodebalancers:read_write 权限，用于操作 Linode 资源）。
• 集群节点已安装 Docker 或容器运行时，且网络可访问 Linode API（api.linode.com）及 Kubernetes API Server。

4.2 部署方式

4.2.1 使用 docker run 部署

bash
docker run -d \
  --name linode-ccm \
  --restart=always \
  -v /etc/kubernetes/kubeconfig:/etc/kubernetes/kubeconfig:ro \  # 挂载 kubeconfig（若需外部访问 K8s API）
  -e LINODE_API_TOKEN="your-linode-api-token" \                 # 必选，Linode API 令牌
  -e KUBERNETES_SERVICE_HOST="10.0.0.1" \                       # 可选，K8s API Server 地址（默认从 kubeconfig 获取）
  -e KUBERNETES_SERVICE_PORT="6443" \                           # 可选，K8s API Server 端口（默认 6443）
  -e CLUSTER_NAME="my-linode-cluster" \                         # 可选，集群名称（用于标识资源）
  linode/linode-cloud-controller-manager:latest \
  --cloud-provider=linode \                                     # 必选，指定云提供商为 linode
  --kubeconfig=/etc/kubernetes/kubeconfig                       # 必选，指定 kubeconfig 路径（或通过环境变量注入）

4.2.2 使用 docker-compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  linode-ccm:
    image: linode/linode-cloud-controller-manager:latest
    container_name: linode-ccm
    restart: always
    volumes:
      - /etc/kubernetes/kubeconfig:/etc/kubernetes/kubeconfig:ro  # 挂载 kubeconfig
    environment:
      - LINODE_API_TOKEN=your-linode-api-token                   # 必选，Linode API 令牌
      - KUBERNETES_SERVICE_HOST=10.0.0.1                          # 可选，K8s API Server 地址
      - KUBERNETES_SERVICE_PORT=6443                              # 可选，K8s API Server 端口
      - CLUSTER_NAME=my-linode-cluster                            # 可选，集群名称
    command:
      - --cloud-provider=linode
      - --kubeconfig=/etc/kubernetes/kubeconfig

启动服务：

bash
docker-compose up -d

4.3 配置参数说明

4.3.1 环境变量

4.3.2 命令行参数

5. 注意事项

• API 令牌安全：LINODE_API_TOKEN 具备高权限，需通过环境变量或密钥管理工具注入，避免明文暴露。
• 版本兼容性：确保 CCM 版本与 Kubernetes 集群版本兼容（参考 https://github.com/linode/linode-cloud-controller-manager#compatibility%EF%BC%89%E3%80%82
• 网络访问：CCM 容器需同时访问 Linode API（api.linode.com:443）和 Kubernetes API Server，确保网络策略允许双向通信。
• 资源限制：生产环境建议为 CCM 容器设置 CPU/内存资源限制（如 --cpus=0.5 --memory=512m），避免资源竞争。