Poseidon/Typhoon项目：在云服务平台上部署Flatcar Linux的Kubernetes集群指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00175/article/details/148916848

Poseidon/Typhoon项目：在云服务平台上部署Flatcar Linux的Kubernetes集群指南

typhoon Minimal and free Kubernetes distribution with Terraform 项目地址: https://gitcode.com/gh_mirrors/typ/typhoon

前言

本文将详细介绍如何使用Poseidon/Typhoon项目在云服务平台上部署基于Flatcar Linux操作系统的Kubernetes集群。通过Terraform模块化部署，我们可以快速建立一个生产可用的Kubernetes环境。

技术架构概述

该方案部署的Kubernetes集群具有以下特点：

使用Flatcar Linux作为底层操作系统，这是一个专为容器化工作负载设计的轻量级Linux发行版
控制器节点运行etcd集群和Kubernetes控制平面组件（kube-apiserver、kube-scheduler等）
工作节点运行kubelet和容器运行时
网络插件可选择Cilium或Flannel
自动生成kubeconfig文件用于集群管理

准备工作

在开始部署前，请确保满足以下条件：

有效的云服务平台账户及API访问令牌
在云服务平台上注册的域名或可管理的子域
已安装Terraform v0.13.0或更高版本
本地配置好SSH密钥对

详细部署步骤

1. 配置Terraform环境

首先创建Terraform配置文件providers.tf，配置云服务平台和CT（Container Linux Config转换器）提供程序：

provider "cloudplatform" {
  token = "${chomp(file("~/.config/cloud-platform/token"))}"
}

provider "ct" {}

terraform {
  required_providers {
    ct = {
      source  = "poseidon/ct"
      version = "0.11.0"
    }
    cloudplatform = {
      source = "cloudplatform/cloudplatform"
      version = "2.27.1"
    }
  }
}

2. 准备Flatcar Linux镜像

由于云服务平台官方尚未提供Flatcar Linux镜像，我们需要手动导入：

从Flatcar Linux官方下载云服务平台格式的镜像文件
在云服务平台控制台创建自定义镜像
在Terraform中引用该镜像

data "cloudplatform_image" "flatcar-stable" {
  name = "flatcar-stable-3227.2.0.bin.bz2"
}

3. 定义Kubernetes集群

创建主配置文件定义集群参数：

module "production-cluster" {
  source = "git::https://github.com/poseidon/typhoon//cloud-platform/flatcar-linux/kubernetes?ref=v1.33.1"

  cluster_name = "production"
  region       = "nyc3"
  dns_zone     = "example.com"
  
  os_image     = data.cloudplatform_image.flatcar-stable.id
  worker_count = 3
  
  ssh_fingerprints = ["your:ssh:fingerprint:here"]
}

4. 配置SSH访问

将SSH私钥添加到ssh-agent以允许Terraform自动执行引导过程：

ssh-add ~/.ssh/id_rsa

5. 部署集群

初始化并应用Terraform配置：

terraform init
terraform plan
terraform apply

部署过程通常需要3-6分钟完成。

集群验证

部署完成后，可以通过以下方式验证集群状态：

获取kubeconfig文件
配置kubectl使用该配置文件
检查节点和Pod状态

kubectl get nodes
kubectl get pods -A

关键配置参数说明

必需参数

| 参数名 | 描述 | 示例值 | |-------|------|-------| | cluster_name | 集群唯一名称 | "production" | | region | 云服务平台区域 | "nyc3" | | dns_zone | 域名区域 | "example.com" | | os_image | Flatcar Linux镜像ID | "uploaded-flatcar-image-id" | | ssh_fingerprints | SSH公钥指纹 | ["d7:9d:79:ae:56:32:73:79:95:88:e3:a2:ab:5d:45:e7"] |

可选参数

| 参数名 | 描述 | 默认值 | |-------|------|-------| | controller_count | 控制节点数量 | 1 | | worker_count | 工作节点数量 | 1 | | controller_type | 控制节点规格 | "s-2vcpu-2gb" | | worker_type | 工作节点规格 | "s-1vcpu-2gb" | | networking | 网络插件 | "cilium" | | pod_cidr | Pod IP范围 | "10.20.0.0/14" | | service_cidr | Service IP范围 | "10.3.0.0/16" |