如何在VSTS CI/CD流程中部署Azure PostgreSQL备份新版本？

一、在VSTS PowerShell脚本中引用备份制品 #

要在发布阶段顺利调用备份文件，关键是打通构建产物的发布与下载链路，具体操作步骤如下：

• 第一步：构建阶段发布备份制品
  在你的构建定义里添加「发布构建制品」任务，指定备份文件的具体路径（比如$(Build.SourcesDirectory)/path/to/your-backup.sql），发布位置选择默认的「Azure Artifacts」，这样备份文件会和应用的.zip包一起作为构建产物被保存。
• 第二步：发布阶段下载制品
  进入发布定义，添加「下载构建制品」任务，选择对应的构建定义，设置下载路径为$(System.DefaultWorkingDirectory)（这是VSTS托管代理的默认工作目录）。任务执行后，备份文件就会被下载到代理本地。
• 第三步：PowerShell脚本中引用路径
  直接用VSTS预定义变量引用备份文件，比如你的备份文件名为db-backup.sql，脚本里可以这么写：

  $backupPath = "$(System.DefaultWorkingDirectory)/db-backup.sql"
  # 执行psql导入命令
  psql -d YourDatabaseName -U YourUsername -f $backupPath
  

二、解决托管代理缺少Postgres工具的问题 #

Azure托管代理默认未预装Postgres客户端工具，你有几个灵活的解决方案，不用急着自建VM：

方案1：使用VSTS市场的PostgreSQL扩展任务 #

在VSTS任务市场搜索「PostgreSQL」，有不少官方或第三方的现成任务（比如「PostgreSQL Deployment」），这些任务会自动在托管代理上配置psql、pg_restore等必要工具，你只需按照向导填写数据库连接信息、备份文件路径即可，无需自己编写安装脚本。

方案2：在PowerShell脚本中自动安装Postgres客户端 #

如果想自己掌控安装逻辑，可以在PowerShell脚本开头加入自动安装代码，借助Chocolatey包管理器快速部署工具，示例如下：

# 检查并安装Chocolatey（若代理未预装）
if (-not (Get-Command choco -ErrorAction SilentlyContinue)) {
    Set-ExecutionPolicy Bypass -Scope Process -Force
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
    iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
}
# 安装PostgreSQL客户端工具（包含psql和pg_restore）
choco install postgresql-client -y --no-progress

这段代码会在每次发布时自动安装工具，虽然会增加少量发布时间，但省去了维护自托管代理的麻烦。

方案3：使用自托管代理（备选） #

如果你的发布频率很高，不想每次重复安装工具，或者需要定制更多环境配置，可以在Azure上创建一个VM，安装好Postgres客户端工具和VSTS代理，再将这个代理注册到你的VSTS项目中，发布时选择该自托管代理即可。这种方案稳定性更高，适合复杂场景。

另外，你提到pg_restore无法处理归档文件，建议检查备份文件格式——如果是用pg_dump -Fp生成的纯SQL格式，psql导入完全可行；如果是自定义归档格式，可能需要调整pg_dump的参数，或者确保pg_restore的版本与备份时的Postgres版本一致。

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