Github Actions无法通过Terraform模块创建AWS资源求助

本地执行terraform plan能得到正确结果，但在Github Actions环境中运行时，无法创建Terraform模块中定义的AWS资源；不过根目录main.tf内的其他资源（如S3）能够正常创建。

根项目代码 #

terraform {
  backend "s3" {
    bucket = "sd-tfstorage"
    key    = "terraform/backend"
    region = "us-east-1"
  }
}
locals {
  env_name         = "sandbox"
  aws_region       = "us-east-1"
  k8s_cluster_name = "ms-cluster"
}
# Network Configuration

module "aws-network" {
  source                = "github.com/<name>/module-aws-network"
  env_name              = local.env_name
  vpc_name              = "msur-VPC"
  cluster_name          = local.k8s_cluster_name
  aws_region            = local.aws_region
  main_vpc_cidr         = "10.10.0.0/16"
  public_subnet_a_cidr  = "10.10.0.0/18"
  public_subnet_b_cidr  = "10.10.64.0/18"
  private_subnet_a_cidr = "10.10.128.0/18"
  private_subnet_b_cidr = "10.10.192.0/18"
}

# EKS Configuration
# GitOps Configuration

模块代码 #

provider "aws" {
  region = var.aws_region
}

locals {
  vpc_name     = "${var.env_name} ${var.vpc_name}"
  cluster_name = "${var.cluster_name}-${var.env_name}"
}

## AWS VPC definition
resource "aws_vpc" "main" {
  cidr_block           = var.main_vpc_cidr
  enable_dns_support   = true
  enable_dns_hostnames = true

  tags = {
    "Name"                                        = local.vpc_name,
    "kubernetes.io/cluster/${local.cluster_name}" = "shared",
  }
}

• 模块内重复定义Provider：模块中单独声明了provider "aws"，而根模块若已有Provider配置，在Github Actions环境易出现上下文冲突。Terraform规范是在根模块统一配置Provider，模块自动继承，无需在模块内单独声明。
  解决：删除模块代码中的provider "aws"块，在根项目main.tf中添加统一的AWS Provider配置：

  provider "aws" {
    region = local.aws_region
  }
  

• 私有模块拉取权限不足：如果你的模块仓库是私有Github仓库，Github Actions运行时可能没有配置访问权限（如PAT或SSH密钥），导致模块未被正确拉取，自然不会创建模块内资源。
  解决：在Github Actions工作流中添加权限配置步骤，比如使用actions/checkout时传入拥有仓库访问权限的PAT，或者配置SSH密钥用于私有仓库拉取。
• 状态文件同步异常：虽然使用S3作为后端，但Github Actions运行时可能没有正确获取最新状态，导致Terraform误判模块资源无需创建。
  解决：确保Github Actions使用的AWS账号拥有S3后端桶的读写权限，运行terraform init时正确初始化后端，必要时在terraform plan前添加terraform refresh步骤同步状态。
• 模块变量未正确声明：检查模块的variables.tf文件，确认所有传入的变量（如aws_region、env_name等）都已正确定义。若变量未声明，Terraform会静默忽略相关配置，导致模块资源不被处理。
  解决：在模块目录下的variables.tf中补充所有必要变量定义，示例：

  variable "aws_region" {
    type        = string
    description = "AWS区域"
  }
  
  variable "env_name" {
    type        = string
    description = "环境名称"
  }
  
  variable "vpc_name" {
    type        = string
    description = "VPC名称"
  }
  
  variable "cluster_name" {
    type        = string
    description = "集群名称"
  }
  
  variable "main_vpc_cidr" {
    type        = string
    description = "主VPC CIDR段"
  }
  
  # 其他子网相关变量同理补充
  

内容的提问来源于stack exchange，提问作者Sandeep D