Terraform AWS EKS模块中KMS加密配置的注意事项

在使用Terraform AWS EKS模块(v20.0+)部署Kubernetes集群时，关于集群加密配置有一个需要特别注意的技术细节。本文将深入分析这个配置问题及其解决方案。

问题背景

当用户在使用terraform-aws-modules/eks模块时，如果同时设置create_kms_key = false且不指定cluster_encryption_config参数，会遇到以下错误提示：

Error: Unsupported attribute
This object does not have an attribute named "provider_key_arn".

这个错误发生在模块尝试访问加密配置中的provider_key_arn属性时，但实际上该属性并不存在。

问题根源分析

EKS模块默认会对集群进行加密，这需要两个关键配置：

1. 是否启用加密（通过cluster_encryption_config控制）
2. 使用哪个KMS密钥进行加密（通过create_kms_key或指定现有密钥控制）

模块的设计逻辑是：

• 默认情况下会启用加密（安全最佳实践）
• 为简化操作，默认会自动创建KMS密钥
• 如果用户明确禁用KMS密钥创建(create_kms_key = false)，但没有提供加密配置，模块无法确定应该使用哪个密钥

解决方案

有两种方式可以解决这个问题：

方案一：明确指定不使用加密

cluster_encryption_config = {}
create_kms_key = false

这种方式明确告诉模块不需要对集群进行加密。虽然这样可以解决问题，但不推荐，因为会降低集群安全性。

方案二：提供现有的KMS密钥ARN

cluster_encryption_config = {
  provider_key_arn = "arn:aws:kms:region:account-id:key/key-id"
}
create_kms_key = false

这是推荐的做法，既保持了加密的安全性，又允许使用现有的KMS密钥。

最佳实践建议

1. 保持加密启用：生产环境应该始终启用EKS集群加密
2. 密钥管理策略：
   • 对于大多数用户，使用模块自动创建的KMS密钥是最简单的选择
   • 对于有严格合规要求的组织，可以使用预先存在的KMS密钥
3. 显式配置：即使使用默认值，也建议显式声明加密配置，提高代码可读性

技术实现细节

在模块内部，加密配置的处理逻辑如下：

1. 检查是否提供了cluster_encryption_config
2. 如果没有提供，则使用默认值（启用加密）
3. 根据create_kms_key决定是创建新密钥还是使用现有密钥
4. 如果两者都不提供，则无法确定密钥来源，导致错误

理解这一逻辑有助于在遇到类似配置问题时快速定位原因。