Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS Colas PCS
<a name="working-with_queues"></a>

Una cola de AWS PCS es una abstracción ligera de la implementación nativa de una cola de trabajos por parte del programador. En el caso de Slurm, una cola AWS PCS equivale a una partición Slurm. 

 Los usuarios envían los trabajos a una cola en la que residen hasta que puedan programarse para que se ejecuten en los nodos proporcionados por uno o más grupos de nodos de procesamiento. Un clúster de AWS PCS puede tener varias colas de trabajos. Por ejemplo, puede crear una cola que utilice Amazon EC2 On-Demand Instances para los trabajos de alta prioridad y otra cola que utilice Amazon EC2 Spot Instances para los trabajos de baja prioridad. 

**Topics**
+ [Creación de una cola en PCS AWS](working-with_queues_create.md)
+ [Actualización de una cola de AWS PCS](working-with_queues_update.md)
+ [Eliminar una cola en PCS AWS](working-with_queues_delete.md)

# Creación de una cola en PCS AWS
<a name="working-with_queues_create"></a>

En este tema se proporciona una visión general de las opciones disponibles y se describe lo que se debe tener en cuenta al crear una cola en AWS PCS.

**nota**  
Puede configurar los ajustes de Slurm personalizados en las colas para implementar políticas de programación específicas de las particiones y la administración de recursos. Para obtener más información, consulte [Configuración de ajustes de Slurm personalizados en PCS AWS](slurm-custom-settings.md).

## Requisitos previos
<a name="working-with_queues_create_prereq"></a>
+ Un clúster de AWS PCS: las colas solo se pueden crear en asociación con un clúster de PCS específico. AWS 
+ Uno o más grupos de nodos de cómputo de AWS PCS: una cola debe estar asociada a al menos un grupo de nodos de cómputo de AWS PCS.

## Para crear una cola en PCS AWS
<a name="working-with_queues_create_create"></a>

Puede crear una cola utilizando el Consola de administración de AWS o el. AWS CLI

------
#### [ Consola de administración de AWS ]

**Para crear una cola mediante la consola**

1. Abra la [consola AWS PCS.](https://console.aws.amazon.com/pcs/home#/clusters)

1. Seleccione el clúster para la cola. Navegue hasta **Colas y elija **Crear** cola**.

1. En la sección de **configuración de colas**, proporciona los siguientes valores:

   1. Nombre de la **cola: nombre** de la cola. El nombre solo puede contener caracteres alfanuméricos (con distinción de mayúsculas y minúsculas) y guiones. Debe empezar por un carácter alfabético y no puede tener más de 25 caracteres. El nombre debe ser único en el clúster.

   1. **Grupos de nodos de cómputo**: seleccione uno o más grupos de nodos de cómputo para dar servicio a esta cola. Un grupo de nodos de cómputo se puede asociar a más de una cola.

1. (Opcional) En la sección **Configuración adicional del programador**, puede añadir pares de nombre y valor del parámetro para configurar ajustes adicionales de Slurm. Para obtener una lista completa de los parámetros compatibles, consulte. [Configuración de Slurm personalizada para colas de PCS AWS](slurm-custom-settings-queue.md)

1. (Opcional) En **Etiquetas**, añada cualquier etiqueta a su cola de AWS PCS

1. Elige **Crear cola**. El campo **Estado** mostrará la opción **Crear** mientras AWS PCS crea la cola. La creación de la cola puede tardar varios minutos. 

**Siguiente paso recomendado**
+ Envía un trabajo a tu nueva lista.

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

**Para crear una cola mediante AWS CLI**

Utilice el siguiente comando para crear la cola. Realice las siguientes sustituciones:

1. Reemplace *region-code* por la AWS región del clúster. Por ejemplo, `us-east-1`.

1. *my-queue*Sustitúyalo por el nombre de la cola. El nombre solo puede contener caracteres alfanuméricos (con distinción de mayúsculas y minúsculas) y guiones. Debe empezar por un carácter alfabético y no puede tener más de 25 caracteres. El nombre debe ser único en el clúster.

1. *my-cluster*Sustitúyalo por el nombre o el ID del clúster.

1. *compute-node-group-id*Sustitúyalo por el ID del grupo de nodos de procesamiento para dar servicio a la cola. Por ejemplo, `pcs_abcdef12345`. 
**nota**  
Al crear una cola, debe proporcionar el ID del grupo de nodos de procesamiento y no su nombre.

```
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 — Crear una cola con una configuración de Slurm personalizada**  

```
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}]'
```
Para obtener más información, consulte [Configuración de Slurm personalizada para colas de PCS AWS](slurm-custom-settings-queue.md).

La creación de la cola puede tardar varios minutos. Puede consultar el estado de la cola con el siguiente comando. No podrá enviar trabajos a la cola hasta que alcance su estado. `ACTIVE`

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

**Siguiente paso recomendado**
+ Envía un trabajo a tu nueva lista

------

# Actualización de una cola de AWS PCS
<a name="working-with_queues_update"></a>

En este tema se proporciona una visión general de las opciones disponibles y se describe lo que se debe tener en cuenta al actualizar una cola de AWS PCS. Para obtener información sobre la configuración personalizada de Slurm, consulte. [Configuración de Slurm personalizada para colas de PCS AWS](slurm-custom-settings-queue.md)

## Consideraciones a la hora de actualizar una cola de PCS AWS
<a name="working-with_queues_update_considerations"></a>

Las actualizaciones de las colas no afectarán a los trabajos en ejecución, pero es posible que el clúster no pueda aceptar nuevos trabajos mientras se actualiza la cola.

## Para actualizar una cola de PCS AWS
<a name="working-with_queues_update_update"></a>

Puede usar Consola de administración de AWS o AWS CLI para actualizar una cola.

------
#### [ Consola de administración de AWS ]

**Para actualizar una cola**

1. Abra la consola AWS PCS en `https://console.aws.amazon.com/pcs/home#/clusters`

