如何跨虚拟机实现Terraform与Jenkins Pipeline的自动化集成？

没问题，这种Jenkins和Terraform分属不同虚拟机的部署场景非常普遍，我整理了几个经过实践验证的方案，你可以根据自身环境和需求选择：

方案1：通过Jenkins SSH插件远程执行Terraform命令 #

这是最直接的方案，不需要在Jenkins机器上安装Terraform，完全依托SSH连接到Terraform所在的虚拟机执行操作。

实现步骤： #

• 安装Jenkins的SSH插件（Manage Jenkins → Plugins → 搜索SSH Plugin并安装）
• 在Jenkins中配置Terraform虚拟机的SSH凭据（Manage Jenkins → Credentials → 添加SSH Username with private key类型的凭据）
• 在Pipeline脚本中使用sshCommand或sshScript步骤远程执行Terraform命令，示例脚本如下：

pipeline {
    agent any
    stages {
        stage('拉取Terraform代码') {
            steps {
                git url: 'https://your-git-repo/terraform-code.git', branch: 'main'
            }
        }
        stage('远程执行Terraform Init') {
            steps {
                sshCommand(
                    credentialsId: 'terraform-vm-ssh',
                    host: '192.168.1.100', // Terraform虚拟机IP
                    command: 'cd /path/to/remote/terraform/workspace && terraform init -upgrade'
                )
            }
        }
        stage('远程执行Terraform Plan') {
            steps {
                sshCommand(
                    credentialsId: 'terraform-vm-ssh',
                    host: '192.168.1.100',
                    command: 'cd /path/to/remote/terraform/workspace && terraform plan -out=tfplan'
                )
            }
        }
        stage('远程执行Terraform Apply') {
            steps {
                sshCommand(
                    credentialsId: 'terraform-vm-ssh',
                    host: '192.168.1.100',
                    command: 'cd /path/to/remote/terraform/workspace && terraform apply -auto-approve tfplan'
                )
            }
        }
    }
}

注意要点： #

• 确保Jenkins服务器能通过SSH访问Terraform虚拟机（防火墙开放22端口，SSH密钥配置正确）
• 建议将Terraform代码通过Git同步到远程虚拟机的工作目录，或者在sshCommand前用sshPut将本地拉取的代码上传到远程
• 必须使用Terraform远程后端（如S3、Terraform Cloud）管理状态文件，避免本地状态文件在跨节点操作时出现冲突

方案2：将Terraform虚拟机配置为Jenkins远程构建节点 #

把Terraform所在的虚拟机注册为Jenkins的代理节点，让Jenkins直接在该节点上执行Terraform任务，体验和Terraform安装在Jenkins本机一致。

实现步骤： #

• 在Terraform虚拟机上安装Jenkins代理（可以通过Jenkins主节点的Manage Jenkins → Nodes → New Node生成代理安装脚本，直接在目标VM执行）
• 配置节点标签（比如terraform-node），方便Pipeline指定执行节点
• 在Pipeline中指定使用该节点执行Terraform步骤，示例脚本：

pipeline {
    agent { label 'terraform-node' } // 指定在Terraform节点上执行
    stages {
        stage('拉取Terraform代码') {
            steps {
                git url: 'https://your-git-repo/terraform-code.git', branch: 'main'
            }
        }
        stage('Terraform Init') {
            steps {
                sh 'terraform init -upgrade'
            }
        }
        stage('Terraform Plan') {
            steps {
                sh 'terraform plan -out=tfplan'
            }
        }
        stage('Terraform Apply') {
            steps {
                sh 'terraform apply -auto-approve tfplan'
            }
        }
    }
}

优势： #

• 可以直接使用Jenkins的Terraform插件（如果需要），无需额外的SSH配置
• 节点资源隔离，避免Jenkins主节点负载过高
• 便于统一管理Terraform版本（在代理节点上固定安装指定版本的Terraform）

方案3：容器化Terraform执行（无需在任何节点安装Terraform） #

如果你的Jenkins环境支持Docker，可以用官方Terraform镜像来执行部署，完全摆脱节点上的Terraform安装依赖。

示例Pipeline脚本： #

pipeline {
    agent { docker { image 'hashicorp/terraform:latest' } }
    stages {
        stage('拉取代码') {
            steps {
                git url: 'https://your-git-repo/terraform-code.git', branch: 'main'
            }
        }
        stage('Terraform Init') {
            steps {
                sh 'terraform init -upgrade'
            }
        }
        stage('Terraform Plan') {
            steps {
                sh 'terraform plan -out=tfplan'
            }
        }
        stage('Terraform Apply') {
            steps {
                sh 'terraform apply -auto-approve tfplan'
            }
        }
    }
}

注意： #

• 确保Jenkins能访问Docker镜像仓库，并且有足够权限运行容器
• 同样需要配置Terraform远程后端，因为容器退出后本地状态会丢失

通用注意事项 #

• 状态文件管理：无论用哪种方案，都强烈建议使用Terraform远程后端（如AWS S3+DynamoDB、Terraform Cloud、Azure Blob Storage），这是避免状态冲突、保证部署一致性的核心
• 权限控制：确保执行Terraform的用户（Jenkins代理用户或SSH用户）拥有目标云资源的操作权限（可以通过IAM角色、服务账号密钥等方式配置）
• 版本锁定：固定Terraform版本（比如在远程节点安装指定版本，或使用带版本号的Docker镜像），避免版本差异导致的部署问题
• 日志与审计：在Pipeline中保留Terraform的执行日志，便于排查问题和审计

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