在批处理中的用户帐户下运行任务

Azure Batch 中的任务始终在用户帐户下运行。 默认情况下，任务在没有管理员权限的标准用户帐户下运行。 对于某些方案，建议你配置用于运行任务的用户帐户。 本文介绍用户帐户的类型以及如何为方案配置这些帐户。

用户帐户的类型

Azure Batch 提供两种类型的用户帐户来运行任务：

• 自动用户帐户。 自动用户帐户是批处理服务自动创建的内置用户帐户。 默认情况下，任务在自动用户帐户下运行。 可为任务配置自动用户规范，指明任务应在哪个自动用户帐户下运行。 自动用户配置允许您指定运行任务的自动用户帐户的权限级别和适用范围。

• 命名用户帐户。 创建池时，可为该池指定一个或多个命名用户帐户。 每个用户帐户在该池的每个节点上创建。 除了帐户名以外，还可以指定用户帐户密码、提升级别，对于 Linux 池，还可以指定 SSH 私钥。 添加任务时，可以指定任务应在其下运行的命名用户帐户。

用户帐户对文件和目录的访问权限

自动用户帐户和命名用户帐户对任务的工作目录、共享目录和多实例任务目录拥有读/写访问权限。 这两种类型的帐户都对启动目录和作业准备目录拥有读取访问权限。

如果某个任务在用于运行启动任务的同一帐户下运行，则该任务对启动任务目录拥有读写访问权限。 同理，如果某个任务在用于运行作业准备任务的同一帐户下运行，则该任务对作业准备任务目录拥有读写访问权限。 如果用于运行某个任务的帐户不同于用于启动任务或作业准备任务的帐户，则该任务对相应目录拥有只读访问权限。

有关访问任务中的文件和目录的详细信息，请参阅文件和目录。

任务的提升访问权限

用户帐户的提升级别指示任务是否可以使用提升的访问权限运行。 自动用户帐户和命名用户帐户都可以使用提升的访问权限运行。 提升级别的两个选项为：

• NonAdmin： 任务以没有提升访问权限的标准用户身份运行。 批处理用户帐户的默认提升级别始终为 NonAdmin。
• Admin： 任务以拥有提升访问权限的用户身份运行，以完全管理员权限操作。

自动用户帐户

默认情况下，任务在 Batch 中的自动用户帐户下，以没有提升访问权限但具有工作范围的标准用户身份运行。 池范围意味着任务在可供池中任何任务使用的自动用户帐户下运行。 有关池范围的详细信息，请参阅以具有池范围的自动用户身份运行任务。

池范围的替代设置为任务范围。 如果为任务范围配置了自动用户规范，批处理服务只为该任务创建自动用户帐户。

自动用户规范有四种可能的配置，其中每种配置对应于一个唯一的自动用户帐户：

• 具有任务范围的非管理员访问权限
• 具有任务范围的管理员（提升的）访问权限
• 具有池范围的非管理员访问权限
• 具有池范围的管理员访问权限

以拥有提升访问权限的自动用户身份运行任务

如果需要使用提升的访问权限运行任务，可以针对管理员特权配置自动用户规范。 例如，启动任务可能需要使用提升的访问权限在节点上安装软件。

以下代码片段演示如何配置自动用户规范。 这些示例将提升级别设置为 Admin，将范围设置为 Task。

批处理 .NET

task.UserIdentity = new UserIdentity(new AutoUserSpecification(elevationLevel: ElevationLevel.Admin, scope: AutoUserScope.Task));

批处理 Java

taskToAdd.withId(taskId)
        .withUserIdentity(new UserIdentity()
            .withAutoUser(new AutoUserSpecification()
                .withElevationLevel(ElevationLevel.ADMIN))
                .withScope(AutoUserScope.TASK));
        .withCommandLine("cmd /c echo hello");

批处理 Python

user = batchmodels.UserIdentity(
    auto_user=batchmodels.AutoUserSpecification(
        elevation_level=batchmodels.ElevationLevel.admin,
        scope=batchmodels.AutoUserScope.task))
task = batchmodels.TaskAddParameter(
    id='task_1',
    command_line='cmd /c "echo hello world"',
    user_identity=user)
batch_client.task.add(job_id=jobid, task=task)

以具有池范围的自动用户身份运行任务

预配节点后，会在池中的每个节点上创建两个池范围的自动用户帐户，其中一个帐户拥有提升的访问权限，另一个帐户没有提升的访问权限。 如果将给定任务的自动用户范围设置为池范围，会在这两个池范围自动用户帐户中的一个帐户下运行该任务。

