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

# 更新 AWS PCS 佇列
<a name="working-with_queues_update"></a>

本主題提供可用選項的概觀，並說明更新 AWS PCS 佇列時的考量事項。如需 Slurm 自訂設定的詳細資訊，請參閱 [AWS PCS 佇列的自訂 Slurm 設定](slurm-custom-settings-queue.md)。

## 更新 AWS PCS 佇列時的考量事項
<a name="working-with_queues_update_considerations"></a>

佇列更新不會影響執行中的任務，但叢集在更新佇列時可能無法接受新任務。

## 更新 AWS PCS 佇列
<a name="working-with_queues_update_update"></a>

您可以使用 AWS 管理主控台 或 AWS CLI 來更新佇列。

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

**更新佇列**

1. 在 開啟 AWS PCS 主控台 `https://console.aws.amazon.com/pcs/home#/clusters`

1. 選取您要更新佇列的叢集。

1. 導覽至**佇列**，前往要更新的佇列，然後選取**編輯**。

1. 在佇列組態區段中，更新下列任何值：
   +  **節點群組** – 新增或移除運算節點群組與佇列的關聯。
   +  **其他排程器設定** – 新增、修改或移除佇列的自訂 Slurm 設定。如需詳細資訊，請參閱[AWS PCS 佇列的自訂 Slurm 設定](slurm-custom-settings-queue.md)。
   +  **標籤** – 新增或移除佇列的標籤。

1. 選擇**更新**。套用變更時，**狀態**欄位會顯示*更新*。
**重要**  
佇列更新可能需要幾分鐘的時間。

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

**更新佇列**

1. 使用下列命令更新您的佇列。執行命令之前，請執行下列替換：

   1. 將 {{region-code}} 取代為您要在其中建立叢集 AWS 區域 的 。

   1. 將 {{my-queue}} 取代`computeNodeGroupId`為佇列的名稱或 。

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

   1.  若要變更運算節點群組關聯，請提供 的更新清單`--compute-node-group-configurations`。

      1.  例如，若要新增第二個運算節點群組 `computeNodeGroupExampleID2`：

        ```
        --compute-node-group-configurations computeNodeGroupId=computeNodeGroupExampleID1,computeNodeGroupId=computeNodeGroupExampleID2
        ```

   ```
   aws pcs update-queue --region {{region-code}} \
       --queue-identifier {{my-queue}} \
       --cluster-identifier {{my-cluster}} \
       --compute-node-group-configurations \
       computeNodeGroupId={{computeNodeGroupExampleID1}}
   ```  
**Example – 使用自訂 Slurm 設定更新佇列**  

   ```
   aws pcs update-queue --region {{region-code}} \
       --queue-identifier {{my-queue}} \
       --cluster-identifier {{my-cluster}} \
       --slurm-configuration \
       'slurmCustomSettings=[{parameterName=Default,parameterValue=YES}]'
   ```

   如需詳細資訊，請參閱[AWS PCS 佇列的自訂 Slurm 設定](slurm-custom-settings-queue.md)。

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

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

------

**建議的後續步驟**
+ 將任務提交至更新後的佇列。