Updating an AWS PCS queue

This topic provides an overview of available options and describes what to consider when you update an AWS PCS queue.

Considerations when updating an AWS PCS queue

Queue updates will not impact running jobs but the cluster may not be able to accept new jobs while the queue is being updated.

To update an AWS PCS compute node group

You can update a node group using the AWS Management Console or the AWS CLI.

AWS Management Console

To update a queue

1. Open the AWS PCS console at https://console.aws.amazon.com/pcs/home#/clusters

2. Select the cluster where you wish to update a queue.

3. Navigate to Queues, go to the queue wish to update, then select Edit.

4. In the queue configuration section, update any of the following values:

   • Node groups – Add or remove compute node groups from association with the queue.

   • Tags – Add or remove tags for the queue.

5. Choose Update. The Status field will show Updating while changes are being applied.

   Important

   Queue updates can take several minutes.

AWS CLI

To update a queue

1. Update your queue with the command that follows. Before running the command, make the following replacements:

   1. Replace region-code with the AWS Region that you want to create your cluster in.

   2. Replace my-queue with the name or computeNodeGroupId for your queue.

   3. Replace my-cluster with the name or clusterId of your cluster.

   4. To change compute node group associations, provide an updated list for --compute-node-group-configurations.

      1. For example, to add a second compute node group 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

2. It can take several minutes to update the queue. You can query the status of your queue with the following command. You won't be able to submit jobs to the queue until its status reaches ACTIVE.

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

Recommended next steps

• Submit a job to your updated queue.