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.
# Stockage permanent pour les flottes gérées par des services
AWS Le stockage persistant de Deadline Cloud (Deadline Cloud) associe des volumes gp3 Amazon Elastic Block Store (Amazon EBS) dédiés aux employés de flotte gérés par des services. Ces volumes préservent les données telles que les installations de packages Conda, les caches d'applications et les espaces de travail de contrôle de version lors des événements du cycle de vie des travailleurs. Pour une présentation conceptuelle, consultez la section [Stockage permanent pour les flottes gérées par des services](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/volumes.html) dans le guide de l'utilisateur de *AWS Deadline Cloud*.
## Fleet configuration (Configuration de la flotte)
Pour activer le stockage permanent, incluez l'`persistentVolumeConfiguration`objet dans le fichier « `serviceManagedEc2FleetConfiguration` when you call `CreateFleet` or `UpdateFleet` ».
### Paramètres de configuration
L'`persistentVolumeConfiguration`objet accepte les paramètres suivants. Pour les plages valides et les valeurs par défaut, consultez [CreateFleet](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateFleet.html)la *référence de l'API Deadline Cloud*.
| Paramètre | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| sizeGiB | Entier | Non | Taille du volume persistant en GiB. |
| iops | Entier | Non | Les IOPS provisionnées pour le volume gp3. |
| throughputMiB | Entier | Non | Le débit provisionné MiB/s pour le volume gp3. |
| mountPath | String | Oui | Emplacement du montage sur le travailleur. PourLinux, spécifiez un chemin absolu (par exemple,/mnt/persistent). PourWindows, spécifiez une lettre de lecteur (par exemple,D:). |
| lastUsedTtlHours | Entier | Non | Nombre d'heures après la dernière utilisation d'un volume avant le nettoyage automatique. |
### Créez une flotte avec un stockage persistant
L' AWS CLI exemple suivant crée un parc géré par des services avec le stockage persistant activé :
```
aws deadline create-fleet \
--farm-id {{farm-0123456789abcdef0}} \
--display-name "Rendering Fleet" \
--max-worker-count 20 \
--configuration '{
"serviceManagedEc2FleetConfiguration": {
"instanceCapabilities": {
"vCpuCount": {"min": 4, "max": 16},
"memoryMiB": {"min": 16384, "max": 65536},
"osFamily": "LINUX",
"rootEbsVolume": {"sizeGiB": 250}
},
"instanceMarketOptions": {"type": "spot"},
"persistentVolumeConfiguration": {
"sizeGiB": 2048,
"iops": 16000,
"throughputMiB": 500,
"mountPath": "/mnt/persistent",
"lastUsedTtlHours": 168
}
}
}'
```
### Mettre à jour la configuration du stockage persistant
L' AWS CLI exemple suivant ajoute un stockage persistant à un parc existant :
```
aws deadline update-fleet \
--farm-id {{farm-0123456789abcdef0}} \
--fleet-id {{fleet-0123456789abcdef0}} \
--configuration '{
"serviceManagedEc2FleetConfiguration": {
"instanceCapabilities": {
"vCpuCount": {"min": 4, "max": 16},
"memoryMiB": {"min": 16384, "max": 65536},
"osFamily": "LINUX",
"rootEbsVolume": {"sizeGiB": 250}
},
"instanceMarketOptions": {"type": "spot"},
"persistentVolumeConfiguration": {
"sizeGiB": 2048,
"iops": 16000,
"throughputMiB": 500,
"mountPath": "/mnt/persistent",
"lastUsedTtlHours": 168
}
}
}'
```
Pour désactiver le stockage persistant, omettez l'`persistentVolumeConfiguration`objet de la configuration du parc lors d'un `UpdateFleet` appel. Deadline Cloud nettoie automatiquement les volumes existants lorsqu'ils ne sont plus associés à un collaborateur.
## Opérations de gestion des volumes
Vous pouvez utiliser les opérations suivantes pour gérer les volumes persistants :
### GetVolume
Récupère des informations détaillées sur un volume persistant spécifique.
**Demande**
```
aws deadline get-volume \
--farm-id {{farm-0123456789abcdef0}} \
--fleet-id {{fleet-0123456789abcdef0}} \
--volume-id {{volume-0123456789abcdef0}}
```
**Réponse**
```
{
"volumeId": "volume-0123456789abcdef0",
"fleetId": "fleet-0123456789abcdef0",
"farmId": "farm-0123456789abcdef0",
"state": "AVAILABLE",
"volumeType": "gp3",
"sizeGiB": 2048,
"iops": 16000,
"throughputMiB": 500,
"availabilityZone": "us-west-2a",
"attachedWorkerId": null,
"createdAt": "2024-01-15T10:30:00Z",
"lastAttachedAt": "2024-11-15T14:22:00Z",
"ttl": "2024-11-22T14:22:00Z"
}
```
Le `state` champ indique l'état actuel du volume. Les valeurs possibles sont :
+ `AVAILABLE`— Le volume est détaché et prêt à être fixé.
+ `IN_USE`— Le volume est actuellement attaché à un travailleur.
+ `PENDING_CREATION`— Le volume est en cours de création.
+ `PENDING_ATTACHMENT`— Le volume est réservé à l'attachement à un travailleur.
+ `PENDING_DELETION`— Le volume est marqué pour suppression.
## Variable d'environnement
Lorsque le stockage persistant est correctement monté, Deadline Cloud définit la variable d'environnement suivante sur le travailleur :
```
DEADLINE_PERSISTENT_MOUNT={{/mnt/persistent}}
```
La valeur de la variable d'environnement est le chemin de montage que vous avez spécifié dans la configuration du parc. Cette variable d'environnement est disponible pour tous les processus de travail exécutés sur le travailleur, y compris les scripts de configuration de l'hôte et les actions du modèle de tâche.
Les utilisateurs d'exécution suivants utilisent automatiquement le stockage persistant lorsque la variable d'environnement est présente :
+ **Environnements de file d'attente Conda** : stocke les installations de packages sur le volume persistant.
+ **Cache immuable VFS** : stocke le cache des actifs sur le volume persistant.
Vous pouvez référencer la variable d'environnement dans vos modèles de tâches Open Job Description pour stocker des données personnalisées sur le volume persistant. L'exemple suivant montre une étape qui enregistre le résultat dans un stockage persistant :
```
steps:
- name: ProcessAssets
script:
actions:
onRun:
command: bash
args:
- "-c"
- |
CACHE_DIR="${DEADLINE_PERSISTENT_MOUNT}/my-app-cache"
mkdir -p "$CACHE_DIR"
# Your processing logic here
```
## Comportement de modification de configuration
Le tableau suivant décrit l'impact des modifications de configuration sur les volumes persistants existants :
| Modifier | Comportement |
| --- | --- |
| Augmenter les IOPS ou le débit | Deadline Cloud applique les modifications avant le prochain attachement au volume. |
| Diminution des IOPS ou du débit | Deadline Cloud applique les modifications avant le prochain attachement au volume. |
| Augmenter la taille du volume | Deadline Cloud agrandit le volume avant la prochaine pièce jointe et étend automatiquement le système de fichiers au démarrage du programme de travail. |
| Diminuer la taille du volume | Non pris en charge. La taille des volumes Amazon EBS ne peut pas être réduite. |
| Modifier le chemin de montage | S'applique uniquement aux nouveaux travailleurs. Les employés existants conservent leur trajectoire de montage actuelle. |
| Supprimer le stockage persistant | Deadline Cloud marque les volumes existants à supprimer et les nettoie lorsqu'ils ne sont plus associés à un travailleur. |