Jenkins结合Terraform自动部署EC2时Terraform init阶段失败问题

• 先确认Jenkins执行节点的Terraform安装状态：在Plan阶段的首个执行步骤前新增sh 'terraform version'命令，若返回「命令不存在」报错，说明节点未安装Terraform，或安装后未将二进制文件路径加入系统环境变量。
• 验证目录结构正确性：你在checkout阶段将代码拉取到了terraform目录下，需确认拉取的仓库中确实存在aws-instance-first-script子目录，且该目录下包含后缀为.tf的有效Terraform配置文件（至少要有AWS Provider声明代码），目录不存在或无合法配置文件都会直接导致init失败。
• 修复变量插值语法错误：你编写的sh 'terraform workspace new ${environment}'使用了单引号包裹命令，Jenkins中单引号不会解析内部的变量占位符，${environment}会被原样传递给命令而非替换为你设置的参数值，该问题虽不直接导致init失败，但会在init执行完成后立刻触发报错。建议所有需要解析变量的sh命令都改用双引号，且明确使用${params.environment}取参数值。
• 检查AWS凭证有效性与权限：你配置的Jenkins凭证AWS_ACCESS_KEY_ID对应的IAM用户，需要至少拥有EC2、VPC相关资源的访问权限，凭证无效、权限不足都会导致init阶段拉取Provider、验证权限时失败。
• 排查网络连通性问题：确认Jenkins执行节点可以正常访问Terraform官方Provider镜像源，国内环境大概率会因为网络限制无法拉取AWS Provider，可在Terraform配置中添加国内镜像源，或为节点配置可正常访问外网的代理。
• 验证本地配置合法性：可以先在本地设备进入对应Terraform配置目录执行terraform init，先排除配置文件语法错误、Provider声明错误等本地配置问题，再放到Jenkins流水线中执行。

优化建议 #

你当前的代码中每次执行sh命令都重复写cd路径，容易出现拼写错误，建议将所有Terraform相关操作包裹在dir路径块中，同时新增workspace存在性判断，避免workspace已存在时new命令报错，参考代码如下：

stage('Plan') {
    steps {
        dir('terraform/aws-instance-first-script') {
            sh 'terraform init -input=false'
            sh "terraform workspace new ${params.environment} || terraform workspace select ${params.environment}"
            sh "terraform plan -input=false -out tfplan"
            sh 'terraform show -no-color tfplan > tfplan.txt'
        }
    }
}

内容的提问来源于stack exchange，提问作者Devops-Learning