为何通过Puppet Enterprise部署PostgreSQL时initdb.exe语句被跳过？

问题场景 #

我在Windows Server 2019上使用Puppet安装PostgreSQL，通过以下PowerShell脚本初始化数据目录：

if (Test-Path $PG_DATAHOME) {
    #Prevent accidental corruption of an existing instance
    Write-Host "PostgreSQL data folder already exists [$PG_DATAHOME]"
}else{
Write-Host "- Initializing a new Postgres database cluster using initdb"
Write-Host  
New-Item -ItemType Directory -Path $PG_DATAHOME | Out-Null
#Workaround for Windows ownership issues - not needed if the data folder doesn't exist yet
icacls "$PG_DATAHOME" /grant Everyone:F /T

Add-Content -Path temp_pgsql.pw -Value "$postgresqlSA"
#--locale=en_US.UTF-8，on Windows 2019 runners --locale=C
try {
    & "$PG_SERVERHOME\bin\initdb.exe" -D "$PG_DATAHOME" -E UTF8 -U "$PG_SUPERUSER" --locale=C --pwfile=temp_pgsql.pw -A md5 --no-instructions    
}
finally {
    Remove-Item -Path temp_pgsql.pw -Force
}
}

通过puppet agent -t在代理本地测试时，数据目录能成功创建并初始化，日志包含initdb的完整执行输出；但通过Puppet Enterprise部署作业时，数据目录创建后为空，initdb似乎未执行，日志缺少initdb的初始化细节。

解决方案 #

1. 检查PE作业的执行账户权限 #

• 本地执行puppet agent -t通常使用当前登录用户（如Administrator），而PE作业可能使用系统账户（Local System）或其他受限账户。
• 确认PE作业账户对$PG_SERVERHOME\bin\initdb.exe有执行权限，对$PG_DATAHOME目录有完全控制权限。
• 可在脚本开头添加Write-Host "当前执行用户：$(whoami)"，对比两种执行方式的账户差异。

2. 捕获initdb的错误输出 #

当前脚本未捕获initdb的错误信息，执行失败时无法排查。修改脚本添加错误捕获：

if (Test-Path $PG_DATAHOME) {
    Write-Host "PostgreSQL data folder already exists [$PG_DATAHOME]"
}else{
Write-Host "- Initializing a new Postgres database cluster using initdb"
Write-Host  
New-Item -ItemType Directory -Path $PG_DATAHOME | Out-Null
icacls "$PG_DATAHOME" /grant Everyone:F /T

$tempPwFile = Join-Path $env:TEMP "temp_pgsql.pw"
Add-Content -Path $tempPwFile -Value "$postgresqlSA"
try {
    & "$PG_SERVERHOME\bin\initdb.exe" -D "$PG_DATAHOME" -E UTF8 -U "$PG_SUPERUSER" --locale=C --pwfile=$tempPwFile -A md5 --no-instructions 2>&1 | Write-Host
    if ($LASTEXITCODE -ne 0) {
        throw "initdb执行失败，退出码：$LASTEXITCODE"
    }
}
catch {
    Write-Host "错误详情：$_"
    throw
}
finally {
    Remove-Item -Path $tempPwFile -Force -ErrorAction SilentlyContinue
}
}

修改后PE作业日志会显示initdb的具体错误，比如路径不存在、权限不足等。

3. 验证环境变量与路径正确性 #

• PE作业的执行环境可能缺少必要变量，在脚本开头添加变量输出：

  Write-Host "PG_SERVERHOME: $PG_SERVERHOME"
  Write-Host "PG_DATAHOME: $PG_DATAHOME"
  Write-Host "PG_SUPERUSER: $PG_SUPERUSER"
  

• 确认路径中包含空格时是否被正确引号包裹，避免路径解析错误。

4. 添加目录创建后的延迟 #

New-Item创建目录后可能存在系统同步延迟，导致initdb访问异常，可添加短时间等待：

New-Item -ItemType Directory -Path $PG_DATAHOME | Out-Null
Start-Sleep -Seconds 2

5. 指定临时文件的绝对路径 #

默认临时文件会创建在当前工作目录，PE作业的工作目录可能无写入权限，改用系统临时目录：

$tempPwFile = Join-Path $env:TEMP "temp_pgsql.pw"
Add-Content -Path $tempPwFile -Value "$postgresqlSA"
# 后续initdb命令使用$tempPwFile路径

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