Merge pull request #193646 from charris-msft/main

laurabren · web-flow · commit e02bc56de423 · 2022-04-01T12:07:03.000-07:00
Update quickstart-python to use az webapp up for the CLI
diff --git a/articles/app-service/includes/quickstart-python/create-app-cli.md b/articles/app-service/includes/quickstart-python/create-app-cli.md
@@ -1,104 +1,9 @@
 ---
-author: DavidCBerry13
-ms.author: daberry
+author: charris-msft
+ms.author: charris
 ms.topic: include
-ms.date: 01/29/2022
+ms.date: 04/01/2022
 ---
-Azure CLI commands can be run in the [Azure Cloud Shell](https://shell.azure.com) or on a workstation with the [Azure CLI installed](/cli/azure/install-azure-cli).
-
-First, create a resource group to act as a container for all of the Azure resources related to this application.
-
-#### [bash](#tab/terminal-bash)
-
-```azurecli
-# Use 'az account list-locations --output table' to list locations
-LOCATION='eastus'
-RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
-
-az group create \
-    --location $LOCATION \
-    --name $RESOURCE_GROUP_NAME
-```
-
-#### [PowerShell terminal](#tab/terminal-powershell)
-
-```azurecli
-# Use 'az account list-locations --output table' to list locations
-$LOCATION='eastus'
-$RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
-
-# Create a resource group
-az group create `
-    --location $LOCATION `
-    --name $RESOURCE_GROUP_NAME
-```
-
----
-
-Next, create an App Service plan using the [az appservice plan create](/cli/azure/appservice/plan#az-appservice-plan-create) command.
-
-* The `--sku` parameter defines the size (CPU, memory) and cost of the app service plan.  This example uses the B1 (Basic) service plan, which will incur a small cost in your Azure subscription. For a full list of App Service plans, view the [App Service pricing](https://azure.microsoft.com/pricing/details/app-service/linux/) page.
-* The `--is-linux` flag selects the Linux as the host operating system.
-
-#### [bash](#tab/terminal-bash)
-
-```azurecli
-APP_SERVICE_PLAN_NAME='msdocs-python-webapp-quickstart'    
-
-az appservice plan create \
-    --name $APP_SERVICE_PLAN_NAME \
-    --resource-group $RESOURCE_GROUP_NAME \
-    --sku B1 \
-    --is-linux
-```
-
-#### [PowerShell terminal](#tab/terminal-powershell)
-
-```azurecli
-$APP_SERVICE_PLAN_NAME='msdocs-python-webapp-quickstart'    
-
-az appservice plan create `
-    --name $APP_SERVICE_PLAN_NAME `
-    --resource-group $RESOURCE_GROUP_NAME `
-    --sku B1 `
-    --is-linux
-```
-
----
-
-Finally, create the App Service web app using the [az webapp create](/cli/azure/webapp#az-webapp-create) command.  
-
-* The *app service name* is used as both the name of the resource in Azure and to form the fully qualified domain name for your app in the form of `https://<app service name>.azurewebsites.com`.
-* The runtime specifies what version of Python your app is running. This example uses Python 3.9. To list all available runtimes, use the command `az webapp list-runtimes --os linux --output table`.
-
-#### [bash](#tab/terminal-bash)
-
-```azurecli
-# Change 123 to any three characters to form a unique name across Azure
-APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'
-
-az webapp create \
-    --name $APP_SERVICE_NAME \
-    --runtime 'PYTHON|3.9' \
-    --plan $APP_SERVICE_PLAN_NAME \
-    --resource-group $RESOURCE_GROUP_NAME \
-    --query 'defaultHostName' \
-    --output table
-```
-
-#### [PowerShell terminal](#tab/terminal-powershell)
-
-```azurecli
-# Change 123 to any three characters to form a unique name across Azure
-$APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'
-
-az webapp create `
-    --name $APP_SERVICE_NAME `
-    --runtime 'PYTHON:3.9' `
-    --plan $APP_SERVICE_PLAN_NAME `
-    --resource-group $RESOURCE_GROUP_NAME `
-    --query 'defaultHostName' `
-    --output table
-```
+Azure CLI has a command `az webapp up` that will create the necessary resources and deploy your application in a single step. You don't need to create the resources separately so you can move on to [**Step 3 - Deploy your application code to Azure**](#3---deploy-your-application-code-to-azure) and select the _Deploy using Azure CLI_ tab.
 
 ---
diff --git a/articles/app-service/includes/quickstart-python/deploy-cli.md b/articles/app-service/includes/quickstart-python/deploy-cli.md
@@ -0,0 +1,69 @@
+---
+author: charris-msft
+ms.author: charris
+ms.topic: include
+ms.date: 04/01/2022
+---
+Azure CLI commands can be run in the [Azure Cloud Shell](https://shell.azure.com) or on a workstation with the [Azure CLI installed](/cli/azure/install-azure-cli).
+
+Azure CLI has a command `az webapp up` that will create the necessary resources and deploy your application in a single step.
+
+#### [bash](#tab/terminal-bash)
+
+Create the webapp and other resources, then deploy your code to Azure using [az webapp up](/cli/azure/webapp#az-webapp-up).
+
+```azurecli
+az webapp up \
+    --runtime 'PYTHON:3.9' \
+    --sku B1 \
+    --logs
+```
+
+#### [PowerShell terminal](#tab/terminal-powershell)
+
+Create the webapp and other resources, then deploy your code to Azure using [az webapp up](/cli/azure/webapp#az-webapp-up).
+
+```azurecli
+az webapp up `
+    --runtime 'PYTHON:3.9' `
+    --sku B1 `
+    --logs
+```
+
+---
+
+* The `--runtime` parameter specifies what version of Python your app is running. This example uses Python 3.9. To list all available runtimes, use the command `az webapp list-runtimes --os linux --output table`.
+* The `--sku` parameter defines the size (CPU, memory) and cost of the app service plan. This example uses the B1 (Basic) service plan, which will incur a small cost in your Azure subscription. For a full list of App Service plans, view the [App Service pricing](https://azure.microsoft.com/pricing/details/app-service/linux/) page.
+* The `--logs` flag configures default logging required to enable viewing the log stream immediately after launching the webapp.
+* You can optionally specify a name with the argument `--name <app-name>`. If you don't provide one, then a name will be automatically generated.
+* You can optionally include the argument `--location <location-name>` where `<location_name>` is an available Azure region. You can retrieve a list of allowable regions for your Azure account by running the [`az account list-locations`](/cli/azure/appservice#az-appservice-list-locations) command.
+
+The command may take a few minutes to complete. While the command is running, it provides messages about creating the resource group, the App Service plan, and the app resource, configuring logging, and doing ZIP deployment. It then gives the message, "You can launch the app at http://&lt;app-name&gt;.azurewebsites.net", which is the app's URL on Azure.
+
+<pre>
+The webapp '&lt;app-name>' doesn't exist
+Creating Resource group '&lt;group-name>' ...
+Resource group creation complete
+Creating AppServicePlan '&lt;app-service-plan-name>' ...
+Creating webapp '&lt;app-name>' ...
+Configuring default logging for the app, if not already enabled
+Creating zip with contents of dir /home/cephas/myExpressApp ...
+Getting scm site credentials for zip deployment
+Starting zip deployment. This operation can take a while to complete ...
+Deployment endpoint responded with status code 202
+You can launch the app at http://&lt;app-name>.azurewebsites.net
+{
+  "URL": "http://&lt;app-name>.azurewebsites.net",
+  "appserviceplan": "&lt;app-service-plan-name>",
+  "location": "centralus",
+  "name": "&lt;app-name>",
+  "os": "&lt;os-type>",
+  "resourcegroup": "&lt;group-name>",
+  "runtime_version": "python|3.9",
+  "runtime_version_detected": "0.0",
+  "sku": "FREE",
+  "src_path": "&lt;your-folder-location>"
+}
+</pre>
+
+[!INCLUDE [az webapp up command note](../../../../includes/app-service-web-az-webapp-up-note.md)]
diff --git a/articles/app-service/quickstart-python.md b/articles/app-service/quickstart-python.md
@@ -39,7 +39,7 @@ To run the application locally:
 
 ### [Flask](#tab/flask)
 
-1.  Go to the application folder:
+1. Go to the application folder:
 
     ```Console
     cd msdocs-python-flask-webapp-quickstart
@@ -157,6 +157,10 @@ To deploy a web app from VS Code, you must have the [Azure Tools extension pack]
 | [!INCLUDE [VS Code deploy step 4](<./includes/quickstart-python/deploy-visual-studio-code-4.md>)] | :::image type="content" source="./media/quickstart-python/deploy-visual-studio-code-4-240px.png" alt-text="A screenshot of a dialog box in VS Code asking if you want to update your workspace to run build commands." lightbox="./media/quickstart-python/deploy-visual-studio-code-4.png"::: |
 | [!INCLUDE [VS Code deploy step 5](<./includes/quickstart-python/deploy-visual-studio-code-5.md>)] | :::image type="content" source="./media/quickstart-python/deploy-visual-studio-code-5-240px.png" alt-text="A screenshot showing the confirmation dialog when the app code has been deployed to Azure." lightbox="./media/quickstart-python/deploy-visual-studio-code-5.png"::: |
 
+### [Deploy using Azure CLI](#tab/azure-cli-deploy)
+
+[!INCLUDE [Deploy Azure CLI](<./includes/quickstart-python/deploy-cli.md>)]
+
 ### [Deploy using Local Git](#tab/local-git-deploy)
 
 [!INCLUDE [Deploy Local Git](<./includes/quickstart-python/deploy-local-git.md>)]
