review-1

Author: v-thpra

learn-pr/azure/run-parallel-tasks-in-azure-batch-with-the-azure-cli/includes/1-introduction.md

@@ -2,9 +2,9 @@ You can use Azure Batch to execute large-scale, high-intensity computation jobs
 
 Imagine you're a software developer at a nonprofit organization whose mission is to give every human on the planet access to clean water. To reach this goal, every citizen is asked to take a picture of their water purification meter and text it to you. Each day, you have to scan pictures from more than 500,000 households and record each reading against the sender's phone number. The data is used to detect water-quality trends and to dispatch the mobile water-quality team to investigate the worst cases across each region. Time is of the essence, but processing each image with Optical Character Recognition (OCR) is time-intensive. With Azure Batch, you can scale out the amount of compute needed to handle this task on a daily basis, saving your nonprofit the expense of fixed resources.
 
-In this module, you'll learn about using Azure Batch to create and run parallel tasks with the Azure CLI, and how to use the CLI to check the status of Batch jobs and tasks. This module also describes how to use the standalone Batch Explorer tool to monitor ongoing jobs.
+In this module, you learn about using Azure Batch to create and run parallel tasks with the Azure CLI, and how to use the CLI to check the status of Batch jobs and tasks. This module also describes how to use the standalone Batch Explorer tool to monitor ongoing jobs.
 
-By the end of this module, you'll be able to create, execute, and monitor batch jobs.
+By the end of this module, you're able to create, execute, and monitor batch jobs.
 
 ## Learning objectives
 
@@ -20,4 +20,4 @@ In this module, you will:
 - Familiarity with Azure and the Azure CLI
 
 >[!IMPORTANT]
->The exercises in this module are optional. To complete the exercises, you'll need your own Azure subscription.
+>The exercises in this module are optional. To complete the exercises, you need your own Azure subscription.

learn-pr/azure/run-parallel-tasks-in-azure-batch-with-the-azure-cli/includes/2-what-is-azure-batch.md

@@ -1,22 +1,23 @@
 Few organizations have the resources to support permanent deployments of super-powerful compute platforms that might only occasionally be used to capacity. More typically, you need a flexible and scalable compute solution such as Azure Batch to provide the computational power.
 
-As part of the process of performing OCR on the uploaded pictures of water-purification meters using Azure Batch, you need to have an understanding of the main components of an Azure Batch workflow.
+As part of the process of performing Optical Character Recognition (OCR) on the uploaded pictures of water-purification meters using Azure Batch, you need to have an understanding of the main components of an Azure Batch workflow.
 
-Here, you'll look at what Azure Batch is designed to do, and how Batch components are used in a typical workflow.
+Here, you look at what Azure Batch is designed to do, and how Batch components are used in a typical workflow.
 
 ## Compute-intensive tasks and parallel workloads
 
-Some workloads require massive computational power. Examples include financial risk modeling, 3D image rendering, media transcoding, and genetic sequence analysis. In some cases, these workloads can be broken down into separate subtasks and can be run in parallel so that the tasks are performed in much less time. Three Virtual Machines (VMs) can do the work of one in a third of the time.
+Some workloads require massive computational power. Examples include financial risk modeling, 3D image rendering, media transcoding, and genetic sequence analysis. In some cases, these workloads can be broken down into separate subtasks and can be run in parallel so that the tasks are performed in much less time. Three virtual machines (VMs) can do the work of one in a third of the time.
+
+As part of the OCR project for the nonprofit, you can use Azure Batch to partition the work of performing the OCR, allowing the processing to be done in parallel so that it takes much less time to complete.
 
-As part of the OCR project for the nonprofit, you can use Azure Batch to partition up the work of performing the OCR so that the processing is done in parallel and takes much less time to complete.
 
 ## The components of Azure Batch
 
 You can use Azure Batch for these large-scale parallel and computationally intensive tasks on Azure. At a high level, Azure Batch involves many components working together. Everything needs to take place within the context of an Azure Batch account, which acts as a container for all Batch resources.
 
-For some use cases, you might wish to associate this account with an Azure Storage account to download input files and applications for use during execution and storing their results. Within your Azure Batch account, you can create pools of virtual compute nodes, running either Windows or Linux, of the number and CPU and memory size that you specify, which the Azure batch service manages and schedules for you. A Batch account can contain many Batch pools.
+For some use cases, you might wish to associate this account with an Azure Storage account to download input files and applications for use during execution and storing their results. Within your Azure Batch account, you can create pools of virtual compute nodes, running either Windows or Linux. You specify the number, CPU type, and memory size of the nodes, which the Azure batch service manages and schedules for you. A Batch account can contain many Batch pools.
 
