如何在Terraform中通过Pageant建立SSH连接以部署文件？

我之前在Windows环境下用Terraform配合Pageant做SSH代理时，也遇到过和你一模一样的问题——plink能正常连接，但Terraform死活不认Pageant，只能靠直接传私钥才能工作。结合你的情况，给你几个实用的排查和解决步骤：

1. 确认Pageant在Terraform的可执行路径中 #

虽然你说已经把PuTTY目录加到PATH里，但要注意几个细节：

• 确认是系统PATH还是用户PATH：如果是用户PATH，而你用管理员权限运行Terraform的话，可能读不到用户PATH的内容，建议把PuTTY路径加到系统PATH里。
• 重启运行Terraform的终端：PATH变更需要重启终端才会生效，别忘这一步！
• 验证PATH配置是否生效：打开终端输入pageant，如果能直接弹出Pageant窗口，说明路径没问题；如果提示“找不到命令”，那就是PATH没配对，重新检查目录是否正确。

2. 调整Terraform的SSH连接配置 #

确保你的connection块配置正确，重点是开启代理并指定用plink作为SSH命令（这是关键！）：

connection {
  type        = "ssh"
  host        = aws_instance.instance.public_ip
  user        = "core"
  agent       = true  # 开启SSH代理支持
  ssh_command = "plink -agent %h -l %u"  # 指定用plink配合Pageant
}

为什么要加ssh_command？因为Terraform在Windows下默认的SSH客户端可能不会自动和Pageant交互，而plink本身就是PuTTY家族的工具，天生支持Pageant的密钥代理，指定它作为SSH命令后，就能直接复用Pageant里加载的密钥了。

3. 确认Pageant的运行状态 #

• 确保Pageant已经在后台运行（托盘区能看到它的图标）。
• 右键点击Pageant图标，确认你要用来连接的SSH密钥已经加载进去（如果没加载，直接把私钥文件拖到Pageant图标上就能添加）。

4. 排查权限问题 #

如果上面的步骤都试过还是不行，试试用管理员权限打开运行Terraform的终端，然后再执行terraform apply。有时候Windows的权限限制会导致Terraform无法访问Pageant的共享内存，用管理员权限能绕过这个问题。

按照上面的步骤调整后，Terraform应该就能通过Pageant建立SSH连接，正常使用file provisioner了。

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