packethost/cluster-api-provider-packet

Kubernetes Cluster API Provider for Equinix Metal (原Packet)

镜像概述

本镜像实现了Kubernetes Cluster API规范，是面向Equinix Metal（原Packet）云平台的集群管理提供商。作为Kubernetes原生解决方案，它允许用户通过声明式API在Equinix Metal云平台上创建、配置、升级和删除Kubernetes集群，实现集群生命周期的自动化管理。

核心功能与特性

1. Kubernetes Cluster API集成

• 完全符合Kubernetes Cluster API v1alphaX/v1betaX规范，无缝集成Kubernetes控制平面
• 支持与Cluster API核心组件（如Cluster API Controller Manager）协同工作

2. Equinix Metal资源管理

• 自动化管理Equinix Metal云平台资源，包括：
  • 裸金属服务器（Bare Metal Servers）
  • 网络资源（VLAN、子网、防火墙规则）
  • 存储配置
• 支持Equinix Metal地域（Region）和设施（Facility）选择

3. 声明式集群生命周期管理

• 通过Kubernetes CRD（自定义资源定义）声明集群配置
• 支持集群创建、升级、缩容、扩容和删除等全生命周期操作
• 配置变更自动同步，确保集群状态与声明一致

4. 高可用性与灵活性

• 支持多控制平面节点配置，实现集群高可用
• 可自定义节点规格、操作系统、网络插件等集群参数
• 兼容主流Kubernetes版本，支持版本升级

使用场景

1. 企业级Kubernetes集群部署

适用于需要在Equinix Metal云平台上快速部署生产级Kubernetes集群的企业用户，通过标准化配置确保集群一致性。

2. 集群生命周期自动化

适合需要自动化管理集群创建、升级和维护的DevOps团队，减少手动操作成本，降低人为错误风险。

3. 多集群管理

支持在Equinix Metal上创建和管理多个Kubernetes集群，满足多环境（开发、测试、生产）隔离需求。

4. 混合云/多云战略

作为Cluster API生态的一部分，可与其他云平台的Cluster API Provider配合，支持混合云或多云环境下的统一集群管理。

使用方法与配置说明

前置条件

• Kubernetes集群（管理集群，用于运行Cluster API组件）
• Equinix Metal账户及API密钥（具有足够权限）
• clusterctl工具（Cluster API命令行工具）
• Docker环境（用于拉取和运行本镜像）

环境变量配置

部署步骤

1. 拉取镜像

bash
docker pull <镜像仓库地址>/cluster-api-provider-packet:<版本标签>

2. 使用clusterctl初始化提供商

bash
# 设置环境变量
export PACKET_API_KEY="your-equinix-metal-api-key"
export PACKET_PROJECT_ID="your-equinix-metal-project-id"
export CLUSTER_TOPOLOGY=true

# 初始化Cluster API与Packet提供商
clusterctl init --infrastructure packet:<版本标签>

3. 创建集群配置文件

创建集群声明文件（如cluster.yaml），定义集群规格：

yaml
apiVersion: cluster.x-k8s.io/v1beta1
kind: Cluster
metadata:
  name: my-packet-cluster
spec:
  clusterNetwork:
    pods:
      cidrBlocks: ["10.244.0.0/16"]
  infrastructureRef:
    apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
    kind: PacketCluster
    name: my-packet-cluster
---
apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: PacketCluster
metadata:
  name: my-packet-cluster
spec:
  projectID: ${PACKET_PROJECT_ID}
  facility: "sjc1"
  network:
    vlanID: "1234"  # 替换为实际VLAN ID

4. 部署集群

bash
kubectl apply -f cluster.yaml

5. 监控集群创建状态

bash
kubectl get clusters
kubectl get machines

配置示例：docker-compose（用于本地开发测试）

yaml
version: "3"
services:
  packet-provider:
    image: <镜像仓库地址>/cluster-api-provider-packet:<版本标签>
    environment:
      - PACKET_API_KEY=your-equinix-metal-api-key
      - PACKET_PROJECT_ID=your-equinix-metal-project-id
      - PACKET_FACILITY=sjc1
      - KUBERNETES_VERSION=v1.28.0
    volumes:
      - ${HOME}/.kube/config:/root/.kube/config  # 挂载管理集群kubeconfig

注意事项

• 确保Equinix Metal API密钥具有足够权限（至少包含服务器、网络资源管理权限）
• 不同版本的provider可能需要匹配特定版本的Cluster API核心组件，请参考官方版本兼容性矩阵
• 生产环境中建议使用高可用控制平面配置（至少3个控制平面节点）
• 集群删除操作会永久删除Equinix Metal资源，请谨慎操作