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á.

# Configurar plug-ins de filtro CLI do Slurm em um cluster PCS AWS
<a name="slurm-cli-filter-plugins-configure"></a>

Configure os plug-ins de filtro CLI ao criar um novo cluster AWS PCS. Você pode ativar ou desativar os plug-ins de filtro CLI em clusters existentes usando a API de atualização ou o console sem recriar o cluster.

## Pré-requisitos
<a name="slurm-cli-filter-plugins-configure-prerequisites"></a>

Antes de configurar os plug-ins de filtro CLI, conclua estas tarefas:
+ Escreva e teste um script Lua que implemente a API CLI Filter Plugin
+ Nomeie seu script Lua com exatidão `cli_filter.lua`
+ Escolha um método para implantar seu script em todas as instâncias do cluster (AMI, S3 ou sistema de arquivos)
+ Verifique se você está usando o Slurm versão 24.11 ou posterior

## Ativar plug-ins de filtro CLI em um novo cluster
<a name="slurm-cli-filter-plugins-configure-create"></a>

------
#### [ AWS PCS console ]

1. Abra o console AWS PCS em [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/).

1. No painel de navegação, escolha **Clusters**.

1. Selecione **Criar cluster**.

1. Selecione uma versão válida do Slurm (versão 24.11 ou posterior).

1. Em **Configurações do agendador, expanda Configurações** **adicionais do agendador.**

1. Adicione uma nova configuração personalizada do Slurm com o **nome do parâmetro** definido como `CliFilterPlugins` e o **valor do parâmetro** definido como. `cli_filter/lua`

1. Conclua a configuração restante do cluster e escolha **Criar cluster**.

------
#### [ AWS PCS API ]

Forneça a `slurmCustomSettings` configuração em sua chamada para a ação `CreateCluster` da API. Defina `parameterName` para `CliFilterPlugins` e `parameterValue` para`cli_filter/lua`. Para obter mais informações, consulte [CreateCluster](https://docs.aws.amazon.com/pcs/latest/APIReference/API_CreateCluster.html)a *Referência da API AWS PCS*.

O exemplo a seguir usa o AWS CLI para chamar a ação `CreateCluster` da API. A configuração personalizada `CliFilterPlugins=cli_filter/lua` ativa os plug-ins de filtro CLI.

```
aws pcs create-cluster --cluster-name {{cluster-name}} \
--scheduler type=SLURM,version=24.11 \
--size SMALL \
--networking subnetIds={{cluster-subnet-id}},securityGroupIds={{cluster-security-group-id}} \
--slurm-configuration \
'slurmCustomSettings=[{parameterName=CliFilterPlugins,parameterValue="cli_filter/lua"}]'
```

------

## Implantar scripts de plug-in de filtro CLI
<a name="slurm-cli-filter-plugins-configure-deploy"></a>

**Para implantar scripts do CLI Filter Plugin em seu cluster**

1. Certifique-se de que todas as AMIs usadas em grupos de nós de computação tenham o Slurm instalado por meio do instalador do AWS PCS Slurm.
**nota**  
Se você usar o AWS PCS Sample AMI para todos os grupos de nós de computação, pule esta etapa. O Slurm já está instalado.

1. Implante seu `cli_filter.lua` script `/etc/aws/pcs/scheduler/slurm-<version>/cli_filter.lua` em todas as instâncias do cluster.

   Por exemplo, para a versão 24.11 do Slurm:

   ```
   /etc/aws/pcs/scheduler/slurm-24.11/cli_filter.lua
   ```

1. Inicie todos os nós de login e computação usando suas AMIs preparadas.

1. Teste o envio do trabalho para verificar se o plug-in de filtro CLI está sendo executado corretamente.

## Ativar ou desativar plug-ins de filtro CLI em clusters existentes
<a name="slurm-cli-filter-plugins-configure-update"></a>

Você pode ativar ou desativar os plug-ins de filtro CLI em clusters existentes sem reconstruir sua infraestrutura. Para obter mais informações, consulte [Atualizando um cluster no AWS PCS](working-with_clusters_update.md).

------
#### [ AWS PCS console ]

1. Abra o console AWS PCS em [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/).

1. No painel de navegação, escolha **Clusters**.

1. Selecione o cluster a ser atualizado.

1. Escolha **Editar ação**.

1. Na página Editar cluster, em **Configurações adicionais do agendador**:
   + Para habilitar os plug-ins de filtro CLI: adicione uma nova configuração personalizada do Slurm com o **nome do parâmetro** definido como `CliFilterPlugins` e o valor do **parâmetro** definido como. `cli_filter/lua`
   + Para desativar os plug-ins de filtro CLI: remova a configuração existente`CliFilterPlugins`.

1. Escolha **Atualizar cluster** para enviar as alterações.

1. Monitore o status do cluster, que aparece como “Atualizando” durante o processo e “Ativo” quando a atualização é concluída.

------
#### [ AWS PCS API ]

Use a ação da `UpdateCluster` API para ativar ou desativar os plug-ins de filtro CLI. Para obter mais informações, consulte [UpdateCluster](https://docs.aws.amazon.com/pcs/latest/APIReference/API_UpdateCluster.html)a *Referência da API AWS PCS*.

Para habilitar plug-ins de filtro CLI em um cluster existente:

```
aws pcs update-cluster --cluster-identifier {{my-cluster}} \
--slurm-configuration \
'slurmCustomSettings=[{parameterName=CliFilterPlugins,parameterValue="cli_filter/lua"}]'
```

Para desativar os plug-ins de filtro CLI em um cluster existente:

```
aws pcs update-cluster --cluster-identifier {{my-cluster}} \
--slurm-configuration \
'slurmCustomSettings=[]'
```

------

## Resultados esperados
<a name="slurm-cli-filter-plugin-configure-results"></a>

Depois de concluir a configuração:
+ Seu cluster é criado com o CLI Filter Plugin ativado
+ Os envios de trabalhos acionam sua lógica de validação personalizada antes de chegar ao controlador Slurm
+ Non-compliant os trabalhos são rejeitados com suas mensagens de erro personalizadas
+ Os trabalhos compatíveis prosseguem normalmente por meio do agendador Slurm

## Solução de problemas
<a name="slurm-cli-filter-plugin-configure-troubleshooting"></a>

**Falta o script do plug-in de filtro CLI em qualquer nó**  
**Sintomas:** O envio do trabalho falha imediatamente com erro de carregamento do plug-in.  
**Causa provável:** script não implantado em todas as instâncias ou nome ou caminho de arquivo incorreto.  
**Resolução:** verifique se o script existe no caminho correto em todos os nós de login e computação com o nome de arquivo `cli_filter.lua` exato.

**Configuração inválida do plug-in de filtro CLI**  
**Sintomas:** falha na criação do cluster com erro de validação.  
**Causa provável:** `CliFilterPlugins` parâmetro não definido para `cli_filter/lua` formatar.  
**Resolução:** Use o valor exato do parâmetro `cli_filter/lua` em`slurmCustomSettings`.