翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS PCS キュー
<a name="working-with_queues"></a>

 AWS PCS キューは、スケジューラのワークキューのネイティブ実装に対する軽量な抽象化です。Slurm の場合、PCS AWS キューは Slurm パーティションと同等です。

 ユーザーは、1 つ以上のコンピューティングノードグループによって提供されるノードで実行するようにスケジュールされるまで、ジョブが存在するキューに送信します。PCS AWS クラスターには、複数のジョブキューを含めることができます。例えば、優先度の高いジョブには Amazon EC2 オンデマンドインスタンスを使用するキューを作成し、優先度の低いジョブには Amazon EC2 スポットインスタンスを使用する別のキューを作成できます。

**Topics**
+ [PCS AWS でのキューの作成](working-with_queues_create.md)
+ [PCS AWS キューの更新](working-with_queues_update.md)
+ [PCS AWS でのキューの削除](working-with_queues_delete.md)

# PCS AWS でのキューの作成
<a name="working-with_queues_create"></a>

このトピックでは、使用可能なオプションの概要と、PCS AWS でキューを作成するときに考慮すべき点について説明します。

**注記**  
キューにカスタム Slurm 設定を設定して、パーティション固有のスケジューリングポリシーとリソース管理を実装できます。詳細については、「[PCS でのカスタム Slurm AWS 設定の設定](slurm-custom-settings.md)」を参照してください。

## 前提条件
<a name="working-with_queues_create_prereq"></a>
+  AWS PCS クラスター - キューは、特定の PCS AWS クラスターに関連してのみ作成できます。
+ 1 つ以上の AWS PCS コンピューティングノードグループ - キューは少なくとも 1 つの PCS AWS コンピューティングノードグループに関連付ける必要があります。

## PCS AWS でキューを作成するには
<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 設定を設定できます。サポートされているパラメータの完全なリストについては、「」を参照してください[PCS キューのカスタム Slurm AWS 設定](slurm-custom-settings-queue.md)。

1. （オプション) **タグ**で、PCS AWS キューにタグを追加します。

1. [**キューの作成**]を選択します。Status ****フィールドには、PCS AWS がキューを作成している間に**作成**中と表示されます。キューの作成には数分かかる場合があります。

**推奨される次のステップ**
+ 新しいキューにジョブを送信します。

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

**を使用してキューを作成するには AWS CLI**

キューを作成するには、次のコマンドを使用します。次の置換を行います。

1. *region-code* をクラスターの AWS リージョンに置き換えます。例えば、`us-east-1`。

1. *my-queue* をキューの名前に置き換えます。この名前には英数字 (大文字と小文字が区別されます) とハイフンのみを使用できます。アルファベット文字で始まり、25 文字を超えることはできません。名前はクラスター内で一意である必要があります。

1. *my-cluster* をクラスターの名前または ID に置き換えます。

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}]'
```
詳細については、「[PCS キューのカスタム Slurm AWS 設定](slurm-custom-settings-queue.md)」を参照してください。

キューの作成には数分かかる場合があります。次のコマンドを使用して、キューのステータスをクエリできます。ステータスが に達するまで、ジョブをキューに送信することはできません`ACTIVE`。

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

**推奨される次のステップ**
+ 新しいキューにジョブを送信する

------

# PCS AWS キューの更新
<a name="working-with_queues_update"></a>

このトピックでは、使用可能なオプションの概要と、PCS AWS キューを更新するときに考慮すべき点について説明します。Slurm のカスタム設定の詳細については、「」を参照してください[PCS キューのカスタム Slurm AWS 設定](slurm-custom-settings-queue.md)。

## PCS AWS キューを更新する際の考慮事項
<a name="working-with_queues_update_considerations"></a>

キューの更新は実行中のジョブには影響しませんが、キューの更新中にクラスターが新しいジョブを受け入れることができない場合があります。

## PCS AWS キューを更新するには
<a name="working-with_queues_update_update"></a>

 AWS マネジメントコンソール または を使用してキュー AWS CLI を更新できます。

------
#### [ AWS マネジメントコンソール ]

**キューを更新するには**

1. で PCS AWS コンソールを開きます。 `https://console.aws.amazon.com/pcs/home#/clusters`

1. キューを更新するクラスターを選択します。

1. **キュー**に移動し、更新するキューに移動し、**編集**を選択します。

1. キュー設定セクションで、次のいずれかの値を更新します。
   +  **ノードグループ** – キューとの関連付けからコンピューティングノードグループを追加または削除します。
   +  **追加のスケジューラ設定** – キューのカスタム Slurm 設定を追加、変更、または削除します。詳細については、「[PCS キューのカスタム Slurm AWS 設定](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.  たとえば、2 番目のコンピューティングノードグループ を追加するには`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}]'
   ```

   詳細については、「[PCS キューのカスタム Slurm AWS 設定](slurm-custom-settings-queue.md)」を参照してください。

1. キューの更新には数分かかる場合があります。次のコマンドを使用して、キューのステータスをクエリできます。ステータスが に達するまで、ジョブをキューに送信することはできません`ACTIVE`。

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

------

**推奨される次のステップ**
+ 更新されたキューにジョブを送信します。

# PCS AWS でのキューの削除
<a name="working-with_queues_delete"></a>

このトピックでは、PCS AWS で キューを削除する方法の概要を説明します。

## キューを削除する際の考慮事項
<a name="working-with_queues_delete_considerations"></a>
+  キューで実行中のジョブがある場合、キューが削除されるとスケジューラによってジョブが終了します。キュー内の保留中のジョブはキャンセルされます。キュー内のジョブが終了するのを待つか、スケジューラのネイティブコマンド (Slurm `scancel`の場合など) を使用して手動で停止/キャンセルすることを検討してください。

## キューの削除
<a name="working-with_queues_delete_methods"></a>

 AWS マネジメントコンソール または を使用してキュー AWS CLI を削除できます。

------
#### [ AWS マネジメントコンソール ]

**キューを削除するには**

1. [AWS PCS コンソール](https://console.aws.amazon.com/pcs/home#/clusters)を開きます。

1. キューのクラスターを選択します。

1. **キュー**に移動し、削除するキューを選択します。

1. **[削除]** を選択します。

1. Status ****フィールドには が表示されます`Deleting`。完了までに数分かかることがあります。

**注記**  
スケジューラにネイティブなコマンドを使用して、キューが削除されたことを確認できます。たとえば、Slurm `squeue`には `sinfo`または を使用します。

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

**キューを削除するには**
+  キューを削除するには、次のコマンドを使用します。
  +  *region-code* をクラスターがある に置き換え AWS リージョン ます。
  +  *my-queue* をキューの名前または ID に置き換えます。
  +  *my-cluster* をクラスターの名前または ID に置き換えます。

  ```
  aws pcs delete-queue --region region-code \
         --queue-identifier my-queue \
         --cluster-identifier my-cluster
  ```

   キューの削除には数分かかる場合があります。
**注記**  
スケジューラにネイティブなコマンドを使用して、キューが削除されたことを確認できます。たとえば、Slurm `squeue`には `sinfo`または を使用します。

------