为自动用户指定池范围时，使用管理员访问权限运行的所有任务会在同一个池范围自动用户帐户下运行。 同样，不使用管理员权限运行的任务也在单个池范围自动用户帐户下运行。

在同一自动用户帐户下运行的优点是任务能够轻松地与在同一节点上运行的其他任务共享数据。 用户帐户重用也有性能优势。

在任务之间共享机密就是一种有效的方案，这样可以在两个池范围自动用户帐户中的一个帐户下运行任务。 例如，假设某个启动任务需要在其他任务可以使用的节点上预配机密。 可以使用 Windows 数据保护 API (DPAPI)，但这需要管理员特权。 不过，可以在用户级别保护机密。 在同一用户帐户下运行的任务无需提升的访问权限即可访问机密。

可能想要在具有池范围的自动用户帐户下运行任务的另一种情景是实现消息传递接口 (MPI) 文件共享。 如果 MPI 任务中的节点需要处理相同的文件数据，MPI 文件共享将非常有用。 如果子节点在同一自动用户帐户下运行，头节点将创建一个文件共享，子节点可以访问该文件共享。

以下代码片段在批处理 .NET 中会自动用户的范围设置为任务的池范围。 已省略提升级别，因此，任务会在标准池范围自动用户帐户下运行。

task.UserIdentity = new UserIdentity(new AutoUserSpecification(scope: AutoUserScope.Pool));

命名用户帐户

创建池时，可以定义命名用户帐户。 命名用户帐户具有所提供的名称和密码。 可为命名用户帐户指定提升级别。 对于 Linux 节点，还可以提供 SSH 私钥。

命名用户帐户在池中的所有节点上存在，可供这些节点上运行的所有任务使用。 可为一个池定义任意数目的命名用户。 添加任务或任务集合时，可以指定任务需在池中定义的某个命名用户帐户下运行。

如果要在同一个用户帐户下运行作业中的所有任务，但同时要将这些任务与其他作业中运行的任务区分开来，则命名用户帐户将非常有用。 例如，可为每个作业创建一个命名用户，并在该命名用户帐户下运行每个作业的任务。 然后，每个作业可与其自身的任务共享机密，但不能与其他作业中运行的任务共享机密。

还可以使用命名用户帐户来运行可在外部资源（例如文件共享）上设置权限的任务。 使用命名用户帐户可以控制用户标识，并使用该用户标识来设置权限。

命名用户帐户可在 Linux 节点之间启用无密码 SSH。 可以在需要运行多实例任务的 Linux 节点中使用命名用户帐户。 池中的每个节点可以在整个池中定义的用户帐户下运行任务。 有关多实例任务的详细信息，请参阅使用多实例任务运行 MPI 应用程序。

创建命名用户帐户

若要在批处理中创建命名用户帐户，请在池中添加一个用户帐户集合。 以下代码片段演示如何在 .NET、Java 和 Python 中创建命名用户帐户。 这些代码片段演示如何在池中创建管理员和非管理员命名帐户。

Batch .NET 示例 (Windows)

CloudPool pool = null;
Console.WriteLine("Creating pool [{0}]...", poolId);

