MicrosoftDocs / azure-docs

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

Add deploy with Core Tools to this Azure Functions doc that is #1 on Google, but very outdated #112851

Open trevorbye opened 1 year ago

trevorbye commented 1 year ago

I submitted this product issue which has more context and detail on what I ran into, but long story short, deploying with Functions Core Tools is the preferred way to deploy, but it is missing from this how-to.

As I mentioned in that issue, this article is the number 1 result on google if you search for "azure functions how to zip deploy", and it's number 2 if you leave out "zip" and only search "azure functions how to deploy". This has serious search traffic yet is very misleading with what it suggests. Metadata is also very out of date.

I asked the dev in that issue if the other 3 deploy options listed here (AZ CLI, REST, Publish-AzWebapp) should be in here at all, or excluded. It seems to me that at best they can work, and at worst (which was my case) they just won't work. Either way, the very first section here should be an H2 Deploy with Core Tools, and have similar instructions to this how-to. It would be important to mention that the Core Tools can do everything (including building + compressing), for you.

Then I would make it clear that the other options require a manual zip, and are fallbacks to using Core Tools and may not work.


Document Details

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

ggailey777 commented 1 year ago

Thanks @trevorbye for the very good suggestion, and for the SEO info as well. I'm planning to work on zip deploy/run-from-package updates soon and will make sure to include your suggestions. #assign:ggailey777

trevorbye commented 1 year ago

@ggailey777 no problem, thanks for the responsiveness and taking a look!