Jenkins Pipeline执行Terraform init时读取backend.tf文件失败求助

针对Jenkins Pipeline执行terraform init时出现的Failed to read file - Terraform backend.tf file错误，结合本地可正常运行的情况，可从以下几个方向排查：

• 确认文件是否存在于Jenkins工作目录
  在terraform init步骤前添加目录文件列表打印命令（Linux用ls -la，Windows用dir），验证backend.tf是否被正确拉取到Jenkins的工作目录中。同时检查版本库的.gitignore规则，确认该文件没有被排除在拉取范围外。

• 检查文件权限
  Jenkins运行进程的用户可能没有backend.tf的读取权限，可通过ls -l backend.tf查看权限配置，必要时执行chmod +r backend.tf赋予读权限（注意遵循最小权限原则）。

• 指定正确的Terraform工作目录
  若本地是在子目录下执行Terraform命令，需确保Jenkins Pipeline也在对应子目录中运行terraform init。可通过Jenkins的dir块指定工作目录，示例：

  dir("terraform-configs") {
      sh 'terraform init'
  }
  

• 验证backend.tf文件完整性
  若backend.tf是通过Jenkins变量动态生成的，需检查变量替换是否成功。可添加cat backend.tf命令查看文件内容是否完整、格式是否正确。

• 对齐Terraform版本
  确认Jenkins节点上的Terraform版本与本地一致，不同版本的文件解析逻辑可能存在差异，执行terraform version对比版本号。

调试用Pipeline示例 #

pipeline {
    agent any
    stages {
        stage('Checkout Code') {
            steps {
                git url: '你的代码仓库地址', branch: 'main'
            }
        }
        stage('Debug: Verify Files') {
            steps {
                sh 'ls -la'
                sh '[ -f backend.tf ] && cat backend.tf || echo "backend.tf 不存在"'
            }
        }
        stage('Terraform Init') {
            steps {
                dir('你的Terraform配置目录') {
                    sh 'terraform init'
                }
            }
        }
        stage('Terraform Plan') {
            steps {
                dir('你的Terraform配置目录') {
                    sh 'terraform plan'
                }
            }
        }
        stage('Terraform Apply') {
            steps {
                dir('你的Terraform配置目录') {
                    sh 'terraform apply -auto-approve'
                }
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Safeer Pasha