-Once you've created one or more pools, you create individual jobs, which act like logical containers for all the tasks you schedule and can share common properties. Again, it's perfectly possible to have many jobs.
+Once you create one or more pools, you create individual jobs, which act like logical containers for all the tasks you schedule and can share common properties. Again, it's perfectly possible to have many jobs.
 
 And finally, you create tasks, which describe how the work actually gets done. You can either use tasks to directly invoke the command line, or the tasks can run applications that you upload to Azure Storage. We'll see all the main components of Azure Batch working together in the next exercise.
 

learn-pr/azure/run-parallel-tasks-in-azure-batch-with-the-azure-cli/includes/3-design-an-azure-batch-job-to-run-parallel-task.md

@@ -1,20 +1,20 @@
 Azure Batch uses parallel tasks to split a job across compute nodes.
 
-As the solution architect for the nonprofit, you want to understand how to design an Azure Batch job and how to enable parallel processing so that these capabilities can be used for the OCR scenario.
+As the solution architect for the nonprofit, you want to first understand how to design an Azure Batch job and how to enable parallel processing. Then, you can use these capabilities for the Optical Character Recognition (OCR) scenario.
 
-Here, you'll learn the key elements of a Batch parallel task.
+Here, you learn the key elements of a Batch parallel task.
 
 ## Using Azure Batch with Azure CLI
 
-You decide to create the solution to help the nonprofit with their mission using Azure Batch and the CLI, so you can get a quick framework in place and incrementally improve it without spending time scaffolding all the foundational code you'd otherwise need to get started. It's true that other methods of creating Azure Batch solutions like .NET and Node.js offer richer and more granular control of Batch and other Azure APIs, but none of those methods can match the agility and immediate feedback you get by issuing commands in the CLI and observing their results.
+You decide to create the solution to help the nonprofit with their mission, by using Azure Batch and the CLI. You want to get a quick framework in place and incrementally improve it without spending time scaffolding all the foundational code you'd otherwise need to get started. It's true that other methods of creating Azure Batch solutions like .NET and Node.js offer richer and more granular control of Batch and other Azure APIs. However, none of those methods can match the agility and immediate feedback you get by issuing commands in the CLI and observing their results.
 
 ## A sample parallel task
 
-To get to grips with Azure Batch and the CLI, you decide on a simple proof-of-concept to demonstrate the different nodes working together in parallel. You'll loop several times in the CLI, add a numbered task per iteration of the loop, and later download and look at the metadata each task generates. This metadata shows the Azure Batch service scheduling tasks as they're created onto different nodes in sequential fashion, so that they all execute their work in parallel.
+To get to grips with Azure Batch and the CLI, you decide on a simple proof-of-concept to demonstrate the different nodes working together in parallel. You plan to loop several times in the CLI, add a numbered task per iteration of the loop, and later download and look at the metadata each task generates. This metadata shows the Azure Batch service scheduling tasks as they're created onto different nodes in sequential fashion, so that they all execute their work in parallel.
 
-This kind of proof-of-concept actually underlies many real-world applications of Azure Batch. For example, in the OCR scenario, tasks would also install software like Imagemagick in order to convert the uploaded water-purification images to the TIF format, and would then install Tesseract to perform the conversion work. These tasks would be partitioned in such a way that each worker node would perform a portion of the OCR work in parallel with the others in order to complete faster.
+This kind of proof-of-concept actually underlies many real-world applications of Azure Batch. For example, in the OCR scenario, tasks would install software like Imagemagick to convert the uploaded water-purification images to the TIF format, and would then install Tesseract to perform the conversion work. These tasks would be partitioned so that each worker node would perform a portion of the OCR work in parallel with the others, allowing the work to complete faster.
 
-Even this proof of concept will demonstrate important components of Azure Batch working in concert together. You'll create a pool, you'll create worker nodes, you'll create a job, and you'll create tasks, all using the Azure CLI to issue commands and get immediate feedback.
+Even this proof of concept demonstrates important components of Azure Batch working in concert together. You create a pool, create worker nodes, create a job, and create tasks, all using the Azure CLI to issue commands and get immediate feedback.
 
 ![Diagram of the Azure Batch workflow.](../media/3-batch-overview.png)
 

