View a markdown version of this page

서비스 관리형 플릿을 위한 영구 스토리지 - 기한 클라우드

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

서비스 관리형 플릿을 위한 영구 스토리지

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을 참조하세요.

파라미터 유형 필수 설명
sizeGiB Integer 아니요 GiB 단위의 영구 볼륨 크기입니다.
iops Integer 아니요 gp3 볼륨에 대해 프로비저닝된 IOPS입니다.
throughputMiB Integer 아니요 gp3 볼륨에 대해 MiB/s 단위로 프로비저닝된 처리량입니다.
mountPath 문자열 작업자의 탑재 위치입니다. 의 경우 절대 경로(예: /mnt/persistent)를 Linux지정합니다. 의 경우 드라이브 문자(예: D:)를 Windows지정합니다.
lastUsedTtlHours Integer 아니요 자동 정리 전에 볼륨이 마지막으로 사용된 후의 시간입니다.

영구 스토리지를 사용하여 플릿 생성

다음 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 필드는 현재 볼륨 상태를 나타냅니다. 가능한 값은 다음과 같습니다.

  • AVAILABLE - 볼륨이 분리되어 연결할 준비가 되었습니다.

  • IN_USE - 볼륨이 현재 작업자에 연결되어 있습니다.

  • PENDING_CREATION - 볼륨이 생성 중입니다.

  • PENDING_ATTACHMENT - 볼륨은 작업자에 연결하기 위해 예약되어 있습니다.

  • PENDING_DELETION - 볼륨이 삭제 대상으로 표시됩니다.

환경 변수

영구 스토리지가 성공적으로 탑재되면 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

구성 변경 동작

다음 표에서는 구성 변경이 기존 영구 볼륨에 미치는 영향을 설명합니다.

변경 동작
IOPS 또는 처리량 증가 Deadline Cloud는 다음 볼륨 연결 전에 변경 사항을 적용합니다.
IOPS 또는 처리량 감소 Deadline Cloud는 다음 볼륨 연결 전에 변경 사항을 적용합니다.
볼륨 크기 증가 Deadline Cloud는 다음 연결 전에 볼륨을 확대하고 작업자 시작 중에 파일 시스템을 자동으로 확장합니다.
볼륨 크기 줄이기 지원되지 않음. Amazon EBS 볼륨의 크기는 줄일 수 없습니다.
탑재 경로 변경 새 작업자에게만 적용됩니다. 기존 작업자는 현재 탑재 경로를 유지합니다.
영구 스토리지 제거 Deadline Cloud는 기존 볼륨을 삭제 대상으로 표시하고 더 이상 작업자에 연결되지 않을 때 정리합니다.