Azure-devops-docs: File transformation appears to be a Windows-only feature.

[sharpjs]

The code https://github.com/microsoft/azure-pipelines-tasks/tree/49c9f6a/Tasks/AzureRmWebAppDeploymentV4/deploymentProvider references file transformation only in the Windows provider implementation and not in the Linux one. Indeed, I was unable to get file transformation (specifically, JSONfiles) to work with AzureRmWebAppDeployment@4 against a Linux app service. No transformations, no error, and no transformation-related debug logging was observed.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 315ff823-9992-9f9b-62a1-42ce622ed41c
• Version Independent ID: 72ec3ffc-1dc9-b2dc-e3d4-4f14deae3720
• Content: File transforms and variable substitution - Azure Pipelines
• Content Source: docs/pipelines/tasks/transforms-variable-substitution.md
• Product: devops
• Technology: devops-cicd
• GitHub Login: @RoopeshNair
• Microsoft Alias: ronai

[WilliamAntonRohm]

@sharpjs -- Jeff, thank you for your feedback. You may find answers here:

• Azure DevOps Support Bot
• Azure DevOps on Stack Overflow

@RoopeshNair -- please look into this issue.

[sharpjs]

A workaround is to use a separate FileTransform task. This worked for me:

- task: FileTransform@2
  inputs:
    folderPath: $(Pipeline.Workspace)/path-to/my-package.zip
    jsonTargetFiles: appsettings.json
    xmlTransformationRules: '' # disabled

In my situation (Linux build agent deploying to Linux Azure App Service), the empty xmlTransformationRules is required in order to avoid a separate error, Cannot perform XML transformations on a non-Windows platform, discussed in #6563.

[cxwtool]

This issue hasn't been updated in more than 180 days, so we've closed it. If you feel the issue is still relevant and needs fixed, please reopen it and we'll take another look. We appreciate your feedback and apologize for any inconvenience.