learn-pr/azure/run-parallel-tasks-in-azure-batch-with-the-azure-cli/includes/4-exercise-create-azure-batch-job-in-cli-to-run-parallel-task.md

@@ -1,15 +1,15 @@
 Azure CLI lets you create and deploy Azure Batch resources from the command line.
 
-As the solution architect for the non-profit, you want to start creating a Batch solution for the OCR scenario on Azure. As a first step, you're going to test creating a Batch account, a pool of worker nodes, a job, and tasks, all using the Azure CLI.
+As the solution architect for the non-profit, you want to start creating a Batch solution for the Optical Character Recognition (OCR) scenario on Azure. As a first step, you're going to test creating a Batch account, a pool of worker nodes, a job, and tasks, all using the Azure CLI.
 
 The Azure CLI is a cross-platform command line for creating and managing Azure resources. It uses a consistent ```az noun verb --properties``` syntax. CLI commands to manage Azure Batch follow this convention, and so all commands take the form of ```az batch verb --properties```.
 
 >[!IMPORTANT]
->The exercises in this module are optional. To complete the exercises, you'll need your own Azure subscription.
+>The exercises in this module are optional. To complete the exercises, you need your own Azure subscription.
 
 ## Create the Azure Batch resources
 
-First, you'll create the Azure Batch account and pool of worker nodes for your test scenario. You'll then create a Batch job and tasks to run in the pool.
+First, you create the Azure Batch account and pool of worker nodes for your test scenario. Then, you create a Batch job and tasks to run in the pool.
 
 ### Create a new resource group
 
@@ -23,7 +23,7 @@ First, you'll create the Azure Batch account and pool of worker nodes for your t
 
 ### Create the Azure Batch account
 
-1. In portal, open the Cloud Shell by selecting the Cloud Shell icon (**>_**) in the top menu. Use the drop-down menu at the top of the terminal window to make sure you're in **Bash**.
+1. In the portal, open the Cloud Shell by selecting the Cloud Shell icon (**>_**) in the top menu. Use the drop-down menu at the top of the terminal window to make sure you're in **Bash**.
 
 1. Create environment variables for your resource group and batch resource.
 
@@ -32,7 +32,7 @@ First, you'll create the Azure Batch account and pool of worker nodes for your t
     BATCH_ACCOUNT=batchaccount$RANDOM
     ```
 
-1. Run the following command in the Cloud Shell to create an Azure Batch account. Choose from one of the following locations:
+1. Create an Azure Batch account by running the following command in the Cloud Shell. Choose from one of the following locations:
 
     ```text
     westeurope,eastus,eastus2,westus,northcentralus,brazilsouth,northeurope,centralus,eastasia,japaneast,australiasoutheast,japanwest,koreasouth,koreacentral,southeastasia,southcentralus,australiaeast,southindia,centralindia,westindia,canadacentral,canadaeast,uksouth,ukwest,westcentralus,westus2,francecentral,southafricanorth
@@ -73,7 +73,7 @@ First, you'll create the Azure Batch account and pool of worker nodes for your t
 
     When this query shows that the nodes are "steady," they're ready to work. While they show as "resizing," they're actually being provisioned. You can use the up arrow key to repeat the most recent command in the Cloud Shell if you want to query the status of the nodes more than once.
 
-1. Run the following command to create a *Batch job*, which is a logical grouping for all the tasks that will run on your nodes:
+1. Run the following command to create a *Batch job*, which is a logical grouping for all the tasks that run on your nodes:
 
     ```azurecli
     az batch job create \
@@ -95,9 +95,9 @@ First, you'll create the Azure Batch account and pool of worker nodes for your t
 
     This loop creates a series of numbered Batch tasks, each of which outputs information about the task ID and node ID involved. By examining what's happening here closely, you can see quite a few characteristics of the way Azure Batch works. Tasks get automatically scheduled onto nodes with available capacity. However, the environment variables we're using (`AZ_BATCH_TASK_ID` and `AZ_BATCH_NODE_ID`), to show information about which task is being run on which node, are only available in the context of the *task user*, a default account created on each node in order to run tasks. Also, the `--command-line` argument doesn't directly run under a shell, so you have to explicitly invoke the shell using `/bin/bash -c` in order to use commands like `printenv` and `grep`.
 
-    This loop completes the Azure Batch job implementation. We'll leave the Azure Batch account and pool of worker nodes in place for use in the next module, but we'll delete the Batch job. Because the Batch job acts as a container for its Batch tasks, the tasks are also deleted.
+    This loop completes the Azure Batch job implementation. Leave the Azure Batch account and pool of worker nodes in place for use in the next module, but delete the Batch job. Because the Batch job acts as a container for its Batch tasks, the tasks are also deleted.
 
-1. Run the following command in the Cloud Shell in order to delete the Batch job:
+1. Delete the Batch job by running the following command in the Cloud Shell:
 
     ```azurecli
     az batch job delete --job-id myjob -y

