Oracle Kubernetes Installer输入变量配置详解

项目概述

Oracle Kubernetes Installer是一个基于Terraform的工具，用于在Oracle Cloud Infrastructure (OCI)上自动化部署Kubernetes集群。本文将深入解析该工具的核心配置参数，帮助用户根据实际需求定制化Kubernetes集群部署。

基础配置参数

必填OCI认证参数

这些参数是连接OCI API的基础认证信息，必须正确配置才能进行部署：

• tenancy_ocid: OCI租户的唯一标识符
• compartment_ocid: 资源将要部署到的隔离区的标识符
• user_ocid: 执行部署操作的OCI用户标识符
• fingerprint: 用户公钥指纹
• private_key_path: 用户私钥文件路径
• region: 资源部署区域，默认为us-phoenix-1

计算资源配置

实例规格配置

• etcdShape: etcd节点实例规格，默认为VM.Standard1.1
• k8sMasterShape: Kubernetes主节点实例规格
• k8sWorkerShape: Kubernetes工作节点实例规格

负载均衡配置

• master_oci_lb_enabled: 是否为主节点启用OCI负载均衡器
• etcdLBShape: etcd集群负载均衡器带宽规格
• k8sMasterLBShape: Kubernetes主节点负载均衡器带宽规格

可用域分布

可以配置各组件在不同可用域(Availability Domain)中的实例数量：

• k8sMasterAd1Count: AD1中的主节点数量
• k8sWorkerAd1Count: AD1中的工作节点数量
• etcdAd1Count: AD1中的etcd节点数量
• (类似参数适用于AD2和AD3)

存储卷配置

• worker_iscsi_volume_create: 是否为工作节点创建iSCSI卷
• worker_iscsi_volume_size: iSCSI卷大小(GB)
• worker_iscsi_volume_mount: iSCSI卷挂载路径
• (类似参数适用于etcd节点)

安全认证配置

TLS证书与SSH密钥

• ca_cert: PEM编码的CA证书(自动生成)
• ca_key: PEM编码的CA私钥(自动生成)
• api_server_private_key: API服务器私钥
• api_server_cert: API服务器证书
• ssh_private_key: 实例SSH密钥对
• ssh_public_key_openssh: OpenSSH格式公钥

网络配置

Flannel网络

• flannel_network_cidr: Flannel使用的IP范围(CIDR格式)
• flannel_backend: Flannel后端类型(VXLAN/UDP/host-gw)

网络访问模式

有三种网络访问配置模式：

1. 公共网络访问(默认)

   • control_plane_subnet_access=public
   • 控制平面实例和负载均衡器部署在公共子网
   • 可直接通过公共IP访问

2. 私有网络访问

   • control_plane_subnet_access=private
   • 所有资源部署在私有子网
   • 需要配置NAT实例进行出站通信

3. 混合网络访问

   • 控制平面实例私有，负载均衡器公共
   • 平衡安全性和可访问性

安全组规则

可配置各组件允许访问的CIDR范围：

• etcd_cluster_ingress: 允许访问etcd集群的IP范围
• master_https_ingress: 允许访问主节点HTTPS端口的IP范围
• worker_nodeport_ingress: 允许访问工作节点NodePort的IP范围

软件版本配置

可指定各组件版本：

• docker_ver: Docker版本
• etcd_ver: etcd版本
• k8s_ver: Kubernetes版本
• k8s_dashboard_ver: Kubernetes Dashboard版本
• 各组件使用的Oracle Linux镜像名称

高级配置

Docker日志管理

可配置各组件Docker容器的日志轮转策略：

• etcd_docker_max_log_size: etcd容器日志最大大小
• etcd_docker_max_log_files: etcd日志保留数量
• (类似参数适用于主节点和工作节点)

其他配置

• label_prefix: 资源名称前缀(用于区分不同部署)
• natInstanceShape: NAT实例规格
• nat_instance_ad1_enabled: 是否在AD1启用NAT实例

最佳实践建议

1. 生产环境建议使用私有网络访问模式，增强安全性
2. 高可用部署应在多个可用域均匀分布实例
3. 根据工作负载需求选择合适的实例规格
4. 定期轮换TLS证书和SSH密钥
5. 合理配置日志轮转策略，避免磁盘空间耗尽

通过合理配置这些参数，您可以构建出符合业务需求、安全可靠的Kubernetes集群环境。