// Create a pool using Virtual Machine Configuration.
pool = batchClient.PoolOperations.CreatePool(
    poolId: poolId,
    targetDedicatedComputeNodes: 2,
    virtualMachineSize: "standard_d2s_v3",
    VirtualMachineConfiguration: new VirtualMachineConfiguration(
    imageReference: new ImageReference(
                        publisher: "MicrosoftWindowsServer",
                        offer: "WindowsServer",
                        sku: "2022-datacenter-core",
                        version: "latest"),
    nodeAgentSkuId: "batch.node.windows amd64");

// Add named user accounts.
pool.UserAccounts = new List<UserAccount>
{
    new UserAccount("adminUser", "A1bC2d", ElevationLevel.Admin),
    new UserAccount("nonAdminUser", "A1bC2d", ElevationLevel.NonAdmin),
};

// Commit the pool.
await pool.CommitAsync();

Batch .NET 示例 (Linux)

CloudPool pool = null;

// Obtain a collection of all available node agent SKUs.
List<NodeAgentSku> nodeAgentSkus =
    batchClient.PoolOperations.ListNodeAgentSkus().ToList();

// Define a delegate specifying properties of the VM image to use.
Func<ImageReference, bool> isUbuntu2404 = imageRef =>
    imageRef.Publisher == "Canonical" &&
    imageRef.Offer == "ubuntu-24_04-lts" &&
    imageRef.Sku.Contains("server");

// Obtain the first node agent SKU in the collection that matches
NodeAgentSku ubuntuAgentSku = nodeAgentSkus.First(sku =>
    sku.VerifiedImageReferences.Any(isUbuntu2404));

// Select an ImageReference from those available for node agent.
ImageReference imageReference =
    ubuntuAgentSku.VerifiedImageReferences.First(isUbuntu2404);

// Create the virtual machine configuration to use to create the pool.
VirtualMachineConfiguration virtualMachineConfiguration =
    new VirtualMachineConfiguration(imageReference, ubuntuAgentSku.Id);

Console.WriteLine("Creating pool [{0}]...", poolId);

// Create the unbound pool.
pool = batchClient.PoolOperations.CreatePool(
    poolId: poolId,
    targetDedicatedComputeNodes: 2,
    virtualMachineSize: "Standard_d2s_v3",
    virtualMachineConfiguration: virtualMachineConfiguration);
// Add named user accounts.
pool.UserAccounts = new List<UserAccount>
{
    new UserAccount(
        name: "adminUser",
        password: "A1bC2d",
        elevationLevel: ElevationLevel.Admin,
        linuxUserConfiguration: new LinuxUserConfiguration(
            uid: 12345,
            gid: 98765,
            sshPrivateKey: new Guid().ToString()
            )),
    new UserAccount(
        name: "nonAdminUser",
        password: "A1bC2d",
        elevationLevel: ElevationLevel.NonAdmin,
        linuxUserConfiguration: new LinuxUserConfiguration(
            uid: 45678,
            gid: 98765,
            sshPrivateKey: new Guid().ToString()
            )),
};

// Commit the pool.
await pool.CommitAsync();

批处理 Java 示例

List<UserAccount> userList = new ArrayList<>();
userList.add(new UserAccount().withName(adminUserAccountName).withPassword(adminPassword).withElevationLevel(ElevationLevel.ADMIN));
userList.add(new UserAccount().withName(nonAdminUserAccountName).withPassword(nonAdminPassword).withElevationLevel(ElevationLevel.NONADMIN));
PoolAddParameter addParameter = new PoolAddParameter()
        .withId(poolId)
        .withTargetDedicatedNodes(POOL_VM_COUNT)
        .withVmSize(POOL_VM_SIZE)
        .withVirtualMachineConfiguration(configuration)
        .withUserAccounts(userList);
batchClient.poolOperations().createPool(addParameter);

批处理 Python 示例

users = [
    batchmodels.UserAccount(
        name='pool-admin',
        password='A1bC2d',
        elevation_level=batchmodels.ElevationLevel.admin)
    batchmodels.UserAccount(
        name='pool-nonadmin',
        password='A1bC2d',
        elevation_level=batchmodels.ElevationLevel.non_admin)
]
pool = batchmodels.PoolAddParameter(
    id=pool_id,
    user_accounts=users,
    virtual_machine_configuration=batchmodels.VirtualMachineConfiguration(
        image_reference=image_ref_to_use,
        node_agent_sku_id=sku_to_use),
    vm_size=vm_size,
    target_dedicated=vm_count)
batch_client.pool.add(pool)

在拥有提升的访问权限的命名用户帐户下运行任务

要以提升权限的用户身份运行某个任务，请将该任务的 UserIdentity 属性设置为创建的命名用户帐户（该帐户的 ElevationLevel 属性已设置为 Admin）。

此代码片段指定任务应在命名用户帐户下运行。 此命名用户帐户是在创建池时定义的。 在本例中，创建的命名用户帐户拥有管理员权限：

CloudTask task = new CloudTask("1", "cmd.exe /c echo 1");
task.UserIdentity = new UserIdentity(AdminUserAccountName);

将代码更新到最新的批处理客户端库

Batch 服务 2017-01-01.4.0 版引入了一项重大更改，将早期版本中的 runElevated 属性替换为 userIdentity 属性。 下表提供了从早期版本的客户端库更新代码时可以参考的简单更改对照。

批处理 .NET

批处理 Java

批处理 Python

后续步骤

• 了解 Batch 服务工作流和主要资源，例如池、节点、作业和任务。
• 了解 Azure Batch 中的文件和目录。