Skip to content

Commit 87f236a

Browse files
committed
Initial push for label doc updates.
1 parent 43eb501 commit 87f236a

File tree

1 file changed

+40
-4
lines changed

1 file changed

+40
-4
lines changed

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

Lines changed: 40 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,34 @@ author: PatrickFarley
66
manager: nitinme
77
ms.service: cognitive-services
88
ms.subservice: forms-recognizer
9-
ms.topic: conceptual
10-
ms.date: 02/28/2020
9+
ms.topic: how-to
10+
ms.date: 03/20/2020
1111
ms.author: pafarley
1212
---
1313

1414
# Deploy the sample labeling tool
1515

16-
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.
16+
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:
1717

18-
This guide will explain alternate ways you can deploy and run the sample labeling tool.
18+
* Run sample labeling tool locally
19+
* Deploy the sample labeling tool to an Azure Container Instance (ACI)
20+
* Use the open sourced OCR Form Labeling Tool
21+
22+
## Run the sample labeling tool locally
23+
24+
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.
25+
26+
* [Quickstart: Label forms, train a model, and analyze a form using the sample labeling tool](./quickstarts/label-tool.md).
1927

2028
## Deploy with Azure Container Instances
2129

30+
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 (AC):
31+
32+
* Using the Azure portal
33+
* Using the Azure CLI
34+
35+
### Azure portal
36+
2237
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:
2338
* **Publish**: Docker Container
2439
* **Operating** System: Linux
@@ -32,10 +47,31 @@ On the next page, fill in the following fields for the Docker container setup:
3247

3348
The steps that follow are optional. Once your app has finished deploying, you can run it and access the label tool online.
3449

50+
### Azure CLI
51+
52+
```cli
53+
DNS_NAME_LABEL=aci-demo-$RANDOM
54+
55+
az container create \
56+
--resource-group <resorunce_group_name> \
57+
--name <name> \
58+
--image mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool \
59+
--ports 3000 \
60+
--dns-name-label $DNS_NAME_LABEL \
61+
--location <region name> \
62+
--cpu 2 \
63+
--memory 8
64+
--command-line "./run.sh eula=accept”
65+
```
66+
3567
### Connect to Azure AD for authorization
3668

3769
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.
3870

71+
## Open source on GitHub
72+
73+
74+
3975
## Next steps
4076

4177
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.

0 commit comments

Comments
 (0)