search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.31k stars 21.49k forks source link

Language around zip deployment: "run from the package" vs "mounting" package as filesystem. #22594

Closed iyerusad closed 5 years ago

iyerusad commented 5 years ago

The function app is then run from the package after a restart, and wwwroot becomes read-only.

I read this as: Function app actually runs from package, as like some kind of compiled binary. This was unclear for me: When troubleshooting, I wondered why did wwwroot still have files if "the function app is then run from package".

I found the actual behavior documented in the github issue outlining the new feature: https://github.com/Azure/app-service-announcements/issues/84

I would suggest rewording the above quote to the effect of: "After a restart, the package is mounted on wwwroot as a read-only filesystem".

May be worth including a blurb somewhere in this doc that the behavior of this feature is more verbosely described as "Run from Mounted Archive, hosted locally in d:\home\data\SitePackages or from URL (blob storage or similar).

Document Details

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

KetanChawda-MSFT commented 5 years ago

@iyerusad Thank you for providing your feedback. We will review and provide an update on this.

KetanChawda-MSFT commented 5 years ago

@iyerusad I have assigned this issue to content author to review and take right course of action on it.

jwisener commented 5 years ago

Not sure how this is suppose to work with app service plans? I mean if I have two different .net projects I'm deploying as separate packages. how is can I have one function - app within the service app point one package while another is pointing at a different one? A bit confusing on how this is suppose to work with app service plans.

iyerusad commented 5 years ago

Not particularly related to App Service Plans - App Service Plans are just the parent compute unit ("VM"/container) of Web Apps.

Each Web App runs as its own instance within a App Service Plan, complete with unique settings/folders. You can host multiple Web Apps within a single App Service plan. Function Apps are essentially Web Apps.

Deploying as Run from Package means a particular Web App will serve from a temporarily mounted zip file (essentially replacing wwwroot with read only version of zip contents). Presumably, your zip file can contain multiple projects, there is not really a restriction of what can be inside of it. The key take away is Run From Package essentially allows you to ship a read only version of your Web App file system. Strictly a change in deployment of files, no more or less.

jwisener commented 5 years ago

Okay great thanks!

ggailey777 commented 5 years ago

Note that my fix for the package language suggested in the original issue triggered this being closed. Please feel free to reopen if there are other clarifications needed in this article, or submit a new feedback issue.