Skip to content

Commit fdc1087

Browse files
authored
Merge pull request #109508 from LauraBrenner/laura-manage-update
updates fixed
2 parents d88be39 + 6d933ee commit fdc1087

File tree

4 files changed

+12
-10
lines changed

4 files changed

+12
-10
lines changed

articles/batch/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,8 @@
6969
items:
7070
- name: Manage Batch accounts
7171
items:
72+
- name: Manage your account
73+
- href: batch-manage-account-basics.md
7274
- name: Manage Batch accounts with the portal
7375
href: batch-account-create-portal.md
7476
- name: Manage Batch accounts with Batch Management .NET

articles/batch/batch-cli-templates.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ are not developers. With only CLI commands, you can create a pool, upload input
2828
associated tasks, and download the resulting output data. No additional code is
2929
required. Run the CLI commands directly or integrate them into scripts.
3030

31-
Batch templates build on the [existing Batch support in the Azure
31+
Batch templates build on the existing Batch support in the [Azure
3232
CLI](batch-cli-get-started.md#json-files-for-resource-creation) for JSON files to specify property values when creating pools,
3333
jobs, tasks, and other items. Batch templates add the following capabilities:
3434

@@ -101,7 +101,7 @@ the following main concepts:
101101
- Allow property values to be specified in a body section, with only
102102
parameter values needing to be supplied when the template is used. For
103103
example, the complete definition for a pool could be placed in the body
104-
and only one parameter defined for pool id; only a pool ID string
104+
and only one parameter defined for `poolId`; only a pool ID string
105105
therefore needs to be supplied to create a pool.
106106

107107
- The template body can be authored by someone with knowledge of Batch and

articles/batch/batch-manage-account-basics.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.service: batch
1212
ms.workload: big-compute
1313
ms.tgt_pltfrm: na
1414
ms.topic: conceptual
15-
ms.date: 03/05/2020
15+
ms.date: 03/30/2020
1616
ms.author: labrenne
1717
ms.custom: H1Hack27Feb2017
1818

@@ -30,13 +30,13 @@ You can run multiple Batch workloads in a single Batch account, or distribute yo
3030

3131
The Batch account enables you to run large-scale parallel and high-performance computing (HPC) batch jobs efficiently in Azure. Within the account you manage:
3232

33-
- the applications you are running
33+
- The applications you are running
3434

35-
- the allocation of pools and nodes within pools
35+
- The allocation of pools and nodes within pools
3636

37-
- the number and types of tasks
37+
- The number and types of tasks
3838

39-
- the input and output of data. You don't need to install additional software to manage tasks.
39+
- The input and output of data. You don't need to install additional software to manage tasks.
4040

4141
- When you create the Batch account, you are asked to assign a name to it. This name is its ID and once assigned cannot be changed.
4242

articles/batch/best-practices.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ A job is a container designed to contain hundreds, thousands, or even millions o
8181
Do not design a Batch solution that requires thousands simultaneously of active jobs. There is no quota for tasks, so executing as many tasks under as few jobs as possible efficiently uses your [job and job schedule quotas](batch-quota-limit.md#resource-quotas).
8282

8383
- **Job lifetime**
84-
A Batch job has an indefinite lifetime until it's deleted from the system. A jobs state designates whether it can accept more tasks for scheduling or not. A job does not automatically move to completed state unless explicitly terminated. This can be automatically triggered through the [onAllTasksComplete](https://docs.microsoft.com/dotnet/api/microsoft.azure.batch.common.onalltaskscomplete?view=azure-dotnet) property or [maxWallClockTime](https://docs.microsoft.com/rest/api/batchservice/job/add#jobconstraints).
84+
A Batch job has an indefinite lifetime until it's deleted from the system. A job's state designates whether it can accept more tasks for scheduling or not. A job does not automatically move to completed state unless explicitly terminated. This can be automatically triggered through the [onAllTasksComplete](https://docs.microsoft.com/dotnet/api/microsoft.azure.batch.common.onalltaskscomplete?view=azure-dotnet) property or [maxWallClockTime](https://docs.microsoft.com/rest/api/batchservice/job/add#jobconstraints).
8585

8686
There is a default [active job and job schedule quota](batch-quota-limit.md#resource-quotas). Jobs and job schedules in completed state do not count towards this quota.
8787

@@ -111,12 +111,12 @@ Tasks are individual units of work that comprise a job. Tasks are submitted by t
111111

112112
### Designing for retries and re-execution
113113

114-
Tasks can be automatically retried by Batch. There are two types of retries: user-controlled and internal. User-controlled retries are specified by the tasks [maxTaskRetryCount](https://docs.microsoft.com/dotnet/api/microsoft.azure.batch.taskconstraints.maxtaskretrycount?view=azure-dotnet). When a program specified in the task exits with a non-zero exit code, the task is retried up to the value of the `maxTaskRetryCount`.
114+
Tasks can be automatically retried by Batch. There are two types of retries: user-controlled and internal. User-controlled retries are specified by the task's [maxTaskRetryCount](https://docs.microsoft.com/dotnet/api/microsoft.azure.batch.taskconstraints.maxtaskretrycount?view=azure-dotnet). When a program specified in the task exits with a non-zero exit code, the task is retried up to the value of the `maxTaskRetryCount`.
115115

116116
Although rare, a task can be retried internally due to failures on the compute node, such as not being able to update internal state or a failure on the node while the task is running. The task will be retried on the same compute node, if possible, up to an internal limit before giving up on the task and deferring the task to be rescheduled by Batch, potentially on a different compute node.
117117

118118
- **Build durable tasks**
119-
Tasks should be designed to withstand failure and accommodate retry. This is especially important for long running tasks. To do this, ensure tasks generate the same, single result even if they are run more than once. One way to achieve this is to make your tasks goal seeking. Another way is to make sure your tasks are idempotent (tasks will have the same outcome no matter how many times they are run).
119+
Tasks should be designed to withstand failure and accommodate retry. This is especially important for long running tasks. To do this, ensure tasks generate the same, single result even if they are run more than once. One way to achieve this is to make your tasks "goal seeking". Another way is to make sure your tasks are idempotent (tasks will have the same outcome no matter how many times they are run).
120120

121121
A common example is a task to copy files to a compute node. A simple approach is a task that copies all the specified files every time it runs, which is inefficient and isn't built to withstand failure. Instead, create a task to ensure the files are on the compute node; a task that doesn't recopy files that are already present. In this way, the task picks up where it left off if it was interrupted.
122122

0 commit comments

Comments
 (0)