

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Penyimpanan persisten untuk armada yang dikelola layanan
<a name="smf-persistent-storage-dev"></a>

AWS Penyimpanan persisten Deadline Cloud (Deadline Cloud) melampirkan volume khusus Amazon Elastic Block Store (Amazon EBS) gp3 ke pekerja armada yang dikelola layanan. Volume ini menyimpan data seperti instalasi paket conda, cache aplikasi, dan ruang kerja kontrol versi di seluruh peristiwa siklus hidup pekerja. Untuk ikhtisar konseptual, lihat [Penyimpanan persisten untuk armada yang dikelola layanan](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/volumes.html) di Panduan Pengguna Cloud *AWS Batas Waktu*.

## Konfigurasi Armada
<a name="smf-persistent-storage-dev-fleet-config"></a>

Untuk mengaktifkan penyimpanan persisten, sertakan `persistentVolumeConfiguration` objek di `serviceManagedEc2FleetConfiguration` saat Anda menelepon `CreateFleet` atau`UpdateFleet`.

### Parameter konfigurasi
<a name="smf-persistent-storage-dev-params"></a>

`persistentVolumeConfiguration`Objek menerima parameter berikut. Untuk rentang yang valid dan nilai default, lihat [CreateFleet](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateFleet.html)di *Referensi API Cloud Deadline*.


| Parameter | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| sizeGiB | Bulat | Tidak | Ukuran volume persisten di GiB. | 
| iops | Bilangan Bulat | Tidak | IOPS yang disediakan untuk volume gp3. | 
| throughputMiB | Bilangan Bulat | Tidak | Throughput yang disediakan MiB/s untuk volume gp3. | 
| mountPath | Tali | Ya | Lokasi pemasangan pada pekerja. UntukLinux, tentukan jalur absolut (misalnya,/mnt/persistent). UntukWindows, tentukan huruf drive (misalnya,D:). | 
| lastUsedTtlHours | Bilangan Bulat | Tidak | Jumlah jam setelah volume terakhir digunakan sebelum pembersihan otomatis. | 

### Buat armada dengan penyimpanan persisten
<a name="smf-persistent-storage-dev-create-example"></a>

 AWS CLI Contoh berikut membuat armada yang dikelola layanan dengan penyimpanan persisten diaktifkan:

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

### Perbarui konfigurasi penyimpanan persisten
<a name="smf-persistent-storage-dev-update-example"></a>

 AWS CLI Contoh berikut menambahkan penyimpanan persisten ke armada yang ada:

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

Untuk menonaktifkan penyimpanan persisten, hilangkan `persistentVolumeConfiguration` objek dari konfigurasi armada dalam `UpdateFleet` panggilan. Deadline Cloud secara otomatis membersihkan volume yang ada saat tidak lagi dilampirkan ke pekerja.

## Operasi manajemen volume
<a name="smf-persistent-storage-dev-volume-apis"></a>

Anda dapat menggunakan operasi berikut untuk mengelola volume persisten:

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

Mengambil informasi rinci tentang volume persisten tertentu.

**Permintaan**

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

**Respons**

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

`state`Bidang menunjukkan status volume saat ini. Kemungkinan nilainya adalah:
+ `AVAILABLE`— Volume terlepas dan siap untuk dipasang.
+ `IN_USE`— Volume saat ini dilampirkan ke pekerja.
+ `PENDING_CREATION`— Volume sedang dibuat.
+ `PENDING_ATTACHMENT`— Volume dicadangkan untuk lampiran ke pekerja.
+ `PENDING_DELETION`— Volume ditandai untuk dihapus.

## Variabel lingkungan
<a name="smf-persistent-storage-dev-env-var"></a>

Ketika penyimpanan persisten berhasil dipasang, Deadline Cloud menetapkan variabel lingkungan berikut pada pekerja:

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

Nilai variabel lingkungan adalah jalur pemasangan yang Anda tentukan dalam konfigurasi armada. Variabel lingkungan ini tersedia untuk semua proses pekerjaan yang berjalan pada pekerja, termasuk skrip konfigurasi host dan tindakan templat pekerjaan.

Konsumen runtime berikut secara otomatis menggunakan penyimpanan persisten saat variabel lingkungan ada:
+ **Lingkungan antrian Conda** — Menyimpan instalasi paket pada volume persisten.
+ **Cache yang tidak dapat diubah VFS — Menyimpan** cache aset pada volume persisten.

Anda dapat mereferensikan variabel lingkungan di template pekerjaan Open Job Description Anda untuk menyimpan data kustom pada volume persisten. Contoh berikut menunjukkan langkah yang menulis output ke penyimpanan persisten:

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

## Konfigurasi mengubah perilaku
<a name="smf-persistent-storage-dev-config-changes"></a>

Tabel berikut menjelaskan bagaimana perubahan konfigurasi mempengaruhi volume persisten yang ada:


| Ubah | Perilaku | 
| --- | --- | 
| Meningkatkan IOPS atau throughput | Deadline Cloud menerapkan perubahan sebelum lampiran volume berikutnya. | 
| Kurangi IOPS atau throughput | Deadline Cloud menerapkan perubahan sebelum lampiran volume berikutnya. | 
| Tingkatkan ukuran volume | Deadline Cloud memperbesar volume sebelum lampiran berikutnya dan memperluas sistem file secara otomatis selama startup pekerja. | 
| Kurangi ukuran volume | Tidak didukung. Volume Amazon EBS tidak dapat dikurangi ukurannya. | 
| Ubah jalur pemasangan | Hanya berlaku untuk pekerja baru. Pekerja yang ada mempertahankan jalur pemasangan mereka saat ini. | 
| Hapus penyimpanan persisten | Deadline Cloud menandai volume yang ada untuk dihapus dan membersihkannya saat tidak lagi melekat pada pekerja. | 