Merge pull request #108470 from erhopf/formre-deploy-label-update-318

[CogSvcs] Improve Deploy Labeling Tool Docs

Author: Jak-MS

articles/cognitive-services/form-recognizer/deploy-label-tool.md

@@ -6,36 +6,117 @@ author: PatrickFarley
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: forms-recognizer
-ms.topic: conceptual
-ms.date: 02/28/2020
+ms.topic: how-to
+ms.date: 03/20/2020
 ms.author: pafarley
 ---
 
 # Deploy the sample labeling tool
 
-The Form Recognizer sample labeling tool is an application that runs in a Docker container. It provides a helpful UI that you can use to manually label form documents for the purpose of supervised learning. The [Train with labels](./quickstarts/label-tool.md) quickstart shows you how to run the tool on your local computer, which is the most common scenario. 
+The Form Recognizer sample labeling tool is an application that provides a simple user interface (UI), which you can use to manually label forms (documents) for the purpose of supervised learning. In this article, we'll provide links and instructions that teach you how to:
 
-This guide will explain alternate ways you can deploy and run the sample labeling tool. 
+* [Run the sample labeling tool locally](#run-the-sample-labeling-tool-locally)
+* [Deploy the sample labeling tool to an Azure Container Instance (ACI)](#deploy-with-azure-container-instances-aci)
+* [Use and contribute to the open-source OCR Form Labeling Tool](#open-source-on-github)
 
-## Deploy with Azure Container Instances
+## Run the sample labeling tool locally
 
-You can run the label tool in a Docker web app container. First, [create a new Web App resource](https://ms.portal.azure.com/#create/Microsoft.WebSite) on the Azure portal. Fill in the form with your subscription and resource group details. Enter the following information in the required fields:
-* **Publish**: Docker Container
-* **Operating** System: Linux
+The fastest way to start labeling data is to run the sample labeling tool locally. The following quickstart uses the Form Recognizer REST API and the sample labeling tool to train a custom model with manually labeled data. 
 
-On the next page, fill in the following fields for the Docker container setup:
+* [Quickstart: Label forms, train a model, and analyze a form using the sample labeling tool](./quickstarts/label-tool.md).
 
-* **Options**: Single Container
-* **Image Source**: Azure Container Registry
-* **Access Type**: public
-* **Image and tag**: mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest
+## Deploy with Azure Container Instances (ACI)
 
-The steps that follow are optional. Once your app has finished deploying, you can run it and access the label tool online.
+Before we get started, it's important to note that there are two ways to deploy the sample labeling tool to an Azure Container Instance (ACI). Both options are used to run the sample labeling tool with ACI: 
+
+* [Using the Azure portal](#azure-portal)
+* [Using the Azure CLI](#azure-cli)
+
+### Azure portal
+
+Follow these steps to create a new resource using the Azure portal: 
+
+1. Sign in to the [Azure portal](https://portal.azure.com/signin/index/).
+2. Select **Create a resource**. 
+3. Next, select **Web App**. 
+
+   > [!div class="mx-imgBorder"]
+   > ![Select web app](./media/quickstarts/formre-create-web-app.png)
+   
+4. First, make sure that the **Basics** tab is selected. Now, you're going to need to provide some information: 
+
+   > [!div class="mx-imgBorder"]
+   > ![Select Basics](./media/quickstarts/formre-select-basics.png)
+   * Subscription - Select an existing Azure subscription
+   * Resource Group - You can reuse an existing resource group or create a new one for this project. Creating a new resource group is recommended.
+   * Name - Give your web app a name. 
+   * Publish - Select **Docker Container**
+   * Operating System -  Select **Linux**
+   * Region - Choose a region that makes sense for you.
+   * Linux Plan - Select a pricing tier/plan for your app service. 
+
+   > [!div class="mx-imgBorder"]
+   > ![Configure your web app](./media/quickstarts/formre-select-docker-linux.png)
+
+5. Next, select the **Docker** tab. 
+
+   > [!div class="mx-imgBorder"]
+   > ![Select Docker](./media/quickstarts/formre-select-docker.png)
+
+6. Now let's configure your Docker container. All fields are required unless otherwise noted:
+
+   * Options - Select **Single Container**
+   * Image Source - Select **Private Registry** 
+   * Server URL - Set this to `https://mcr.microsoft.com`
+   * Username (Optional) - Create a username. 
+   * Password (Optional) - Create a secure password that you'll remember.
+   * Image and tag - Set this to `mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest`
+   * Startup command - Set this to `./run.sh eula=accept`
+
+   > [!div class="mx-imgBorder"]
+   > ![Configure Docker](./media/quickstarts/formre-configure-docker.png)
+
+7. That's it. Next, select **Review + Create**, then **Create** to deploy your web app. When complete, you can access your web app at the URL provided in the **Overview** for your resource.
+
+> [!NOTE]
+> When creating your web app, you can also configure authorization/authentication. This is not necessary to get started. 
+
+### Azure CLI
+
+As an alternative to using the Azure portal, you can create a resource using the Azure CLI. Before you continue, you'll need to install the [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest). You can skip this step if you're already working with the Azure CLI. 
+
+There's a few things you need know about this command:
+
+* `DNS_NAME_LABEL=aci-demo-$RANDOM` generates a random DNS name. 
+* This sample assumes that you have a resource group that you can use to create a resource. Replace `<resource_group_name>` with a valid resource group associated with your subscription. 
+* You'll need to specify where you want to create the resource. Replace `<region name>` with your desired region for the web app. 
+* This command automatically accepts EULA.
+
+From the Azure CLI, run this command to create a web app resource for the sample labeling tool: 
+
+```azurecli
+DNS_NAME_LABEL=aci-demo-$RANDOM
+
+az container create \
+  --resource-group <resorunce_group_name> \
+  --name <name> \
+  --image mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool \
+  --ports 3000 \
+  --dns-name-label $DNS_NAME_LABEL \
+  --location <region name> \
+  --cpu 2 \
+  --memory 8
+  --command-line "./run.sh eula=accept"
+```
 
 ### Connect to Azure AD for authorization
 
-We recommend to connect your web app to Azure Active Director (AAD) so that only someone with your credentials can sign in and use the app. Follow the instructions in [Configure your App Service app](https://docs.microsoft.com/azure/app-service/configure-authentication-provider-aad) to connect to AAD.
+It's recommended that you connect your web app to Azure Active Directory. This ensures that only users with valid credentials can sign in and use your web app. Follow the instructions in [Configure your App Service app](https://docs.microsoft.com/azure/app-service/configure-authentication-provider-aad) to connect to Azure Active Directory.
+
+## Open source on GitHub
+
+The OCR Form Labeling Tool is also available as an open-source project on GitHub. The tool is a web application built using React + Redux, and is written in TypeScript. To learn more or contribute, see [OCR Form Labeling Tool](https://github.com/microsoft/OCR-Form-Tools/blob/master/README.md).
 
 ## Next steps
 
-Return to the [Train with labels](./quickstarts/label-tool.md) quickstart to learn how to use the tool to manually label training data and do supervised learning.
+Use the [Train with labels](./quickstarts/label-tool.md) quickstart to learn how to use the tool to manually label training data and perform supervised learning.