Terraform AWS EKS 中配置 VPC CNI 网络策略日志的最佳实践

在 AWS EKS 集群中配置 Kubernetes NetworkPolicy 日志记录是一个常见的运维需求，特别是在使用 Amazon VPC CNI 插件时。本文将详细介绍如何通过 Terraform 实现这一功能，并探讨其中的关键考虑因素。

核心配置方案

通过 Terraform 配置 EKS 集群时，我们可以利用 cluster_addons 模块来启用 VPC CNI 的网络策略日志功能。基础配置如下：

cluster_addons = {
  vpc-cni = {
    most_recent      = true
    before_compute   = true
    service_account_role_arn = module.vpc_cni_irsa.iam_role_arn
    configuration_values = jsonencode({
      enableNetworkPolicy = "true",
      nodeAgent = {
        enableCloudWatchLogs = "true"
      }
    })
  }
}

IAM 权限配置

为了实现日志记录功能，我们需要为 VPC CNI 的服务账号配置适当的 IAM 权限。标准的 VPC CNI IAM 策略不包含 CloudWatch 日志权限，因此需要额外添加：

module "vpc_cni_irsa" {
  source  = "terraform-aws-modules/iam/aws//modules/iam-role-for-service-accounts-eks"
  version = "~> 5.0"

  role_name_prefix   = "VPC-CNI-IRSA"
  attach_vpc_cni_policy = true
  vpc_cni_enable_ipv4  = true

  # 添加CloudWatch日志权限
  additional_iam_policies = {
    CloudWatchLogs = <<-EOT
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "logs:DescribeLogGroups",
            "logs:CreateLogGroup",
            "logs:CreateLogStream",
            "logs:PutLogEvents"
          ],
          "Resource": "*"
        }
      ]
    }
    EOT
  }

  oidc_providers = {
    main = {
      provider_arn        = module.eks.oidc_provider_arn
      namespace_service_accounts = ["kube-system:aws-node"]
    }
  }
}

高级配置考虑

在实际生产环境中，我们还需要考虑以下几个关键点：

1. 日志组管理：建议通过 Terraform 显式创建 CloudWatch 日志组，这样可以更好地控制日志保留策略、标签和其他配置项。

2. 资源命名：了解 VPC CNI 自动创建的日志组命名规则很重要，通常它会与集群名称相关联。

3. 权限细化：在生产环境中，建议将日志权限限制到特定的日志组资源，而不是使用通配符"*"。

4. 模块化设计：随着 EKS 相关 Terraform 模块的演进，未来可能会在专门的 Pod Identity 模块中集成这些功能。

实施建议

对于生产环境部署，建议采用以下最佳实践：

1. 预先创建 CloudWatch 日志组并配置适当的保留策略
2. 为日志组添加有意义的标签以便于管理
3. 使用最小权限原则，限制 IAM 角色只能访问必要的资源
4. 考虑将日志配置与集群配置分离，便于独立管理

通过以上配置，您可以实现一个完整的网络策略日志记录解决方案，既能满足安全审计需求，又能保持基础设施即代码的最佳实践。