Bootstrap阶段PowerShell脚本执行失败，首次chef-client运行后可正常工作

我看你遇到了一个典型的Chef Bootstrap环境差异问题——脚本在首次Bootstrap时失败，但后续正常运行。这种情况大多和Bootstrap阶段的PowerShell执行限制、资源未就绪或者环境上下文有关，下面给你具体的排查和修复方案：

最可能的原因：执行策略顺序颠倒了 #

你当前的脚本是先运行pair.ps1，再设置执行策略，但Bootstrap阶段Windows默认的PowerShell执行策略大概率是Restricted，直接阻止了脚本运行。后续chef-client运行时，可能已经有其他配置修改了策略，或者环境权限更宽松，所以能正常执行。

修复方案：调整执行策略的顺序 #

把Set-ExecutionPolicy移到运行pair.ps1之前，同时简化脚本路径引用（因为已经指定了cwd为C:\scripts）：

powershell_script 'Install' do
  cwd 'C:\scripts'
  code <<-EOH
    # 先解除当前进程的执行策略限制
    Set-ExecutionPolicy -Scope Process Unrestricted -Force;
    # 直接运行当前目录下的脚本，无需重复写绝对路径
    .\\pair.ps1 -repo-host #{repohost} -repo-dir #{repodir} -repo-https-port #{repohttpsport} -management-server #{managementserver} -activation-code #{activationcode} -env #{env} -loc #{loc} -role #{role} -app #{app};
  EOH
end

额外的必要检查：确保目标目录存在 #

Bootstrap阶段如果C:\scripts目录还没创建，cwd设置会失败，导致脚本找不到路径。所以要先添加目录创建的资源：

# 先创建脚本目录，确保Bootstrap时路径存在
directory 'C:\scripts' do
  action :create
  recursive true # 如果父目录不存在也会自动创建
end

powershell_script 'Install' do
  cwd 'C:\scripts'
  code <<-EOH
    Set-ExecutionPolicy -Scope Process Unrestricted -Force;
    .\\pair.ps1 -repo-host #{repohost} -repo-dir #{repodir} -repo-https-port #{repohttpsport} -management-server #{managementserver} -activation-code #{activationcode} -env #{env} -loc #{loc} -role #{role} -app #{app};
  EOH
end

进阶排查：处理PowerShell架构差异 #

如果你的pair.ps1依赖64位环境，但Chef Bootstrap默认使用32位PowerShell（尤其是在64位系统上），可以强制指定架构：

powershell_script 'Install' do
  cwd 'C:\scripts'
  architecture :x86_64 # 强制使用64位PowerShell
  code <<-EOH
    Set-ExecutionPolicy -Scope Process Unrestricted -Force;
    .\\pair.ps1 -repo-host #{repohost} -repo-dir #{repodir} -repo-https-port #{repohttpsport} -management-server #{managementserver} -activation-code #{activationcode} -env #{env} -loc #{loc} -role #{role} -app #{app};
  EOH
end

调试技巧：捕获错误日志 #

如果还是失败，可以在脚本里添加错误捕获，输出详细日志，方便定位Bootstrap时的具体问题：

powershell_script 'Install' do
  cwd 'C:\scripts'
  code <<-EOH
    Set-ExecutionPolicy -Scope Process Unrestricted -Force;
    try {
      .\\pair.ps1 -repo-host #{repohost} -repo-dir #{repodir} -repo-https-port #{repohttpsport} -management-server #{managementserver} -activation-code #{activationcode} -env #{env} -loc #{loc} -role #{role} -app #{app};
      Write-Host "Pair script executed successfully"
    } catch {
      Write-Error "Error running pair.ps1: $($_.Exception.Message)"
      exit 1 # 让Chef捕获到错误，终止Bootstrap并输出日志
    }
  EOH
end

为什么Bootstrap阶段会有差异？ #

简单来说，Chef Bootstrap是一个极简的chef-client初始化过程，和正常的chef-client运行有几个关键不同：

• 权限上下文：Bootstrap通常以启动它的用户权限运行，可能比后续作为服务运行的chef-client权限更受限。
• 资源依赖：Bootstrap阶段不会像正常运行那样严格保证资源执行顺序，所以如果你的脚本依赖的目录、环境变量还没准备好，就会失败。
• 执行策略：默认Windows的PowerShell执行策略是Restricted，后续chef-client运行时可能已经被其他Recipe修改，或者服务运行的环境策略更宽松。

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