本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `[queue]` 區段
<a name="queue-section"></a>

定義單一佇列的組態設定。只有在 [`scheduler`](cluster-definition.md#scheduler) 設定為 時，才支援 [`[queue]`區段](#queue-section)`slurm`。

格式為 `[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 執行個體的詳細資訊，請參閱 [使用 競價型執行個體](spot.md)。

**注意**  
使用 Spot 執行個體需要`AWSServiceRoleForEC2Spot`服務連結角色存在於您的帳戶中。若要使用 在帳戶中建立此角色 AWS CLI，請執行下列命令：  

```
aws iam create-service-linked-role --aws-service-name spot.amazonaws.com
```
如需詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的 [Spot 執行個體請求的服務連結角色](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>

**（選用）** 停用此佇列中節點上的超執行緒。並非所有執行個體類型都可以停用超執行緒。如需支援停用超執行緒的執行個體類型清單，請參閱《*Amazon 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 EC2 Linux 執行個體使用者指南》中的*[支援的執行個體類型](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 版開始，此設定沒有效果。如果執行個體類型支援 GPUDirect RDMA （遠端直接記憶體存取），則運算節點一律會啟用 Elastic Fabric Adapter (EFA) 支援。

**注意**  
AWS ParallelCluster 2.10.0 版到 2.11.2 版：如果為 `true`，則 指定為此佇列中的節點啟用 Elastic Fabric Adapter (EFA) GPUDirect RDMA （遠端直接記憶體存取）。將此設定為 `true`需要這些作業系統 `true` (`alinux2`、`ubuntu1804`、 `centos7`或 `p4d.24xlarge`) 上的下列執行個體類型 () 支援將 [`enable_efa`](#queue-enable-efa)設定設為 .EFA GPUDirect RDMA`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
```

**注意**  
`enable_efa_gdr` 2.10.0 AWS ParallelCluster 版已新增 的支援。

[更新政策：必須停止運算機群，才能變更此設定以進行更新。](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)