learn-pr/azure/run-parallel-tasks-in-azure-batch-with-the-azure-cli/includes/5-exercise-monitor-azure-batch-job-in-cli.md

@@ -1,33 +1,33 @@
-If you're using Azure Batch to run intensive tasks, you'll often want to know how the tasks are going.
+If you're using Azure Batch to run intensive tasks, you often want to know how the tasks are going.
 
-As the solution architect for the nonprofit, you'll need ways to access what's happening in Azure Batch. You also need to determine whether the nodes and tasks are working, how far they've progressed, and whether they've produced downloadable output files.
+As the solution architect for the nonprofit, you need ways to access what's happening in Azure Batch. You also need to determine whether the nodes and tasks are working, how far they progressed, and whether they produced downloadable output files.
 
-In this unit, you'll create a job similar to the one in the previous unit, monitor the progress of its tasks, and download the files that the tasks produce as output, all using the Azure CLI.
+In this unit, you create a job similar to the one in the previous unit, monitor the progress of its tasks, and download the files that the tasks produce as output, all using the Azure CLI.
 
 >[!IMPORTANT]
->The exercises in this module are optional. To complete the exercises, you'll need your own Azure subscription.
+>The exercises in this module are optional. To complete the exercises, you need your own Azure subscription.
 
 ## Monitor tasks using the CLI
 
 Azure Batch handles all the details of creating and managing compute nodes and scheduling jobs to run on those nodes.
 
 When you created tasks in the last unit, Azure Batch queued them to run in the pool. As nodes were determined to have available capacity, Azure Batch scheduled the tasks to run on those nodes.
 
-At the end of the last unit, we deleted the job, which had the effect of deleting all its tasks. We'll now create a new job and tasks. It's worth noting that deleting and recreating tasks is a fairly quick operation, and allows you to easily separate out different experiments and projects in Azure Batch. By contrast, deleting and recreating higher-level Batch entities (like accounts) takes more time, because the Batch pool has to be recreated and virtual machines allocated.
+At the end of the last unit, we deleted the job, which had the effect of deleting all its tasks. Now, we want to create a new job and tasks. It's worth noting that deleting and recreating tasks is a fairly quick operation, and allows you to easily separate out different experiments and projects in Azure Batch. By contrast, deleting and recreating higher-level Batch entities (like accounts) takes more time, because the Batch pool has to be recreated and virtual machines allocated.
 
 1. Sign into the [Azure portal](https://portal.azure.com/).
 
 1. Open the Cloud Shell by selecting the Cloud Shell icon (**>_**) in the top menu.
 
-1. Run the following command in the Cloud Shell in order to create a new Batch job:
+1. Create a new Batch job by running the following command in the Cloud Shell:
 
     ```azurecli
     az batch job create \
      --id myjob2 \
      --pool-id mypool
     ```
 
-    We named it differently to avoid any conflict with the job from the previous unit, which has been scheduled for deletion but not necessarily deleted yet.
+    We named it differently to avoid any conflict with the job from the previous unit, which was scheduled for deletion but not necessarily deleted yet.
 
 1. Run the following command to create Batch tasks within this new job:
 
@@ -53,7 +53,7 @@ At the end of the last unit, we deleted the job, which had the effect of deletin
 
 To check that the batch job executed correctly, you can download and examine the files it created.
 
-1. Run the following command in the Cloud Shell to show a table of all the files generated by one of the tasks you've created:
+1. Run the following command in the Cloud Shell to show a table of all the files generated by one of the tasks you created:
 
     ```azurecli
     az batch task file list \

learn-pr/azure/run-parallel-tasks-in-azure-batch-with-the-azure-cli/includes/6-introducing-batch-explorer.md

@@ -1,6 +1,6 @@
 Many administrators prefer GUI tools, and you can use the Azure Batch Explorer to graphically analyze the status of your batch jobs.
 
-Here, you'll learn about the Azure Batch Explorer tool and how it can help you to manage your jobs.
+Here, you learn about the Azure Batch Explorer tool and how it can help you to manage your jobs.
 
 ## What is the Azure Batch Explorer?