Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# `[ebs]` Section
Définit les paramètres de configuration des volumes Amazon EBS pour les volumes montés sur le nœud principal et partagés avec les nœuds de calcul via NFS.
Pour savoir comment inclure les volumes Amazon EBS dans la définition de votre cluster, consultez``[cluster]` Section`/``ebs_settings``.
Pour utiliser un volume Amazon EBS existant pour un stockage permanent à long terme indépendant du cycle de vie du cluster, spécifiez[`ebs_volume_id`](#ebs-volume-id).
Si vous ne le spécifiez pas[`ebs_volume_id`](#ebs-volume-id), AWS ParallelCluster crée le volume EBS à partir des `[ebs]` paramètres lors de la création du cluster et supprime le volume et les données lorsque le cluster est supprimé.
Pour de plus amples informations, veuillez consulter [Bonnes pratiques : déplacement d'un cluster vers une nouvelle version AWS ParallelCluster mineure ou un correctif](best-practices.md#best-practices-cluster-upgrades).
Le format est`[ebs ebs-name]`. *ebs-name*doit commencer par une lettre, ne pas contenir plus de 30 caractères et contenir uniquement des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (\$1).
```
[ebs custom1]
shared_dir = vol1
ebs_snapshot_id = snap-xxxxx
volume_type = io1
volume_iops = 200
...
[ebs custom2]
shared_dir = vol2
...
...
```
**Topics**
+ [
## `shared_dir`
](#ebs-shared-dir)
+ [
## `ebs_kms_key_id`
](#ebs-kms-key-id)
+ [
## `ebs_snapshot_id`
](#ebs-snapshot-id)
+ [
## `ebs_volume_id`
](#ebs-volume-id)
+ [
## `encrypted`
](#encrypted)
+ [
## `volume_iops`
](#volume-iops)
+ [
## `volume_size`
](#volume-size)
+ [
## `volume_throughput`
](#volume-throughput)
+ [
## `volume_type`
](#volume-type)
## `shared_dir`
**(Obligatoire)** Spécifie le chemin où le volume Amazon EBS partagé est monté.
Ce paramètre est obligatoire lors de l'utilisation de plusieurs volumes Amazon EBS.
[Lorsque vous utilisez un volume Amazon EBS, cette option remplace le [`shared_dir`](cluster-definition.md#cluster-shared-dir) volume spécifié dans la `[cluster]` section.](cluster-definition.md) Dans l'exemple suivant, le volume est monté sur `/vol1`.
```
shared_dir = vol1
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `ebs_kms_key_id`
**(Facultatif)** Spécifie une AWS KMS clé personnalisée à utiliser pour le chiffrement.
Ce paramètre doit être utilisé en même temps que `encrypted = true`. Il doit aussi avoir un [`ec2_iam_role`](cluster-definition.md#ec2-iam-role) personnalisé.
Pour de plus amples informations, veuillez consulter [Chiffrement du disque avec une clé KMS personnalisée](tutorials_04_encrypted_kms_fs.md).
```
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `ebs_snapshot_id`
**(Facultatif)** Définit l'ID d'instantané Amazon EBS si vous utilisez un instantané comme source pour le volume.
Il n'existe aucune valeur par défaut.
```
ebs_snapshot_id = snap-xxxxx
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `ebs_volume_id`
**(Facultatif)** Définit l'ID de volume d'un volume Amazon EBS existant à associer au nœud principal.
Il n'existe aucune valeur par défaut.
```
ebs_volume_id = vol-xxxxxx
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `encrypted`
**(Facultatif)** Spécifie si le volume Amazon EBS est chiffré. Remarque : ne *pas* utiliser avec les instantanés.
La valeur par défaut est `false`.
```
encrypted = false
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `volume_iops`
**(Facultatif)** Définit le nombre d'IOPS pour `io1``io2`, et le `gp3` type de volumes.
La valeur par défaut, les valeurs prises en charge et `volume_iops` le `volume_size` ratio de production varient selon [`volume_type`](raid-section.md#raid-volume-type) et[`volume_size`](#volume-size).
`volume_type` = `io1`
Valeur par défaut `volume_iops` = 100
Valeurs prises en charge `volume_iops` = 100—64 000 †
`volume_size`Rapport `volume_iops` maximum = 50 IOPS pour chaque GiB. 5000 IOPS nécessitent au `volume_size` moins 100 GiB.
`volume_type` = `io2`
Valeur par défaut `volume_iops` = 100
Valeurs prises en charge `volume_iops` = 100 à 64 000 (256 000 pour les volumes `io2` Block Express) †
`volume_size`Rapport `volume_iops` maximum = 500 IOPS pour chaque GiB. 5000 IOPS nécessitent au `volume_size` moins 10 GiB.
`volume_type` = `gp3`
Valeur par défaut `volume_iops` = 3000
Valeurs prises en charge `volume_iops` = 3000 à 16 000
`volume_size`Rapport `volume_iops` maximum = 500 IOPS pour chaque GiB. 5000 IOPS nécessitent au `volume_size` moins 10 GiB.
```
volume_iops = 200
```
[Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.](using-pcluster-update.md#update-policy-setting-supported)
† Le maximum d'IOPS est garanti uniquement sur les [instances basées sur le système Nitro](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances) et approvisionnées avec plus de 32 000 IOPS. Les autres instances garantissent jusqu'à 32 000 IOPS. À moins que vous ne [modifiiez le volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html), `io1` les volumes antérieurs risquent de ne pas atteindre leurs performances optimales. `io2` Les volumes Block Express prennent en charge `volume_iops` des valeurs allant jusqu'à 256 000. Pour plus d'informations, consultez les [volumes `io2` Block Express (en version préliminaire)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express) dans le *guide de EC2 l'utilisateur Amazon*.
## `volume_size`
**(Facultatif)** Spécifie la taille du volume à créer, en GiB (si vous n'utilisez pas de capture instantanée).
La valeur par défaut et les valeurs prises en charge varient de[`volume_type`](#volume-type).
`volume_type` = `standard`
Par défaut `volume_size` = 20 GiB
Valeurs prises en charge `volume_size` = 1 à 1024 GiB
`volume_type`= `gp2``io1`,`io2`, et `gp3`
Par défaut `volume_size` = 20 GiB
Valeurs prises en charge `volume_size` = 1 à 16384 GiB
`volume_type`= `sc1` et `st1`
Par défaut `volume_size` = 500 GiB
Valeurs prises en charge `volume_size` = 500—16384 GiB
```
volume_size = 20
```
**Note**
Avant AWS ParallelCluster la version 2.10.1, la valeur par défaut pour tous les types de volumes était de 20 GiB.
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `volume_throughput`
**(Facultatif)** Définit le débit pour les types de `gp3` volumes, en Mbits/s.
La valeur par défaut est `125`.
Valeurs prises en charge `volume_throughput` = 125-1000 MiB/s
Le rapport de `volume_throughput` to ne `volume_iops` peut pas être supérieur à 0,25. Le débit maximal de 1 000 Mbits/s nécessite que le `volume_iops` paramètre soit d'au moins 4 000.
```
volume_throughput = 1000
```
**Note**
Support pour `volume_throughput` a été ajouté dans la AWS ParallelCluster version 2.10.1.
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `volume_type`
**(Facultatif)** Spécifie le [type de volume Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) que vous souhaitez lancer.
Les options valides sont les types de volumes suivants :
`gp2`, `gp3`
SSD à usage général
`io1`, `io2`
Provisioned IOPS SSD
`st1`
Disque dur à débit optimisé
`sc1`
HDD à froid
`standard`
Magnétique de génération précédente
Pour plus d'informations, consultez les [types de volumes Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) dans le *guide de l' EC2 utilisateur Amazon*.
La valeur par défaut est `gp2`.
```
volume_type = io2
```
**Note**
Support pour `gp3` et `io2` a été ajouté dans la AWS ParallelCluster version 2.10.1.
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)