As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS Filas PCS
Uma fila AWS PCS é uma abstração leve sobre a implementação nativa de uma fila de trabalho do agendador. No caso do Slurm, uma fila AWS PCS é equivalente a uma partição do Slurm.
Os usuários enviam trabalhos para uma fila onde residem até que possam ser programados para execução em nós fornecidos por um ou mais grupos de nós de computação. Um cluster AWS PCS pode ter várias filas de trabalhos. Por exemplo, você pode criar uma fila que usa Amazon EC2 On-demand Instances para trabalhos de alta prioridade e outra fila que usa Amazon EC2 Spot Instances para trabalhos de baixa prioridade.
**Topics**
+ [
# Criando uma fila no AWS PCS
](working-with_queues_create.md)
+ [
# Atualizando uma fila AWS PCS
](working-with_queues_update.md)
+ [
# Excluindo uma fila no PCS AWS
](working-with_queues_delete.md)
# Criando uma fila no AWS PCS
Este tópico fornece uma visão geral das opções disponíveis e descreve o que considerar ao criar uma fila no AWS PCS.
**nota**
Você pode definir configurações personalizadas do Slurm em filas para implementar políticas de agendamento e gerenciamento de recursos específicos da partição. Para obter mais informações, consulte [Definindo configurações personalizadas do Slurm no PCS AWS](slurm-custom-settings.md).
## Pré-requisitos
+ Um cluster AWS PCS - as filas só podem ser criadas em associação com um cluster AWS PCS específico.
+ Um ou mais grupos de nós de computação AWS PCS — uma fila deve estar associada a pelo menos um grupo de nós de computação AWS PCS.
## Para criar uma fila no AWS PCS
Você pode criar uma fila usando o Console de gerenciamento da AWS ou o. AWS CLI
------
#### [ Console de gerenciamento da AWS ]
**Para criar uma fila usando o console**
1. Abra o [console AWS PCS](https://console.aws.amazon.com/pcs/home#/clusters).
1. Selecione o cluster para a fila. Navegue até **Filas** e escolha **Criar fila**.
1. Na seção **Configuração da fila**, forneça os seguintes valores:
1. **Nome da fila** — Um nome para sua fila. O nome só pode conter caracteres alfanuméricos (sensíveis a maiúsculas e minúsculas) e hifens. Ele deve começar com um caractere alfabético e não pode ter mais de 25 caracteres. O nome deve ser exclusivo dentro do cluster.
1. **Grupos de nós de computação** — Selecione 1 ou mais grupos de nós de computação para atender a essa fila. Um grupo de nós de computação pode ser associado a mais de uma fila.
1. (Opcional) Na seção **Configurações adicionais do agendador**, você pode adicionar pares de nome e valor do parâmetro para definir configurações adicionais do Slurm. Para obter uma lista completa dos parâmetros compatíveis, consulte[Configurações personalizadas do Slurm para AWS filas PCS](slurm-custom-settings-queue.md).
1. (Opcional) Em **Tags**, adicione quaisquer tags à sua fila AWS PCS
1. Selecione **Criar fila**. O campo **Status** mostrará **Criando** enquanto o AWS PCS cria a fila. A criação da fila pode levar vários minutos.
**Próxima etapa recomendada**
+ Envie um trabalho para sua nova fila.
------
#### [ AWS CLI ]
**Para criar uma fila usando AWS CLI**
Use o comando a seguir para criar sua fila. Faça as seguintes substituições:
1. *region-code*Substitua pela AWS região do cluster. Por exemplo, .`us-east-1`
1. *my-queue*Substitua pelo nome da sua fila. O nome só pode conter caracteres alfanuméricos (sensíveis a maiúsculas e minúsculas) e hifens. Ele deve começar com um caractere alfabético e não pode ter mais de 25 caracteres. O nome deve ser exclusivo dentro do cluster.
1. *my-cluster*Substitua pelo nome ou ID do seu cluster.
1. *compute-node-group-id*Substitua pela ID do grupo de nós de computação para atender a fila. Por exemplo, .`pcs_abcdef12345`
**nota**
Ao criar uma fila, você deve fornecer a ID do grupo de nós de computação e não seu nome.
```
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 — Criação de uma fila com configurações personalizadas do 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}]'
```
Para obter mais informações, consulte [Configurações personalizadas do Slurm para AWS filas PCS](slurm-custom-settings-queue.md).
A criação da fila pode levar alguns minutos. Você pode consultar o status da sua fila com o comando a seguir. Você não poderá enviar trabalhos para a fila até que seu status chegue`ACTIVE`.
```
aws pcs get-queue --region region-code \
--cluster-identifier my-cluster \
--queue-identifier my-queue
```
**Próxima etapa recomendada**
+ Envie um trabalho para sua nova fila
------
# Atualizando uma fila AWS PCS
Este tópico fornece uma visão geral das opções disponíveis e descreve o que considerar ao atualizar uma fila AWS PCS. Para obter informações sobre as configurações personalizadas do Slurm, consulte. [Configurações personalizadas do Slurm para AWS filas PCS](slurm-custom-settings-queue.md)
## Considerações ao atualizar uma fila AWS PCS
As atualizações da fila não afetarão os trabalhos em execução, mas o cluster pode não conseguir aceitar novos trabalhos enquanto a fila estiver sendo atualizada.
## Para atualizar uma fila AWS PCS
Você pode usar o Console de gerenciamento da AWS ou AWS CLI para atualizar uma fila.
------
#### [ Console de gerenciamento da AWS ]
**Para atualizar uma fila**
1. Abra o console AWS PCS em `https://console.aws.amazon.com/pcs/home#/clusters`
1. Selecione o cluster em que você deseja atualizar uma fila.
1. **Navegue até **Filas**, vá até a fila que deseja atualizar e selecione Editar.**
1. Na seção de configuração da fila, atualize qualquer um dos seguintes valores:
+ **Grupos de nós** — adicione ou remova grupos de nós de computação da associação com a fila.
+ **Configurações adicionais do agendador** — Adicione, modifique ou remova configurações personalizadas do Slurm para a fila. Para obter mais informações, consulte [Configurações personalizadas do Slurm para AWS filas PCS](slurm-custom-settings-queue.md).
+ **Tags** — Adicione ou remova tags da fila.
1. Selecione **Atualizar**. O campo **Status** mostrará *Atualizando* enquanto as alterações estão sendo aplicadas.
**Importante**
As atualizações da fila podem levar vários minutos.
------
#### [ AWS CLI ]
**Para atualizar uma fila**
1. Atualize sua fila com o comando a seguir. Antes da execução do comando, realize as seguintes substituições:
1. *region-code*Substitua por Região da AWS aquela em que você deseja criar seu cluster.
1. *my-queue*Substitua pelo nome ou `computeNodeGroupId` pela sua fila.
1. *my-cluster*Substitua pelo nome ou pelo nome `clusterId` do seu cluster.
1. Para alterar as associações de grupos de nós de computação, forneça uma lista atualizada para`--compute-node-group-configurations`.
1. Por exemplo, para adicionar um segundo grupo `computeNodeGroupExampleID2` de nós de computação:
```
--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 — Atualizar uma fila com configurações personalizadas do Slurm**
```
aws pcs update-queue --region region-code \
--queue-identifier my-queue \
--cluster-identifier my-cluster \
--slurm-configuration \
'slurmCustomSettings=[{parameterName=Default,parameterValue=YES}]'
```
Para obter mais informações, consulte [Configurações personalizadas do Slurm para AWS filas PCS](slurm-custom-settings-queue.md).
1. A atualização da fila pode levar alguns minutos. Você pode consultar o status da sua fila com o comando a seguir. Você não poderá enviar trabalhos para a fila até que seu status chegue`ACTIVE`.
```
aws pcs get-queue --region region-code \
--cluster-identifier my-cluster \
--queue-identifier my-queue
```
------
**Próximas etapas recomendadas**
+ Envie um trabalho para sua fila atualizada.
# Excluindo uma fila no PCS AWS
Este tópico fornece uma visão geral de como excluir uma fila no AWS PCS.
## Considerações ao excluir uma fila
+ Se houver trabalhos em execução na fila, eles serão encerrados pelo agendador quando a fila for excluída. Os trabalhos pendentes na fila serão cancelados. Considere esperar que os trabalhos na fila sejam concluídos ou manualmente usando stop/cancel os comandos nativos do agendador (como `scancel` para o Slurm).
## Excluir a fila
Você pode usar o Console de gerenciamento da AWS ou AWS CLI para excluir uma fila.
------
#### [ Console de gerenciamento da AWS ]
**Para excluir uma fila**
1. Abra o [console AWS PCS](https://console.aws.amazon.com/pcs/home#/clusters).
1. Selecione o cluster da fila.
1. Navegue até **Filas** e selecione a fila a ser excluída.
1. Escolha **Excluir**.
1. O campo **Status** é exibido`Deleting`. Pode demorar vários minutos para isso ser concluído.
**nota**
Você pode usar comandos nativos do seu agendador para confirmar que a fila foi excluída. Por exemplo, use `sinfo` ou `squeue` para o Slurm.
------
#### [ AWS CLI ]
**Para excluir uma fila**
+ Use o comando a seguir para excluir uma fila, com essas substituições:
+ *region-code*Substitua por aquele em que Região da AWS seu cluster está.
+ *my-queue*Substitua pelo nome ou ID da sua fila.
+ *my-cluster*Substitua pelo nome ou ID do seu cluster.
```
aws pcs delete-queue --region region-code \
--queue-identifier my-queue \
--cluster-identifier my-cluster
```
Pode levar alguns minutos para excluir a fila.
**nota**
Você pode usar comandos nativos do seu agendador para confirmar que a fila foi excluída. Por exemplo, use `sinfo` ou `squeue` para o Slurm.
------