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

サービスマネージドフリートの永続的ストレージ

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

フリート設定

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

設定パラメータ

persistentVolumeConfiguration オブジェクトは次のパラメータを受け入れます。有効な範囲とデフォルト値については、Deadline Cloud API リファレンスのCreateFleet」を参照してください。

永続的ストレージを使用してフリートを作成する

次の 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
        }
      }
    }'

永続的ストレージ設定を更新する

次の 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 は、ワーカーにアタッチされなくなった既存のボリュームを自動的にクリーンアップします。

ボリューム管理オペレーション

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

GetVolume

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

リクエスト

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 フィールドは、現在のボリュームの状態を示します。可能な値は以下のとおりです。

環境変数

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

DEADLINE_PERSISTENT_MOUNT=/mnt/persistent

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

次のランタイムコンシューマーは、環境変数が存在する場合、永続的ストレージを自動的に使用します。

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

設定変更の動作

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