Merge pull request #281039 from mattchenderson/dotnet-zip

updating zip structure reference

Author: Stacyrch140

articles/azure-functions/deployment-zip-push.md

@@ -24,18 +24,14 @@ To speed up development, you might find it easier to deploy your function app pr
 
 For more information, see the [.zip deployment reference](https://github.com/projectkudu/kudu/wiki/Deploying-from-a-zip-file).
 
-## Deployment .zip file requirements
-
-The .zip file that you use for push deployment must contain all of the files needed to run your function.
-
 >[!IMPORTANT]
 > When you use .zip deployment, any files from an existing deployment that aren't found in the .zip file are deleted from your function app.  
 
-[!INCLUDE [functions-folder-structure](../../includes/functions-folder-structure.md)]
+## Deployment .zip file requirements
 
-A function app includes all of the files and folders in the `wwwroot` directory. A .zip file deployment includes the contents of the `wwwroot` directory, but not the directory itself. When deploying a C# class library project, you must include the compiled library files and dependencies in a `bin` subfolder in your .zip package.
+[!INCLUDE [functions-deployment-zip-structure](../../includes/functions-deployment-zip-structure.md)]
 
-When you are developing on a local computer, you can manually create a .zip file of the function app project folder using built-in .zip compression functionality or third-party tools.
+A zip deployment process extracts the zip archive's files and folders in the `wwwroot` directory. If you include the parent directory when creating the archive, the system will not find the files it expects to see in `wwwroot`.
 
 ## <a name="cli"></a>Deploy by using Azure CLI
 

articles/azure-functions/dotnet-isolated-process-guide.md

@@ -711,7 +711,7 @@ You can create your function app and other required resources in Azure using one
 + [Deployment templates](./functions-infrastructure-as-code.md): You can use ARM templates and Bicep files to automate the deployment of the required resources to Azure. Make sure your template includes any [required settings](#deployment-requirements).
 + [Azure portal](./functions-create-function-app-portal.md): You can create the required resources in the [Azure portal](https://portal.azure.com).
 
-### Publish code project
+### Publish your application
 
 After creating your function app and other required resources in Azure, you can deploy the code project to Azure using one of these methods:
 
@@ -723,6 +723,24 @@ After creating your function app and other required resources in Azure, you can
 
 For more information, see [Deployment technologies in Azure Functions](functions-deployment-technologies.md).
 
+#### Deployment payload
+
+Many of the deployment methods make use of a zip archive. If you are creating the zip archive yourself, it must follow the structure outlined in this section. If it does not, your app may experience errors at startup.
+
+The deployment payload should match the output of a `dotnet publish` command, though without the enclosing parent folder. The zip archive should be made from the following files:
+
+- `.azurefunctions/`
+- `extensions.json`
+- `functions.metadata`
+- `host.json`
+- `worker.config.json`
+- Your project executable (a console app)
+- Other supporting files and directories peer to that executable
+
+These files are generated by the build process, and they are not meant to be edited directly.
+
+When preparing a zip archive for deployment, you should only compress the contents of the output directory, not the enclosing directory itself. When the archive is extracted into the current working directory, the files listed above need to be immediately visible.
+
 ### Deployment requirements
 
 There are a few requirements for running .NET functions in the isolated worker model in Azure, depending on the operating system:

articles/azure-functions/run-functions-from-deployment-package.md

@@ -60,6 +60,10 @@ The following table indicates the recommended `WEBSITE_RUN_FROM_PACKAGE` values
 
 [!INCLUDE [Function app settings](../../includes/functions-app-settings.md)]
 
+### Creating the zip archive
+
+[!INCLUDE [functions-deployment-zip-structure](../../includes/functions-deployment-zip-structure.md)]
+
 ## Use WEBSITE_RUN_FROM_PACKAGE = 1
 
 This section provides information about how to run your function app from a local package file.

includes/functions-deployment-zip-structure.md

@@ -0,0 +1,22 @@
+---
+author: ggailey777
+ms.service: azure-functions
+ms.topic: include
+ms.date: 07/16/2024
+ms.author: glenga
+---
+
+The zip archive you deploy must contain all of the files needed to run your function app. You can manually create a zip archive from the contents of a Functions project folder using built-in .zip compression functionality or third-party tools.
+
+The archive must include the [host.json](../articles/azure-functions/functions-host-json.md) file at the root of the extracted folder. The selected language stack for the function app creates additional requirements:
+
+* [.NET (isolated worker model)](../articles/azure-functions/dotnet-isolated-process-guide.md#deployment-payload)
+* [.NET (in-process model)](../articles/azure-functions/functions-dotnet-class-library.md#functions-class-library-project)
+* [Java](../articles/azure-functions/functions-reference-java.md#folder-structure)
+* [JavaScript](../articles/azure-functions/functions-reference-node.md?tabs=javascript#folder-structure)
+* [TypeScript](../articles/azure-functions/functions-reference-node.md?tabs=typescript#folder-structure)
+* [PowerShell](../articles/azure-functions/functions-reference-powershell.md#folder-structure)
+* [Python](../articles/azure-functions/functions-reference-python.md#folder-structure)
+
+> [!IMPORTANT]
+> Make sure to compress the contents of any output folder, rather than the parent folder itself. When Azure Functions extracts the contents of the zip archive, it needs to immediately see the `host.json` file.