

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

# Seção `LoginNodes`
<a name="LoginNodes-v3"></a>

**nota**  
Support `LoginNodes` for adicionado na AWS ParallelCluster versão 3.7.0.

**(Opcional)** Especifica a configuração do grupo de nós de login.

```
LoginNodes:
  Pools:
    - Name: string
      Count: integer
      InstanceType: string
      GracetimePeriod: integer
      Image:
        CustomAmi: string
      Ssh:
        KeyName: string
        AllowedIps: string
      Networking:
        SubnetIds:
          - string
        SecurityGroups:
          - string
        AdditionalSecurityGroups:
          - string
      Dcv:
        Enabled: boolean
        Port: integer
        AllowedIps: string
      CustomActions:
        OnNodeStart:
          Sequence:
            - Script: string
              Args:
                - string
          Script: string
          Args:
            - string
        OnNodeConfigured:
          Sequence:
            - Script: string
              Args:
                - string
          Script: string
          Args:
            - string
        OnNodeUpdated:
          Sequence:
            - Script: string
              Args:
                - string
          Script: string
          Args:
            - string
      Iam:
        InstanceRole: string
        InstanceProfile: string
        AdditionalIamPolicies:
          - Policy: string
```

[Política de atualização: os nós de login no cluster devem ser interrompidos para que esta configuração seja alterada para uma atualização.](using-pcluster-update-cluster-v3.md#update-policy-update-login-node-cluster)

## Propriedades do `LoginNodes`
<a name="LoginNodes-v3.properties"></a>

### Propriedades do `Pools`
<a name="LoginNodes-v3-Pools"></a>

Define grupos de nós de login que têm a mesma configuração de recursos. A partir da AWS ParallelCluster versão 3.11.0, até 10 pools podem ser especificados.

```
Pools:
  - Name: string
    Count: integer
    InstanceType: string
    GracetimePeriod: integer
    Image:
      CustomAmi: string
    Ssh:
      KeyName: string
      AllowedIps: string
    Networking:
      SubnetIds:
        - string
      SecurityGroups:
        - string
      AdditionalSecurityGroups:
        - string
    Dcv:
      Enabled: boolean
      Port: integer
      AllowedIps: string
    CustomActions:
      OnNodeStart:
        Sequence:
          - Script: string
            Args:
              - string
        Script: string
        Args:
          - string
      OnNodeConfigured:
        Sequence:
          - Script: string
            Args:
              - string
        Script: string
        Args:
          - string
      OnNodeUpdated:
        Sequence:
          - Script: string
            Args:
              - string
        Script: string
        Args:
          - string
    Iam:
      InstanceRole: string
      InstanceProfile: string
      AdditionalIamPolicies:
        - Policy: string
```

[Política de atualização: grupos de nós de login podem ser adicionados, mas a remoção de um grupo exige que todos os nós de login no cluster sejam interrompidos.](using-pcluster-update-cluster-v3.md#update-policy-add-login-node-pools)

`Name` (**Obrigatório** `String`)  
Especifica o nome do grupo `LoginNodes`. Isso é usado para marcar os recursos `LoginNodes`.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)   
A partir da AWS ParallelCluster versão 3.11.0, a política de atualização é: Os nós de login no pool devem ser interrompidos para que essa configuração seja alterada para uma atualização.

`Count` (**Obrigatório** `Integer`)  
Especifica o número de nós de login que devem ser mantidos ativos.  
[Política de atualização: essa configuração pode ser alterada durante uma atualização.](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`InstanceType` (**Obrigatório** `String`)  
Especifica o tipo de instância do Amazon EC2 que é usado para o nó de login. A arquitetura do tipo de instância deve ser a mesma usada para a configuração `InstanceType` do Slurm.   
[Política de atualização](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3): essa configuração pode ser alterada se o grupo de nós de login for interrompido.  
A partir da AWS ParallelCluster versão 3.11.0, a política de atualização é: Os nós de login no pool devem ser interrompidos para que essa configuração seja alterada para uma atualização.

`GracetimePeriod` (`Integer` **Opcional**)  
Especifica o tempo mínimo em minutos decorrido entre a notificação ao usuário conectado de que um nó de login deve ser desativado e o evento de parada real. Os valores válidos para `GracetimePeriod` são de 3 a 120 minutos. O padrão é 10 minutos.  
O evento acionador envolve interações entre vários AWS serviços. Às vezes, a latência da rede e a propagação das informações podem levar algum tempo, então o período de carência pode demorar mais do que o esperado devido a atrasos internos nos serviços. AWS 
[Política de atualização: essa configuração pode ser alterada durante uma atualização.](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`Image` (**opcional**)  
Define a configuração da imagem para os nós de login.  

```
Image:
  CustomAmi: String
```  
`CustomAmi` (**Opcional** `String`)  
Especifica a AMI personalizada usada para provisionar os nós de login. Se não for especificado, o valor padrão é o especificado no [Seção `HeadNode`](HeadNode-v3.md).  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`Ssh` (**opcional**)  
Define a configuração da `ssh` para os nós de login.  

```
Ssh:
  KeyName: string
  AllowedIps: string
```
A partir da AWS ParallelCluster versão 3.11.0, a política de atualização é: Os nós de login no pool devem ser interrompidos para que essa configuração seja alterada para uma atualização.  
`KeyName` (`String` **Opcional**)  
Especifica a chave `ssh` usada para fazer login nos nós de login. Se não for especificado, o valor padrão é o especificado no [Seção `HeadNode`](HeadNode-v3.md).  
[Política de atualização: grupos de nós de login devem ser interrompidos para que esta configuração seja alterada para uma atualização.](using-pcluster-update-cluster-v3.md#update-policy-update-login-node-pools)  
Obsoleto — O parâmetro de configuração `LoginNodes/Pools/Ssh/KeyName` foi descontinuado e será removido em futuras versões. A CLI agora retorna uma mensagem de aviso quando é usada na configuração do cluster. Consulte [ https://github.com/aws/aws-parallelcluster/issues/6811](https://github.com/aws/aws-parallelcluster/issues/6811) para obter detalhes.  
`AllowedIps` (**Opcional** `String`)  
Especifica o intervalo de IP em formato CIDR ou um ID de lista de prefixos para conexões SSH com nós de login no grupo. O padrão é o [AllowedIps](HeadNode-v3.md#yaml-HeadNode-Ssh-AllowedIps)definido na configuração do nó principal ou, `0.0.0.0/0` se não for especificado. [Seção `HeadNode`](HeadNode-v3.md).  
[Política de atualização: grupos de nós de login devem ser interrompidos para que esta configuração seja alterada para uma atualização.](using-pcluster-update-cluster-v3.md#update-policy-update-login-node-pools)  
Support AllowedIps para nós de login foi adicionado na AWS ParallelCluster versão 3.11.0.

`Networking`(**Obrigatório**)  
  

```
Networking:
  SubnetIds:
    - string
  SecurityGroups:
    - string
  AdditionalSecurityGroups:
    - string
```
A partir da AWS ParallelCluster versão 3.11.0, a política de atualização é: Os nós de login no pool devem ser interrompidos para que essa configuração seja alterada para uma atualização.  
`SubnetIds` (**Obrigatório** `[String]`)  
O ID da sub-rede existente na qual você provisiona o grupo de nós de login. Você pode definir apenas uma sub-rede.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`SecurityGroups` (**Opcional** `[String]`)  
Uma lista de grupos de segurança para usar no grupo de nós de login. Se nenhum grupo de segurança for especificado, AWS ParallelCluster cria grupos de segurança para você.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`AdditionalSecurityGroups` (**Opcional** `[String]`)  
Uma lista adicional de grupos de segurança para usar no grupo de nós de login.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`Dcv` (**opcional**)  
Define as configurações do servidor NICE DCV que é executado nos nós de [login](#LoginNodes-v3). Para obter mais informações, consulte [Conectar-se aos nós principais e de login por meio do Amazon DCV](dcv-v3.md).  

```
Dcv:
  Enabled: boolean
  Port: integer
  AllowedIps: string
```
Por padrão, a porta NICE DCV configurada por AWS ParallelCluster está aberta a todos os IPv4 endereços. Você poderá se conectar a uma porta NICE DCV somente se tiver o URL para a sessão NICE DCV e se conectar à sessão NICE DCV dentro de 30 segundos após o URL retornar do pcluster dcv-connect. Use a configuração `AllowedIps` para restringir ainda mais o acesso à porta NICE DCV com um intervalo de IP formatado em CIDR e use a configuração Port para definir uma porta não padrão.
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
Support for DCV em nós de login foi adicionado na AWS ParallelCluster versão 3.11.0.  
`Enabled` (**Obrigatório** `Boolean`)  
Especifica se o NICE DCV está habilitado nos nós de login no grupo. O valor padrão é `false`.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
O NICE DCV gera automaticamente um certificado autoassinado que é usado para proteger o tráfego entre o cliente NICE DCV e o servidor NICE DCV executado no nó de login. Para configurar seu próprio certificado, consulte [Certificado HTTPS do Amazon DCV](dcv-v3.md#dcv-v3-certificate).  
`Port` (**Opcional** `Integer`)  
Especifica a porta para o NICE DCV. O valor padrão é `8443`.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`AllowedIps` (**Opcional** `String`)  
Especifica o intervalo de IP formatado em CIDR para conexões com o NICE DCV. Essa configuração é usada somente ao AWS ParallelCluster criar o grupo de segurança. O valor padrão é `0.0.0.0/0`, que permite acesso de qualquer endereço da internet.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`CustomActions` (**opcional**)  
Especifica os scripts personalizados a serem executados nos nós de login.  

```
CustomActions:
  OnNodeStart:
    Sequence:
      - Script: string
        Args: 
          - string
    Script: string
    Args:
      - string
  OnNodeConfigured:
    Sequence:
      - Script: string
        Args:
          - string
    Script: string
    Args:
      - string
  OnNodeUpdated:
    Sequence:
      - Script: string
        Args:
          - string
    Script: string
    Args:
      - string
```
Support para ações personalizadas em nós de login foi adicionado na AWS ParallelCluster versão 3.11.0.  
`OnNodeStart` (**opcional**)  
Especifica um único script ou uma sequência de scripts para serem executados nos [nós de login](#LoginNodes-v3) antes de qualquer ação de inicialização de implantação de nó. Para obter mais informações, consulte [Ações de bootstrap personalizadas](custom-bootstrap-actions-v3.md).    
`Sequence` (**opcional**)  
Lista de scripts a serem executados. AWS ParallelCluster executa os scripts na mesma ordem em que estão listados no arquivo de configuração, começando com o primeiro.    
`Script` (**Obrigatório** `String`)  
Especifica o arquivo a ser usado. O caminho do arquivo pode começar com `https://` ou `s3://`.  
`Args` (**Opcional** `[String]`)  
Lista de argumentos a serem transmitidos para o script.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`Script` (**Obrigatório** `String`)  
Especifica o arquivo a ser usado para um único script. O caminho do arquivo pode começar com `https://` ou `s3://`.  
`Args` (**Opcional** `[String]`)  
Lista de argumentos a serem transmitidos para o script.  
`OnNodeConfigured` (**opcional**)  
Especifica um único script ou uma sequência de scripts a serem executados nos [nós de login](#LoginNodes-v3) após a conclusão dos processos de inicialização do nó. Para obter mais informações, consulte [Ações de bootstrap personalizadas](custom-bootstrap-actions-v3.md).    
`Sequence` (**opcional**)  
Lista de scripts a serem executados. AWS ParallelCluster executa os scripts na mesma ordem em que estão listados no arquivo de configuração, começando com o primeiro.    
`Script` (**Obrigatório** `String`)  
Especifica o arquivo a ser usado. O caminho do arquivo pode começar com `https://` ou `s3://`.  
`Args` (**Opcional** `[String]`)  
Lista de argumentos a serem transmitidos para o script.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`Script` (**Obrigatório** `String`)  
Especifica o arquivo a ser usado para um único script. O caminho do arquivo pode começar com `https://` ou `s3://`.  
`Args` (**Opcional** `[String]`)  
Lista de argumentos a serem transmitidos para o script.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`OnNodeUpdated` (**opcional**)  
Especifica um único script ou uma sequência de scripts a serem executados após a conclusão da atualização do nó principal e o agendador e o armazenamento compartilhado estarem alinhados com as alterações mais recentes na configuração do cluster. Para obter mais informações, consulte [Ações de bootstrap personalizadas](custom-bootstrap-actions-v3.md).    
`Sequence` (**opcional**)  
Lista de scripts a serem executados. AWS ParallelCluster executa os scripts na mesma ordem em que estão listados no arquivo de configuração, começando com o primeiro.    
`Script` (**Obrigatório** `String`)  
Especifica o arquivo a ser usado. O caminho do arquivo pode começar com `https://` ou `s3://`.  
`Args` (**Opcional** `[String]`)  
Lista de argumentos a serem transmitidos para o script.  
`Script` (**Obrigatório** `String`)  
Especifica o arquivo a ser usado para um único script. O caminho do arquivo pode começar com `https://` ou `s3://`.  
`Args` (**Opcional** `[String]`)  
Lista de argumentos a serem transmitidos para o script.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
AWS ParallelCluster não suporta a inclusão de um único script e `Sequence` da mesma ação personalizada.

`Iam` (**opcional**)  
Especifica uma função de instância ou um perfil de instância a ser usado nos nós de login para substituir a função de instância padrão ou o perfil de instância do cluster.  

```
Iam:
  InstanceRole: string
  InstanceProfile: string
  AdditionalIamPolicies:
    - Policy: string
```
A partir da AWS ParallelCluster versão 3.11.0, a política de atualização é: Os nós de login no pool devem ser interrompidos para que essa configuração seja alterada para uma atualização.  
`InstanceProfile` (`String` **Opcional**)  
Especifica um perfil de instância para substituir o perfil padrão da instância do nó de login. Não é possível especificar ambos `InstanceProfile` e `InstanceRole`. O formato é `arn:Partition:iam::Account:instance-profile/InstanceProfileName`. Se isso for especificado, as configurações `InstanceRole` e `AdditionalIamPolicies` não poderão ser especificadas.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`InstanceRole` (**Opcional** `String`)  
Especifica uma função de instância para substituir o a função padrão da instância do nó de login. Não é possível especificar ambos `InstanceProfile` e `InstanceRole`. O formato é `arn:Partition:iam::Account:role/RoleName`. Se isso for especificado, as configurações `InstanceProfile` e `AdditionalIamPolicies` não poderão ser especificadas.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)  
`AdditionalIamPolicies` (**opcional**)  

```
AdditionalIamPolicies:
  - Policy: string
```
Um nome do recurso da Amazon (ARN) da política do IAM.  
Especifica uma lista de nomes de recursos da Amazon (ARNs) de políticas do IAM para o Amazon EC2. Essa lista é anexada à função raiz usada para o nó de login, além das permissões exigidas pelo AWS ParallelCluster.  
O nome da política do IAM e seu ARN são diferentes. Os nomes não podem ser usados.  
Se isso for especificado, as configurações `InstanceProfile` e `InstanceRole` não poderão ser especificadas. Recomendamos que você use `AdditionalIamPolicies` porque `AdditionalIamPolicies` são adicionados às permissões necessárias e `InstanceRole` devem incluir todas as permissões necessárias. AWS ParallelCluster As permissões necessárias muitas vezes são alteradas entre as versões à medida que recursos são adicionados.  
Não há valor padrão.  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)    
`Policy` (**Obrigatório** `[String]`)  
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)