本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `[queue]` 部分
<a name="queue-section"></a>

定义单个队列的配置设置。只有当 [`scheduler`](cluster-definition.md#scheduler) 设置为 `slurm` 时，才支持 [`[queue]` 部分](#queue-section)。

格式为`[queue <queue-name>]`。 *queue-name*必须以小写字母开头，不能超过 30 个字符，并且只能包含小写字母、数字和连字符 (-)。

```
[queue q1]
compute_resource_settings = i1,i2
placement_group = DYNAMIC
enable_efa = true
disable_hyperthreading = false
compute_type = spot
```

**注意**  
2.9.0 AWS ParallelCluster 版本中增加了对该[`[queue]`部分](#queue-section)的支持。

**Topics**
+ [`compute_resource_settings`](#queue-compute-resource-settings)
+ [`compute_type`](#queue-compute-type)
+ [`disable_hyperthreading`](#queue-disable-hyperthreading)
+ [`enable_efa`](#queue-enable-efa)
+ [`enable_efa_gdr`](#queue-enable-efa-gdr)
+ [`placement_group`](#queue-placement-group)

## `compute_resource_settings`
<a name="queue-compute-resource-settings"></a>

**（必需）**标识包含该队列的计算资源配置的 [`[compute_resource]` 部分](compute-resource-section.md)。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。

每个 [`[compute_resource]` 部分](compute-resource-section.md)最多支持三 (3) 个 [`[queue]` 部分](#queue-section)。

例如，以下设置指定使用以 `[compute_resource cr1]` 和 `[compute_resource cr2]` 开始的部分。

```
compute_resource_settings = cr1, cr2
```

[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)

## `compute_type`
<a name="queue-compute-type"></a>

**（可选）**定义要为此队列启动的实例的类型。该设置替代 [`cluster_type`](cluster-definition.md#cluster-type) 设置。

有效的选项为：`ondemand` 和 `spot`。

默认值为 `ondemand`。

有关竞价型实例的更多信息，请参阅[使用竞价型实例](spot.md)。

**注意**  
使用竞价型实例要求您的账户中存在 `AWSServiceRoleForEC2Spot` 服务相关角色。要使用在您的账户中创建此角色 AWS CLI，请运行以下命令：  

```
aws iam create-service-linked-role --aws-service-name spot.amazonaws.com
```
有关更多信息，请参阅 *Amazon EC2 用户指南*中的[竞价型实例请求的服务相关角色](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-requests.html#service-linked-roles-spot-instance-requests)。

以下示例 SpotInstances 用于此队列中的计算节点。

```
compute_type = spot
```

[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)

## `disable_hyperthreading`
<a name="queue-disable-hyperthreading"></a>

**（可选）**对此队列中的节点禁用超线程。并非所有实例类型都可以禁用超线程。有关支持禁用超线程的实例类型列表，请参阅 A *mazon EC2 用户*指南中[每种实例类型的 CPU 核心和每个 CPU 内核的线程](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-supported-instances-values)。如果定义了 [`[cluster]` 部分](cluster-definition.md)中的 [`disable_hyperthreading`](cluster-definition.md#disable-hyperthreading) 设置，则不能定义此设置。

默认值为 `false`。

```
disable_hyperthreading = true
```

[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)

## `enable_efa`
<a name="queue-enable-efa"></a>

**（可选）**如果设置为 `true`，则指定为此队列中的节点启用 Elastic Fabric Adapter (EFA)。要查看支持 EFA 的 EC2 实例列表，请参阅 *Amazon Linux 实例 EC2 用户指南中的支持的实例*[类型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types)。如果定义了 [`[cluster]` 部分](cluster-definition.md)中的 [`enable_efa`](cluster-definition.md#enable-efa) 设置，则不能定义此设置。应使用集群置放群组来最大限度地减少实例之间的延迟。有关更多信息，请参阅[`placement`](cluster-definition.md#placement)和[`placement_group`](cluster-definition.md#placement-group)。

```
enable_efa = true
```

[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)

## `enable_efa_gdr`
<a name="queue-enable-efa-gdr"></a>

**（可选）**从 2.11.3 AWS ParallelCluster 版本开始，此设置无效。Elastic Fabric Adapter (EFA) GPUDirect 对计算节点的 RDMA（远程直接内存访问）支持始终处于启用状态（如果实例类型支持），则始终处于启用状态。

**注意**  
AWS ParallelCluster 版本 2.10.0 到 2.11.2：如果`true`，则指定为该队列中的节点启用弹性结构适配器 (EFA) Fabric GPUDirect RDMA（远程直接内存访问）。将其设置为`true`要求将该[`enable_efa`](#queue-enable-efa)设置设置为 `true` .EF GPUDirect A RDMA，这些操作系统（`alinux2`、`centos7``ubuntu1804`、或 `p4d.24xlarge``ubuntu2004`）支持以下实例类型 ()。如果定义了 [`[cluster]` 部分](cluster-definition.md)中的 [`enable_efa_gdr`](cluster-definition.md#enable-efa-gdr) 设置，则不能定义此设置。应使用集群置放群组来最大限度地减少实例之间的延迟。有关更多信息，请参阅[`placement`](cluster-definition.md#placement)和[`placement_group`](cluster-definition.md#placement-group)。

默认值为 `false`。

```
enable_efa_gdr = true
```

**注意**  
在 2.10.0 AWS ParallelCluster 版本中添加`enable_efa_gdr`了对 Support 的支持。

[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)

## `placement_group`
<a name="queue-placement-group"></a>

**（可选）**如果存在，则定义此队列的置放群组。该设置替代 [`placement_group`](cluster-definition.md#placement-group) 设置。

有效选项为以下值：
+ `DYNAMIC`
+ 现有的 Amazon EC2 集群置放群组名称

当设置为 `DYNAMIC` 时，将此队列的唯一置放群组作为集群堆栈的一部分进行创建和删除。

有关置放群组的更多信息，请参阅 *Amazon EC2 用户指南*中的[置放群组](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html)。如果将同一个置放群组用于不同的实例类型，则请求更有可能因容量不足错误而失败。有关更多信息，请参阅 *Amazon EC2 用户指南*中的[实例容量不足](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/troubleshooting-launch.html#troubleshooting-launch-capacity)。

没有默认值。

并非所有实例类型都支持集群置放群组。例如，`t2.micro` 不支持集群置放群组。有关支持集群置放群组的实例类型列表的信息，请参阅 *Amazon EC2 用户指南*中的[集群置放群组规则和限制](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#placement-groups-limitations-cluster)。有关使用置放群组时的提示，请参阅[置放群组和实例启动问题](troubleshooting.md#placement-groups-and-instance-launch-issues)。

```
placement_group = DYNAMIC
```

[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)