你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CLI 示例：使用 Azure Batch 运行作业和任务

项目
03/10/2023

此脚本将创建一个批处理作业，并将一系列任务添加到该作业。它还演示了如何监视作业及其任务。

如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

先决条件

在 Azure Cloud Shell 中使用 Bash 环境。有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
- 运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

示例脚本

启动 Azure Cloud Shell

Azure Cloud Shell 是免费的交互式 shell，可以使用它运行本文中的步骤。它预安装有常用 Azure 工具并将其配置与帐户一起使用。

若要打开 Cloud Shell，只需要从代码块的右上角选择“试一试”。也可以通过转到 https://shell.azure.com 在单独的浏览器标签页中启动 Cloud Shell。

当 Cloud Shell 打开时，请验证是否为环境选择了“Bash”。后续会话将在 Bash 环境中使用 Azure CLI，选择“复制”以复制代码块，将其粘贴到 Cloud Shell 中，然后按 Enter 来运行它。

Cloud Shell 会在登录时使用的初始帐户下自动进行身份验证。使用以下脚本通过其他订阅登录，将 <Subscription ID> 替换为 Azure 订阅 ID。如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

有关详细信息，请参阅设置有效的订阅或以交互方式登录

在 Batch 服务模式下创建 Batch 帐户

# Run a job and tasks with Azure Batch

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
[[ "$RESOURCE_GROUP" == '' ]] && resourceGroup="msdocs-batch-rg-$randomIdentifier" || resourceGroup="${RESOURCE_GROUP}"
tag="run-job"
storageAccount="msdocsstorage$randomIdentifier"
batchAccount="msdocsbatch$randomIdentifier"

# Create a resource group.
echo "Creating $resourceGroup in "$location"..."
az group create --name $resourceGroup --location "$location" --tag $tag

# Create a general-purpose storage account in your resource group.
echo "Creating $storageAccount"
az storage account create --resource-group $resourceGroup --name $storageAccount --location "$location" --sku Standard_LRS

# Create a Batch account.
echo "Creating $batchAccount"
az batch account create --name $batchAccount --storage-account $storageAccount --resource-group $resourceGroup --location "$location"

# Authenticate against the account directly for further CLI interaction.
az batch account login --name $batchAccount --resource-group $resourceGroup --shared-key-auth

# Create a new Linux pool with a virtual machine configuration. 
az batch pool create --id mypool --vm-size Standard_A1 --target-dedicated 2 --image canonical:ubuntuserver:18_04-lts-gen2 --node-agent-sku-id "batch.node.ubuntu 18.04"

# Create a new job to encapsulate the tasks that are added.
az batch job create --id myjob --pool-id mypool

# Add tasks to the job. Here the task is a basic shell command.
az batch task create --job-id myjob --task-id task1 --command-line "/bin/bash -c 'printenv AZ_BATCH_TASK_WORKING_DIR'"

一次添加许多任务

若要一次添加许多任务，请在一个 JSON 文件中指定这些任务，并将该文件传递给命令。有关格式，请参阅 https://github.com/Azure/azure-docs-cli-python-samples/blob/master/batch/run-job/tasks.json。请提供该 JSON 文件的绝对路径。有关示例 JSON 文件，请参阅 https://github.com/Azure-Samples/azure-cli-samples/blob/master/batch/run-job/tasks.json。

az batch task create \
    --job-id myjob \
    --json-file tasks.json

更新作业

更新作业，以便在完成所有任务后自动将其标记为已完成。

az batch job set \
--job-id myjob \
--on-all-tasks-complete terminatejob

监视作业的状态

az batch job show --job-id myjob

监视任务的状态

az batch task show \
    --job-id myjob \
    --task-id task1

清理资源

使用 az group delete 命令删除资源组以及与其关联的所有资源 - 除非你持续需要这些资源。其中一些资源在创建和删除时可能要稍等片刻。

az group delete --name $resourceGroup

示例参考

此脚本使用以下命令。表中的每条命令链接到特定于命令的文档。

命令	说明
az group create	创建用于存储所有资源的资源组。
az batch account create	创建批处理帐户。
az batch account login	针对指定的批处理帐户进行身份验证，以便进一步进行 CLI 交互。
az batch pool create	创建计算节点池。
az batch job create	创建批处理作业。
az batch task create	将任务添加到指定的批处理作业。
az batch job set	更新批处理作业的属性。
az batch job show	检索指定批处理作业的详细信息。
az batch task show	从指定的批处理作业中检索任务的详细信息。
az group delete	删除资源组，包括所有嵌套的资源。

后续步骤

有关 Azure CLI 的详细信息，请参阅 Azure CLI 文档。