Terraform AWS EKS模块中IAM策略附件被替换问题分析

问题现象

在使用Terraform AWS EKS模块(版本19.21.0)管理EKS集群时，用户遇到了一个关于IAM角色策略附件被意外替换的问题。具体表现为在执行terraform apply时，AmazonEKSClusterPolicy和AmazonEKSVPCResourceController这两个关键IAM策略附件被标记为"deposed"(废弃)状态并被销毁，但新创建的附件未能完全替代原有功能，导致EKS集群出现服务中断。

问题本质

这个问题实际上是由于Terraform资源依赖关系管理不当导致的。在用户配置中，EKS模块显式依赖于一个null_resource.prerequisites资源，这种依赖关系干扰了Terraform对IAM策略附件资源的正常管理。

技术原理

在Terraform中，当资源之间存在不必要的显式依赖(depends_on)时，可能会破坏Terraform自动建立的隐式依赖图。特别是对于IAM策略附件这类关键资源，错误的依赖关系会导致：

1. 资源被不必要地重新创建
2. 资源替换过程出现异常
3. 新旧资源交替时出现服务中断

在AWS EKS场景下，IAM策略附件控制着集群的核心权限，如VPC资源控制器访问权限等，这些权限的短暂缺失会导致集群控制平面功能异常。

解决方案

解决此问题的关键在于优化资源依赖关系管理：

1. 移除不必要的显式依赖：删除EKS模块中对null_resource.prerequisites的depends_on声明，让Terraform自动管理资源间的依赖关系。

2. 验证隐式依赖：确保所有必要的资源引用都通过变量或数据源正确传递，这样Terraform可以自动建立正确的依赖顺序。

3. 分阶段应用变更：对于关键基础设施变更，考虑分阶段执行：

   • 先应用非破坏性变更
   • 再应用可能引起资源重建的变更
   • 最后验证服务状态

最佳实践建议

1. 谨慎使用depends_on：仅在绝对必要时使用显式依赖声明，多数情况下应依赖Terraform的自动依赖解析。

2. 模块化设计：将基础设施分解为逻辑模块，每个模块内部管理自己的依赖关系。

3. 变更预审：对于生产环境，始终先执行terraform plan并仔细审查所有"forces replacement"的资源变更。

4. 监控验证：在应用变更后，立即验证核心服务状态，特别是涉及IAM权限的变更。

总结

Terraform AWS EKS模块作为管理复杂Kubernetes基础设施的强大工具，其正确使用需要深入理解Terraform的依赖管理机制。通过避免不必要的显式依赖，可以确保IAM策略附件等关键资源的平稳更新，维护EKS集群的高可用性。这一案例也提醒我们，基础设施即代码(IaC)的最佳实践不仅关乎功能实现，更在于资源生命周期的精细管理。