

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Storage persistente per flotte gestite dai servizi
<a name="smf-persistent-storage-dev"></a>

AWS Lo storage persistente Deadline Cloud (Deadline Cloud) collega volumi gp3 dedicati di Amazon Elastic Block Store (Amazon EBS) ai lavoratori della flotta gestiti dai servizi. Questi volumi conservano dati come le installazioni di pacchetti conda, le cache delle applicazioni e gli spazi di lavoro per il controllo delle versioni durante gli eventi del ciclo di vita dei lavoratori. *Per una panoramica concettuale, consulta [Archiviazione persistente per flotte gestite dai servizi nella Guida per l'utente di Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/volumes.html).AWS *

## Configurazione del parco istanze
<a name="smf-persistent-storage-dev-fleet-config"></a>

Per abilitare l'archiviazione persistente, includi l'`persistentVolumeConfiguration`oggetto in quando chiami `serviceManagedEc2FleetConfiguration` o. `CreateFleet` `UpdateFleet`

### Parametri di configurazione
<a name="smf-persistent-storage-dev-params"></a>

L'`persistentVolumeConfiguration`oggetto accetta i seguenti parametri. Per intervalli validi e valori predefiniti, [CreateFleet](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateFleet.html)consulta *Deadline Cloud API Reference.*


| Parametro | Tipo | Campo obbligatorio | Description | 
| --- | --- | --- | --- | 
| sizeGiB | Numero intero | No | La dimensione del volume persistente in GiB. | 
| iops | Numero intero | No | Gli IOPS assegnati per il volume gp3. | 
| throughputMiB | Numero intero | No | Il throughput assegnato per il volume gp3. MiB/s  | 
| mountPath | Stringa | Sì | La posizione di montaggio sull'operatore. PerLinux, specificare un percorso assoluto (ad esempio,/mnt/persistent). PerWindows, specificare una lettera di unità (ad esempio,D:). | 
| lastUsedTtlHours | Numero intero | No | Il numero di ore trascorse dall'ultimo utilizzo di un volume prima della pulizia automatica. | 

### Crea una flotta con storage persistente
<a name="smf-persistent-storage-dev-create-example"></a>

L' AWS CLI esempio seguente crea una flotta gestita dai servizi con lo storage persistente abilitato:

```
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
        }
      }
    }'
```

### Aggiorna la configurazione dello storage persistente
<a name="smf-persistent-storage-dev-update-example"></a>

L' AWS CLI esempio seguente aggiunge lo storage persistente a una flotta esistente:

```
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
        }
      }
    }'
```

Per disabilitare l'archiviazione persistente, ometti l'`persistentVolumeConfiguration`oggetto dalla configurazione del parco veicoli in una `UpdateFleet` chiamata. Deadline Cloud pulisce automaticamente i volumi esistenti quando non sono più collegati a un lavoratore.

## Operazioni di gestione dei volumi
<a name="smf-persistent-storage-dev-volume-apis"></a>

È possibile utilizzare le seguenti operazioni per gestire i volumi persistenti:

### GetVolume
<a name="smf-persistent-storage-dev-get-volume"></a>

Recupera informazioni dettagliate su un volume persistente specifico.

**Richiesta**

```
aws deadline get-volume \
    --farm-id {{farm-0123456789abcdef0}} \
    --fleet-id {{fleet-0123456789abcdef0}} \
    --volume-id {{volume-0123456789abcdef0}}
```

**Risposta**

```
{
  "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"
}
```

Il `state` campo indica lo stato attuale del volume. I valori possibili sono:
+ `AVAILABLE`— Il volume è staccato e pronto per il fissaggio.
+ `IN_USE`— Il volume è attualmente collegato a un lavoratore.
+ `PENDING_CREATION`— Il volume è in fase di creazione.
+ `PENDING_ATTACHMENT`— Il volume è riservato all'allegato di un lavoratore.
+ `PENDING_DELETION`— Il volume è contrassegnato per l'eliminazione.

## Variabile di ambiente
<a name="smf-persistent-storage-dev-env-var"></a>

Quando lo storage persistente viene montato correttamente, Deadline Cloud imposta la seguente variabile di ambiente sul lavoratore:

```
DEADLINE_PERSISTENT_MOUNT={{/mnt/persistent}}
```

Il valore della variabile di ambiente è il percorso di montaggio specificato nella configurazione della flotta. Questa variabile di ambiente è disponibile per tutti i processi di lavoro in esecuzione sul worker, inclusi gli script di configurazione dell'host e le azioni dei modelli di lavoro.

I seguenti utenti di runtime utilizzano automaticamente lo storage persistente quando è presente la variabile di ambiente:
+ **Ambienti di coda Conda**: archivia le installazioni dei pacchetti sul volume persistente.
+ Cache **immutabile VFS: archivia la cache** degli asset sul volume persistente.

È possibile fare riferimento alla variabile di ambiente nei modelli di lavoro di Open Job Description per archiviare dati personalizzati nel volume persistente. L'esempio seguente mostra un passaggio che scrive l'output nella memoria persistente:

```
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
```

## Comportamento di modifica della configurazione
<a name="smf-persistent-storage-dev-config-changes"></a>

La tabella seguente descrive come le modifiche alla configurazione influiscono sui volumi persistenti esistenti:


| Modifica | Comportamento | 
| --- | --- | 
| Aumentare l'IOPS o il throughput | Deadline Cloud applica le modifiche prima dell'allegato del volume successivo. | 
| Riduci gli IOPS o il throughput | Deadline Cloud applica le modifiche prima dell'allegato del volume successivo. | 
| Aumenta la dimensione del volume | Deadline Cloud ingrandisce il volume prima dell'allegato successivo ed espande automaticamente il file system all'avvio del lavoratore. | 
| Diminuisci le dimensioni del volume | Non supportato. Le dimensioni dei volumi Amazon EBS non possono essere ridotte. | 
| Cambia il percorso di montaggio | Si applica solo ai nuovi lavoratori. I lavoratori esistenti mantengono il percorso di montaggio corrente. | 
| Rimuovi lo storage persistente | Deadline Cloud contrassegna i volumi esistenti per l'eliminazione e li pulisce quando non sono più collegati a un lavoratore. | 