Merge pull request #220466 from ggailey777/shreya

[Functions] MacOS AMD64 emulation content

Author: JamesJBarnett

articles/azure-functions/create-first-function-cli-python.md

@@ -45,6 +45,8 @@ Before you begin, you must have the following requirements in place:
 + The [Azurite storage emulator](../storage/common/storage-use-azurite.md?tabs=npm#install-azurite). While you can also use an actual Azure Storage account, the article assumes you're using this emulator.
 ::: zone-end  
 
+[!INCLUDE [functions-x86-emulation-on-arm64-note](../../includes/functions-x86-emulation-on-arm64-note.md)]
+
 ### Prerequisite check
 
 Verify your prerequisites, which depend on whether you're using Azure CLI or Azure PowerShell for creating Azure resources.

articles/azure-functions/create-first-function-vs-code-python.md

@@ -48,6 +48,8 @@ Before you begin, make sure that you have the following requirements in place:
 + The [Azurite V3 extension](https://marketplace.visualstudio.com/items?itemName=Azurite.azurite) local storage emulator. While you can also use an actual Azure storage account, this article assumes you're using the Azurite emulator.
 ::: zone-end
 
+[!INCLUDE [functions-x86-emulation-on-arm64-note](../../includes/functions-x86-emulation-on-arm64-note.md)]
+
 ## <a name="create-an-azure-functions-project"></a>Create your local project
 
 In this section, you use Visual Studio Code to create a local Azure Functions project in Python. Later in this article, you'll publish your function code to Azure.

articles/azure-functions/functions-develop-vs-code.md

@@ -91,6 +91,8 @@ These prerequisites are only required to [run and debug your functions locally](
 
 * [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) for Visual Studio Code.
 
+[!INCLUDE [functions-x86-emulation-on-arm64-note](../../includes/functions-x86-emulation-on-arm64-note.md)]
+
 ---
 
 ## Create an Azure Functions project
@@ -491,6 +493,27 @@ We recommend that you monitor the execution of your functions by integrating you
 
 To learn more about monitoring using Application Insights, see [Monitor Azure Functions](functions-monitoring.md).
 
+[!INCLUDE [functions-x86-emulation-on-arm64](../../includes/functions-x86-emulation-on-arm64.md)]
+
+### Enable emulation in Visual Studio Code
+
+Now that you've configured the Terminal with Rosetta to run x86 emulation for Python development, you can use the following steps to integrate this terminal emulation with Visual Studio Code:
+
+1.  Open the Command Palette by pressing Cmd+Shift+P, select **Preferences: Open Settings (JSON)**, and add the following JSON to your configuration:
+
+    ```json
+    "terminal.integrated.profiles.osx": {
+           "rosetta": {
+             "path": "arch",
+             "args": ["-x86_64", "zsh", "-l"],
+             "overrideName": true
+           }
+         }
+    ```
+1. Open a new Terminal and choose **rosetta**.
+
+    ![Screenshot of starting a new Rosetta terminal in Visual Studio Code.](./media/functions-develop-vs-code/vs-code-rosetta.png)
+
 ## C\# script projects
 
 By default, all C# projects are created as [C# compiled class library projects](functions-dotnet-class-library.md). If you prefer to work with C# script projects instead, you must select C# script as the default language in the Azure Functions extension settings:

articles/azure-functions/functions-reference-python.md

@@ -34,8 +34,27 @@ As a Python developer, you might also be interested in one of the following arti
 
 ::: zone-end
 
-> [!NOTE]
-> Although you can develop your Python-based Azure functions locally on Windows, Python is supported only on a Linux-based hosting plan when it's running in Azure. For more information, see the [list of supported operating system/runtime combinations](functions-scale.md#operating-systemruntime).
+## Development options
+
+Both Python Functions programming models support local development in one of the following environments:
+
+Python v2 programming model:
+
++ [Visual Studio Code](./create-first-function-vs-code-python.md?pivots=python-mode-decorators)
++ [Terminal or command prompt](./create-first-function-cli-python.md?pivots=python-mode-decorators)
+
+Python v1 programming model:
+
++ [Visual Studio Code](./create-first-function-vs-code-python.md?pivots=python-mode-configuration)
++ [Terminal or command prompt](./create-first-function-cli-python.md?pivots=python-mode-configuration)
+
+You can also create Python v1 functions in the Azure portal.
+
+The following considerations apply for local Python development:
+
++ Although you can develop your Python-based Azure functions locally on Windows, Python is supported only on a Linux-based hosting plan when it's running in Azure. For more information, see the [list of supported operating system/runtime combinations](functions-scale.md#operating-systemruntime).
+
++ Functions doesn't currently support local Python function development on ARM64 devices, including on a Mac with an M1 chip. To learn more, see [x86 emulation on ARM64](functions-run-local.md#x86-emulation-on-arm64).
 
 ## Programming model
 

articles/azure-functions/functions-run-local.md

@@ -100,6 +100,8 @@ If you need to install version 1.x of the Core Tools, see the [GitHub repository
 
 # [macOS](#tab/macos/v4)
 
+[!INCLUDE [functions-x86-emulation-on-arm64-note](../../includes/functions-x86-emulation-on-arm64-note.md)]
+
 The following steps use Homebrew to install the Core Tools on macOS.
 
 1. Install [Homebrew](https://brew.sh/), if it's not already installed.
@@ -115,6 +117,8 @@ The following steps use Homebrew to install the Core Tools on macOS.
 
 # [macOS](#tab/macos/v3)
 
+[!INCLUDE [functions-x86-emulation-on-arm64-note](../../includes/functions-x86-emulation-on-arm64-note.md)]
+
 The following steps use Homebrew to install the Core Tools on macOS.
 
 1. Install [Homebrew](https://brew.sh/), if it's not already installed.
@@ -130,6 +134,8 @@ The following steps use Homebrew to install the Core Tools on macOS.
 
 # [macOS](#tab/macos/v2)
 
+[!INCLUDE [functions-x86-emulation-on-arm64-note](../../includes/functions-x86-emulation-on-arm64-note.md)]
+
 The following steps use Homebrew to install the Core Tools on macOS.
 
 1. Install [Homebrew](https://brew.sh/), if it's not already installed.
@@ -602,8 +608,11 @@ You can view a stream of log files being generated by your functions in a comman
 
 [!INCLUDE [functions-streaming-logs-core-tools](../../includes/functions-streaming-logs-core-tools.md)]
 
-This type of streaming logs requires that Application Insights integration be enabled for your function app.   
+This type of streaming logs requires that Application Insights integration be enabled for your function app.  
+
+[!INCLUDE [functions-x86-emulation-on-arm64](../../includes/functions-x86-emulation-on-arm64.md)]
 
+If you are using Visual Studio Code, you can integrate Rosetta with the built-in Terminal. For more information, see [Enable emulation in Visual Studio Code](./functions-develop-vs-code.md#enable-emulation-in-visual-studio-code). 
 
 ## Next steps
 

articles/azure-functions/media/functions-develop-vs-code/open-settings.png

@@ -0,0 +1,10 @@
+---
+author: ggailey777
+ms.service: azure-functions
+ms.topic: include
+ms.date: 12/05/2022
+ms.author: glenga
+---
+
+> [!IMPORTANT]
+> Functions doesn't currently support Python function development on ARM64 devices. To develop Python functions on a Mac with an M1 chip, you must run in an emulated x86 environment. To learn more, see [x86 emulation on ARM64](../articles/azure-functions/functions-run-local.md#x86-emulation-on-arm64). 

articles/azure-functions/media/functions-develop-vs-code/vs-code-rosetta.png

@@ -0,0 +1,77 @@
+---
+author: ggailey777
+ms.service: azure-functions
+ms.topic: include
+ms.date: 12/05/2022
+ms.author: glenga
+---
+
+## x86 emulation on ARM64
+
+Functions doesn't currently support local Python function development on ARM64 devices. Use the following steps to develop Python functions on a Mac with an M1 chip by running in an emulated x86 environment. 
+
+### Enable Rosetta in Terminal
+
+1. In your Mac, open Finder, choose **Applications**, and locate **Terminal**.
+
+1. Control-click **Terminal** and select **Get Info**. You can also create a separate parallel environment by duplicating the Terminal and renaming it.
+
+    ![Screenshot of selecting Get Info by control-clicking Terminal](./media/functions-x86-emulation-on-arm64/arm64-python-1.png)
+
+1. Select **Open using Rosetta**.
+
+    ![Screenshot of the Terminal configured to open using Rosetta](./media/functions-x86-emulation-on-arm64/arm64-python-2.png)
+
+1. Open Terminal, which now has Rosetta enabled, and make sure your shell is zsh.
+
+1. Run the following command to validate the x86 emulation.
+
+    ```cmd
+    $ arch
+    ```
+
+    A response of `i386` indicates your terminal is running an x86 emulated environment.
+
+### Install required packages 
+ 
+Reinstall all dependencies required by Functions in this environment, which includes the following packages: 
+
+* [homebrew](https://brew.sh/), installed to the path `/usr/local/bin/brew`.
+* Python 
+* [Azure Functions Core Tools](/functions-run-local.md#install-the-azure-functions-core-tools)
+
+Also, reinstall any other packages required by your Python project.
+
+### Set aliases (optional)
+
+You can optionally set aliases to make it easy to reference the right versions in Rosetta. 
+
+The following is an example of how to create a .zshrc file to configure your zsh terminal:
+
+```c
+# file: .zshrc
+# rosetta terminal setup
+if [ $(arch) = "i386" ]; then
+    alias python="/usr/local/bin/python3"
+    alias brew86='/usr/local/bin/brew'
+    alias pyenv86="arch -x86_64 pyenv"
+    alias func="/usr/local/Cellar/azure-functions-core-tools@4/4.0.4785/func"
+fi
+```
+
+Run the following command to apply the aliases:
+
+```cmd
+$ source .zshrc
+```
+
+Validate you're referencing the correct versions by using the `which` command, as shown in the following examples:
+
+| Command | Example response |
+| --- | --- |
+| `$ which python` | `python: aliased to /usr/local/bin/python3` |
+| `$ which func` | `func: aliased to /usr/local/Cellar/azure-functions-core-tools@4/4.0.4785/func` |
+
+These example responses are based on the previous example .zshrc file.
+
+Now, you're set up to use Azure Functions in the x86 environment from the Terminal.