翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サービスマネージドフリートの永続的ストレージ
<a name="smf-persistent-storage-dev"></a>

AWS Deadline Cloud (Deadline Cloud) 永続ストレージは、専用の Amazon Elastic Block Store (Amazon EBS) gp3 ボリュームをサービスマネージドフリートワーカーにアタッチします。これらのボリュームは、ワーカーライフサイクルイベント全体で conda パッケージのインストール、アプリケーションキャッシュ、バージョン管理ワークスペースなどのデータを保持します。概念的な概要については、*AWS 「Deadline Cloud ユーザーガイド*」の[「サービスマネージドフリートの永続的ストレージ](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/volumes.html)」を参照してください。

## フリート設定
<a name="smf-persistent-storage-dev-fleet-config"></a>

永続的ストレージを有効にするには、 `CreateFleet`または を呼び出す`serviceManagedEc2FleetConfiguration`ときに に `persistentVolumeConfiguration` オブジェクトを含めます`UpdateFleet`。

### 設定パラメータ
<a name="smf-persistent-storage-dev-params"></a>

`persistentVolumeConfiguration` オブジェクトは次のパラメータを受け入れます。有効な範囲とデフォルト値については、*Deadline Cloud API リファレンス*の[CreateFleet](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateFleet.html)」を参照してください。


| パラメータ | タイプ | 必須 | 説明 | 
| --- | --- | --- | --- | 
| sizeGiB | 整数 | いいえ | GiB 単位の永続ボリュームのサイズ。 | 
| iops | 整数 | いいえ | gp3 ボリュームのプロビジョニングされた IOPS。 | 
| throughputMiB | 整数 | いいえ | gp3 ボリュームの MiB/秒単位のプロビジョニングされたスループット。 | 
| mountPath | String | はい | ワーカーのマウント場所。にはLinux、絶対パス ( など/mnt/persistent) を指定します。にはWindows、ドライブ文字 ( などD:) を指定します。 | 
| lastUsedTtlHours | 整数 | いいえ | 自動クリーンアップの前にボリュームが最後に使用された後の時間数。 | 

### 永続的ストレージを使用してフリートを作成する
<a name="smf-persistent-storage-dev-create-example"></a>

次の AWS CLI 例では、永続ストレージが有効になっているサービスマネージドフリートを作成します。

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

### 永続的ストレージ設定を更新する
<a name="smf-persistent-storage-dev-update-example"></a>

次の AWS CLI 例では、既存のフリートに永続的ストレージを追加します。

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

永続的ストレージを無効にするには、 `UpdateFleet`呼び出しでフリート設定から `persistentVolumeConfiguration` オブジェクトを省略します。Deadline Cloud は、ワーカーにアタッチされなくなった既存のボリュームを自動的にクリーンアップします。

## ボリューム管理オペレーション
<a name="smf-persistent-storage-dev-volume-apis"></a>

次のオペレーションを使用して永続ボリュームを管理できます。

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

特定の永続ボリュームに関する詳細情報を取得します。

**リクエスト**

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

**レスポンス**

```
{
  "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` フィールドは、現在のボリュームの状態を示します。可能な値は以下のとおりです。
+ `AVAILABLE` – ボリュームはデタッチされ、アタッチメントの準備が整います。
+ `IN_USE` – ボリュームは現在ワーカーにアタッチされています。
+ `PENDING_CREATION` – ボリュームは作成中です。
+ `PENDING_ATTACHMENT` – ボリュームはワーカーへのアタッチ用に予約されています。
+ `PENDING_DELETION` – ボリュームは削除対象としてマークされます。

## 環境変数
<a name="smf-persistent-storage-dev-env-var"></a>

永続的ストレージが正常にマウントされると、Deadline Cloud はワーカーに次の環境変数を設定します。

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

環境変数の値は、フリート設定で指定したマウントパスです。この環境変数は、ホスト設定スクリプトやジョブテンプレートアクションなど、ワーカーで実行されているすべてのジョブプロセスで使用できます。

次のランタイムコンシューマーは、環境変数が存在する場合、永続的ストレージを自動的に使用します。
+ **Conda キュー環境** – 永続ボリュームにパッケージのインストールを保存します。
+ **VFS イミュータブルキャッシュ** – アセットキャッシュを永続ボリュームに保存します。

Open Job Description ジョブテンプレートの 環境変数を参照して、カスタムデータを永続ボリュームに保存できます。次の例は、永続的ストレージに出力を書き込むステップを示しています。

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

## 設定変更の動作
<a name="smf-persistent-storage-dev-config-changes"></a>

次の表は、設定の変更が既存の永続ボリュームにどのように影響するかを示しています。


| 変更 | 行動 | 
| --- | --- | 
| IOPS またはスループットの向上 | Deadline Cloud は、次のボリュームアタッチメントの前に変更を適用します。 | 
| IOPS またはスループットを減らす | Deadline Cloud は、次のボリュームアタッチメントの前に変更を適用します。 | 
| ボリュームサイズを増やす | Deadline Cloud は、次のアタッチメントの前にボリュームを拡大し、ワーカーの起動時にファイルシステムを自動的に拡張します。 | 
| ボリュームサイズを縮小する | サポート外。Amazon EBS ボリュームのサイズを小さくすることはできません。 | 
| マウントパスを変更する | 新しいワーカーにのみ適用されます。既存のワーカーは、現在のマウントパスを保持します。 | 
| 永続的ストレージを削除する | Deadline Cloud は、既存のボリュームを削除対象としてマークし、ワーカーにアタッチされなくなったときにクリーンアップします。 |