Jenkins Groovy流水线执行Terraform init报错：terraform未找到

你的问题核心是运行流水线的Jenkins Agent Pod使用的基础镜像没有预装Terraform，以下是几种可行的解决方法：

方案1：流水线内临时安装Terraform（快速验证用） #

在执行terraform init前，添加安装步骤，直接在Pod内安装Terraform：

pipeline {
    agent any
    stages {
        stage("Checkout") {
            ...
        }
        stage("Install Terraform") {
            steps {
                sh '''
                    sudo apt update
                    sudo apt install -y gnupg software-properties-common curl
                    curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
                    sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
                    sudo apt update && sudo apt install -y terraform
                '''
            }
        }
        stage("Terraform init") {
            steps {
                sh 'terraform init'
            }
        }
        ...
    }
}

注意：此方法每次运行流水线都会重新安装，速度较慢，仅适合临时验证。

方案2：构建带Terraform的自定义Jenkins Agent镜像（长期生产推荐） #

1. 编写Dockerfile，基于官方Jenkins Agent镜像扩展：

FROM jenkins/inbound-agent:latest

USER root

# 安装Terraform依赖及本体
RUN apt update && \
    apt install -y gnupg software-properties-common curl && \
    curl -fsSL https://apt.releases.hashicorp.com/gpg | apt-key add - && \
    apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main" && \
    apt update && \
    apt install -y terraform && \
    apt clean && rm -rf /var/lib/apt/lists/*

2. 构建并推送镜像到你的容器仓库：

docker build -t your-registry/jenkins-agent-terraform:latest .
docker push your-registry/jenkins-agent-terraform:latest

3. 在流水线中指定使用该自定义镜像作为Agent：

pipeline {
    agent {
        kubernetes {
            image 'your-registry/jenkins-agent-terraform:latest'
            // 可选：添加资源限制、节点标签等配置
            // resourceRequestCpu '1'
            // resourceRequestMemory '1Gi'
        }
    }
    stages {
        // 后续步骤保持不变
    }
}

或者在Jenkins的Kubernetes云全局配置中，将默认Agent镜像替换为此自定义镜像，所有流水线都会自动使用。

方案3：使用Jenkins工具安装器（无需自定义镜像） #

1. 进入Jenkins后台：Manage Jenkins -> Global Tool Configuration
2. 找到Terraform配置项，点击Add Terraform：
   • 填写工具名称（比如terraform-1.5.0）
   • 勾选Install automatically，选择需要的Terraform版本，保存配置
3. 在流水线中引用该工具：

pipeline {
    agent any
    tools {
        terraform 'terraform-1.5.0' // 名称需与全局配置一致
    }
    stages {
        // 其他stage
        stage("Terraform init") {
            steps {
                sh 'terraform init'
            }
        }
    }
}

此方法依赖Jenkins服务器能访问Terraform官方下载源，适合不能自定义镜像的场景。

内容的提问来源于stack exchange，提问作者Red Cricket