Oracle Terraform Kubernetes 安装器操作指南

项目概述

Oracle Terraform Kubernetes 安装器是一个基于Terraform的工具，用于在Oracle云基础设施(OCI)上自动化部署和管理Kubernetes集群。该项目通过Terraform模块化设计，简化了Kubernetes集群的创建、扩展和维护过程。

基础操作指南

1. 新建Kubernetes集群

使用Terraform部署全新Kubernetes集群是最基础的操作：

1. 在terraform.vars文件中配置必要的变量
2. 执行以下命令：

# 预览变更
terraform plan

# 执行部署
terraform apply

技术要点：在执行前务必检查terraform.vars中的配置，特别是网络、子网和安全组等关键参数。

2. 工作节点扩缩容

Kubernetes集群的弹性扩展是其核心特性之一，通过修改以下变量实现：

• k8sWorkerAd1Count
• k8sWorkerAd2Count
• k8sWorkerAd3Count

操作流程：

# 修改对应变量后预览变更
terraform plan

# 执行扩缩容
terraform apply

注意事项：

• 扩容时新节点需要时间初始化，不会立即出现在kubectl get nodes结果中
• 缩容时会自动执行kubectl drain和kubectl delete node操作
• 可使用-target参数针对特定可用性域(AD)进行操作

3. 控制平面节点扩缩容

控制平面节点的扩缩容操作类似工作节点，但需要更谨慎：

# 修改k8sMasterAdXCount变量后
terraform plan
terraform apply

重要提示：控制平面节点变更会影响集群管理功能，建议在低峰期操作。

高级运维操作

1. 节点替换策略

当节点出现异常或需要配置变更时，可以使用taint命令触发节点替换：

# 标记AD1中所有工作节点需要替换
terraform taint -module=instances-k8sworker-ad1 oci_core_instance.TFInstanceK8sWorker

# 预览变更
terraform plan

# 执行替换
terraform apply

最佳实践：

1. 替换完成后使用kubectl uncordon使新节点可调度
2. 建议按可用性域分批替换，保证服务连续性
3. 控制平面节点替换同理，但影响更大

2. Kubernetes版本升级

升级Kubernetes版本有三种策略：

方案一：全新安装（最简单）

• 修改k8s_ver变量
• 创建全新集群
• 需要迁移应用和数据

方案二：全量替换（平衡方案）

terraform apply -var k8s_ver=1.7.5

• 一次性替换所有节点
• 会有短暂服务中断
• 操作简单

方案三：渐进式替换（最复杂）

• 按可用性域逐步替换节点
• 最小化服务影响
• 操作复杂，需要精确控制

升级建议：

• 生产环境推荐方案三
• 测试环境可使用方案二
• 确保有完整的备份和回滚方案

特殊场景处理

1. GPU节点部署

GPU节点的部署需要特殊配置：

• 选择支持GPU的实例类型
• 安装GPU驱动和插件
• 配置节点标签和资源限制

2. 集群销毁

销毁集群前必须：

1. 删除所有LoadBalancer类型的Service
2. 确认无重要数据存储在集群中

terraform destroy

警告：etcd节点不支持缩容或替换，操作不当会导致数据丢失。

总结

Oracle Terraform Kubernetes安装器提供了完整的Kubernetes集群生命周期管理能力。通过合理使用各种操作策略，可以实现：

• 快速部署生产级Kubernetes集群
• 弹性扩缩容应对业务变化
• 安全可靠的版本升级
• 高效的节点维护和替换

运维人员应充分理解每种操作的影响范围和最佳实践，特别是在生产环境中操作时，建议先在测试环境验证操作流程。