1. Seleccione el clúster en el que desee actualizar una cola.

1. **Ve a **Colas**, ve a la cola que deseas actualizar y, a continuación, selecciona Editar.**

1. En la sección de configuración de colas, actualiza cualquiera de los siguientes valores:
   +  **Grupos de nodos**: agregue o elimine grupos de nodos de cómputo de la asociación con la cola. 
   +  **Configuración adicional del programador**: añada, modifique o elimine la configuración de Slurm personalizada para la cola. Para obtener más información, consulte [Configuración de Slurm personalizada para colas de PCS AWS](slurm-custom-settings-queue.md). 
   +  **Etiquetas**: agrega o elimina etiquetas para la cola. 

1. Elija **Actualizar**. El campo **Estado** mostrará la *actualización* mientras se aplican los cambios.
**importante**  
Las actualizaciones de las colas pueden tardar varios minutos.

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

**Para actualizar una cola**

1. Actualice la cola con el siguiente comando. Antes de ejecutar el comando, realice los siguientes reemplazos:

   1. *region-code*Sustitúyala por la Región de AWS que deseas crear tu clúster.

   1. *my-queue*Sustitúyalo por el nombre o `computeNodeGroupId` por el de tu cola.

   1. *my-cluster*Sustitúyalo por el nombre o `clusterId` el de tu clúster.

   1.  Para cambiar las asociaciones de grupos de nodos de procesamiento, proporciona una lista actualizada de`--compute-node-group-configurations`. 

      1.  Por ejemplo, para añadir un segundo grupo de nodos de procesamiento`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 — Actualizar una cola con una configuración de Slurm personalizada**  

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

   Para obtener más información, consulte [Configuración de Slurm personalizada para colas de PCS AWS](slurm-custom-settings-queue.md).

1. La actualización de la cola puede tardar varios minutos. Puede consultar el estado de la cola con el siguiente comando. No podrá enviar trabajos a la cola hasta que alcance su estado. `ACTIVE`

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

------

**Próximos pasos recomendados**
+ Envía un trabajo a tu lista actualizada.

# Eliminar una cola en PCS AWS
<a name="working-with_queues_delete"></a>

En este tema se proporciona una descripción general de cómo eliminar una cola en AWS PCS.

## Consideraciones a la hora de eliminar una cola
<a name="working-with_queues_delete_considerations"></a>
+  Si hay trabajos en ejecución en la cola, el programador los finalizará cuando se elimine la cola. Los trabajos pendientes de la cola se cancelarán. Considere la posibilidad de esperar a que terminen los trabajos de la cola o de forma manual mediante stop/cancel los comandos nativos del programador (como `scancel` los de Slurm). 

## Eliminación de la cola
<a name="working-with_queues_delete_methods"></a>

Puede usar Consola de administración de AWS o AWS CLI para eliminar una cola.

------
#### [ Consola de administración de AWS ]

**Para eliminar una cola**

1. Abra la [consola AWS PCS.](https://console.aws.amazon.com/pcs/home#/clusters)

1. Seleccione el grupo de la cola.

1. Navegue hasta **Colas** y seleccione la cola que desee eliminar.

1. Elija **Eliminar**.

1. Aparece el campo **Estado**. `Deleting` Puede tardar varios minutos en completarse.

**nota**  
Puede usar los comandos nativos de su programador para confirmar que la cola se ha eliminado. Por ejemplo, usa `sinfo` o `squeue` para Slurm. 

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

**Para eliminar una cola**
+  Utilice el siguiente comando para eliminar una cola, con estas sustituciones: 
  +  *region-code*Sustitúyala por la que se encuentra Región de AWS tu clúster.
  +  *my-queue*Sustitúyalo por el nombre o el ID de la cola. 
  +  *my-cluster*Sustitúyalo por el nombre o el ID de tu clúster. 

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

   Eliminar la cola puede tardar varios minutos.
**nota**  
Puede usar los comandos nativos de su programador para confirmar que la cola se ha eliminado. Por ejemplo, usa `sinfo` o `squeue` para Slurm. 

------