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

# 在 AWS PCS 中建立佇列
<a name="working-with_queues_create"></a>

本主題提供可用選項的概觀，並說明在 AWS PCS 中建立佇列時應考量的事項。

**注意**  
您可以在佇列上設定自訂 Slurm 設定，以實作分割區特定的排程政策和資源管理。如需詳細資訊，請參閱[在 AWS PCS 中設定自訂 Slurm 設定](slurm-custom-settings.md)。

## 先決條件
<a name="working-with_queues_create_prereq"></a>
+  AWS PCS 叢集 - 只能建立與特定 AWS PCS 叢集相關聯的佇列。
+ 一或多個 AWS PCS 運算節點群組 - 佇列必須與至少一個 AWS PCS 運算節點群組相關聯。

## 在 AWS PCS 中建立佇列
<a name="working-with_queues_create_create"></a>

您可以使用 AWS 管理主控台 或 建立佇列 AWS CLI。

------
#### [ AWS 管理主控台 ]

**使用主控台建立佇列**

1. 開啟 [AWS PCS 主控台](https://console.aws.amazon.com/pcs/home#/clusters)。

1. 選取佇列的叢集。導覽至**佇列**，然後選擇**建立佇列**。

1. 在**佇列組態**區段中，提供下列值：

   1. **佇列名稱** – 佇列的名稱。此名稱僅能使用英數字元 (區分大小寫) 和連字號。它必須以字母字元開頭，且長度不可超過 25 個字元。名稱在叢集中必須是唯一的。

   1. **運算節點群組** – 選取 1 個或多個運算節點群組來服務此佇列。運算節點群組可以與多個佇列建立關聯。

1. （選用） **在其他排程器設定**區段中，您可以新增參數名稱和值對來設定其他 Slurm 設定。如需支援參數的完整清單，請參閱 [AWS PCS 佇列的自訂 Slurm 設定](slurm-custom-settings-queue.md)。

1. （選用） 在**標籤**下，將任何標籤新增至 AWS PCS 佇列

1. 選擇**建立佇列**。當 AWS PCS **建立**佇列時，**狀態**欄位會顯示建立。建立佇列可能需要幾分鐘的時間。

**建議的下一個步驟**
+ 將任務提交到您的新佇列。

------
#### [ AWS CLI ]

**使用 建立佇列 AWS CLI**

使用下列命令來建立佇列。進行下列取代：

1. 將 {{region-code}} 取代為叢集的 AWS 區域。例如 `us-east-1`。

1. 以佇列的名稱取代 {{my-queue}}。此名稱僅能使用英數字元 (區分大小寫) 和連字號。它必須以字母字元開頭，且長度不可超過 25 個字元。名稱在叢集中必須是唯一的。

1. 以叢集的名稱或 ID 取代 {{my-cluster}}。

1. 將 {{compute-node-group-id}} 取代為運算節點群組的 ID，以便為佇列提供服務。例如 `pcs_abcdef12345`。
**注意**  
建立佇列時，您必須提供運算節點群組的 ID，而不是其名稱。

```
aws pcs create-queue --region {{region-code}} \
    --queue-name {{my-queue}} \
    --cluster-identifier {{my-cluster}} \
    --compute-node-group-configurations \
    computeNodeGroupId={{compute-node-group-id}}
```

**Example – 使用自訂 Slurm 設定建立佇列**  

```
aws pcs create-queue --region {{region-code}} \
    --queue-name {{my-queue}} \
    --cluster-identifier {{my-cluster}} \
    --compute-node-group-configurations \
    computeNodeGroupId={{compute-node-group-id}} \
    --slurm-configuration \
    'slurmCustomSettings=[{parameterName=Default,parameterValue=YES}]'
```
如需詳細資訊，請參閱[AWS PCS 佇列的自訂 Slurm 設定](slurm-custom-settings-queue.md)。

建立佇列可能需要幾分鐘的時間。您可以使用下列命令查詢佇列的狀態。在任務的狀態達到 之前，您將無法將任務提交至佇列`ACTIVE`。

```
aws pcs get-queue --region {{region-code}} \
    --cluster-identifier {{my-cluster}} \
    --queue-identifier {{my-queue}}
```

**建議的下一個步驟**
+ 將任務提交到您的新佇列

------