Azure App Service部署任务中文件转换变量替换失效及无文件路径选项问题

问题根源 #

Azure App Service Deploy任务默认仅处理Web根目录下的标准配置文件（如web.config、app.config），对于wwwroot/secrets这类子文件夹内的自定义.config文件，由于任务未提供可视化的「Target files」输入框，默认不会触发XML转换或变量替换逻辑，导致库变量集中的连接字符串、应用设置无法替换到目标文件中。

方案一：通过任务额外参数指定目标文件 #

无需额外解压步骤，直接在Azure App Service Deploy任务的「Additional Arguments」（额外参数）中添加Web Deploy指令，指定要处理的子目录配置文件：

-enableRule:XmlFileTransform -setParamFile:"wwwroot/secrets/你的配置文件名.config"

若需批量处理该目录下所有.config文件，可使用通配符：

-enableRule:XmlFileTransform -setParam:xmlFile="wwwroot/secrets/*.config"

注意：需确保库变量集中的变量名称与.config文件内的配置项名称完全匹配，同时任务已勾选「XML Transformation」和「XML Variable substitution」选项。

方案二：分步解压转换再部署 #

按照你考虑的思路，可拆解为以下流水线步骤：

• 解压部署包：使用「Extract files」任务将zip部署包解压至指定工作目录。
• 执行文件转换：使用「File Transform」任务，在「Target files」中输入**/secrets/*.config（匹配secrets目录下所有.config文件），勾选对应转换选项并关联目标库变量集。
• 重新打包（可选）：若需保持zip包部署方式，使用「Archive files」任务将转换后的文件重新打包为zip格式。
• 部署至App Service：使用「Azure Web Deploy」任务指向转换后的文件或新打包的zip包，完成部署。

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