Azure Function: Publish fails with message "Web Deploy cannot modify the file on the Destination because it is locked by an external process."

Question

I am developing an Azure Functions Project and when I publish first time, OK. Then I publish again, this Error appears:

Web Deploy cannot modify the file 'FunctionApp5.dll' on the destination because it is locked by an external process. In order to allow the publish operation to succeed, you may need to either restart your application to release the lock, or use the AppOffline rule handler for .Net applications on your next publish attempt. Learn more at: http://go.microsoft.com/fwlink/?LinkId=221672#ERROR_FILE_IN_USE.

It only Publishes if I enter Azure portal, and Restart this Azure Function App

PS. You get 'Publish failed' for other reasons too - including normal compilation failures. Make sure your app builds fully first before publishing. If the first time you see this it's due to file locking issues that doesn't mean that will always be the reason! — Simon_Weaver, Aug 23 '18 at 04:59
Does this answer your question? [Azure Web App deploy: Web Deploy cannot modify the file on the destination because it is locked by an external process](https://stackoverflow.com/questions/37918650/azure-web-app-deploy-web-deploy-cannot-modify-the-file-on-the-destination-becau) — joelmdev, Nov 01 '19 at 21:34

Tony · Accepted Answer · 2018-04-14T17:20:29.773

59

Set

MSDEPLOY_RENAME_LOCKED_FILES=1

in the Azure Function Application Settings usually resolved this

This can also be done in Visual Studio on the Publish -> Application Settings:

edited Apr 14 '18 at 17:20

answered Mar 14 '18 at 14:34

Tony

16,527
15
80
134

5

This should be by default imho and this answer should be marked as the solution. – JP Hellemons Jul 26 '18 at 09:14
If you are using 'Slot Deployment' you must do this for each slot. – Simon_Weaver Aug 23 '18 at 04:58
I get this error constantly when I try to deploy Azure Functions. I really hope this is a high priority for Microsoft to fix. – vargonian Nov 05 '18 at 07:15
I only get this error when I have the function app open in Azure (i.e. monitoring the function or something). Closing the function app and republishing succeeds. – ElliotSchmelliot Feb 05 '19 at 20:09
The kind of solution that makes my engineers get fired if they try to propose it. Poor Microsoft. – MatteoSp Mar 19 '19 at 15:33

score 4 · Answer 2 · answered Nov 09 '18 at 02:25

4

Following this article, you could also try adding this directive in your Web Deploy pubxml to instruct taking the Function app offline while deploying:

<EnableMsDeployAppOffline>True</EnableMsDeployAppOffline>

answered Nov 09 '18 at 02:25

Jeetesh Mangwani

101
1
5

score 3 · Answer 3 · answered Oct 09 '18 at 12:57

My Azure Function is in V2, and got locked down with FILE_IN_USE.

There is an open issue on this: https://github.com/Azure/azure-functions-host/issues/569

According to Paul Batum's comment from 6 Sep:

"In Functions V2 there is no shadowcopy behavior (because it does not exist in .NET core) and so running into locking issues is more likely. However we have implemented support for the "take app offline" feature that is provided through msdeploy. "

So I checked take app offline and tried, and the file is not locked when I redleploy.

Marie Hoeger · Answer 4 · 2018-01-20T01:29:39.807

2

Updated Response: Here is some documentation on steps you can take when your files are locked (besides manually restarting your app). https://github.com/projectkudu/kudu/wiki/Dealing-with-locked-files-during-deployment

edited Jan 20 '18 at 01:29

answered Jan 19 '18 at 21:33

Marie Hoeger

1,261
9
11

score 1 · Answer 5 · edited May 04 '20 at 15:06

As of time of this writing, if you are using Azure DevOps (VSTS) to deploy your application, you can select "Run From Package" in the "Azure App Service Deploy" task/step - this is available in version 4 of the task, under the "Additional Deployment Options" node.

This deployment option eliminates file locking issues as it provides atomicity, in that the application is pointed to the new zip file rather than deploying a bunch of loose files under wwwroot, some of which may be locked.

It provides you with a number of other benefits as documented here.

HTH

ToFo · Answer 6 · 2018-03-14T08:02:57.890

0

Go to the Functions tab in Azure and press the Restart button. Then try to publish again in Visual Studio. Sometimes closing the browser and opening it again or a combination of these things are nessesary.

That is all you need to do.

edited Mar 14 '18 at 08:02

answered Mar 14 '18 at 06:55

ToFo

1,643
1
19
34

score 0 · Answer 7 · answered Aug 01 '21 at 15:29

0

I just had to restart my server, and deploy manually again, and this time the deployment was successful!

answered Aug 01 '21 at 15:29

haddassah S

147
1
7

Azure Function: Publish fails with message "Web Deploy cannot modify the file on the Destination because it is locked by an external process."

7 Answers7

Linked