[efs] 섹션 - AWS ParallelCluster
efs_fs_idefs_kms_key_idencryptedperformance_modeprovisioned_throughputshared_dirthroughput_mode

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

[efs] 섹션

헤드 및 컴퓨팅 노드에 탑재된 Amazon EFS에 대한 구성 설정을 정의합니다. 자세한 내용은 Amazon EFS API Reference의 CreateFileSystem을 참조하세요.

클러스터 정의에 Amazon EFS 파일 시스템을 포함하는 방법을 알아보려면 [cluster] 섹션/efs_settings를 참조하세요.

클러스터 수명 주기에 구애받지 않는 장기 영구 스토리지에 기존 Amazon EFS 파일 시스템을 사용하려면 efs_fs_id을 지정하세요.

efs_fs_id을 지정하지 않으면 AWS ParallelCluster가 클러스터를 생성할 때 [efs] 설정에서 Amazon EFS 파일 시스템을 만들고 클러스터를 삭제할 때 파일 시스템과 데이터를 삭제합니다.

자세한 내용은 모범 사례: 클러스터를 새 클러스터로 이동 AWS ParallelCluster 마이너 버전 또는 패치 버전 항목을 참조하세요.

형식은 [efs efs-name]입니다. efs-name은 문자로 시작해야 하고, 30자 이하여야 하며, 문자, 숫자, 하이픈(-) 및 밑줄(_)만 포함되어야 합니다.

[efs customfs]
shared_dir = efs
encrypted = false
performance_mode = generalPurpose

efs_fs_id

(선택 사항) 기존 파일 시스템의 Amazon EFS 파일 시스템 ID를 정의합니다.

이 옵션을 지정하면 shared_dir을 제외한 기타 모든 Amazon EFS 옵션이 무효화됩니다.

이 옵션을 설정하면 다음과 같은 파일 시스템 유형만 지원됩니다.

  • 스택의 가용 영역에 탑재 대상이 없는 파일 시스템

  • 스택의 가용 영역에 기존 탑재 대상이 있으며 0.0.0.0/0에서 허용된 인바운드 및 아웃바운드 NFS 트래픽이 있는 파일 시스템

efs_fs_id를 확인하기 위한 안전성 검사를 수행하려면 IAM 역할에 다음 권한이 있어야 합니다.

  • elasticfilesystem:DescribeMountTargets

  • elasticfilesystem:DescribeMountTargetSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeSecurityGroups

  • ec2:DescribeNetworkInterfaceAttribute

오류를 방지하려면 이러한 권한을 IAM 역할에 추가하거나 sanity_check = false를 설정해야 합니다.

중요

인바운드 및 아웃바운드 NFS 트래픽이 0.0.0.0/0에서 허용된 탑재 대상을 설정할 경우 탑재 대상의 가용 영역 내 어디에서든 NFS 탑재 요청에 파일 시스템이 공개됩니다. AWS는 스택의 가용 영역 내에 탑재 대상을 생성하는 것을 권장하지 않습니다. 대신 AWS가 이 단계를 처리하게 하세요. 스택의 가용 영역에 탑재 대상이 있어야 하는 경우 [vpc] 섹션에서 vpc_security_group_id 옵션을 제공하여 사용자 지정 보안 그룹을 사용하는 것을 고려합니다. 그런 다음 해당 보안 그룹을 탑재 대상에 추가하고 sanity_check을 해제하여 클러스터를 생성합니다.

기본값이 없습니다.

efs_fs_id = fs-12345

업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.

efs_kms_key_id

(선택 사항) (선택 사항) 암호화된 파일 시스템을 보호하는 데 사용할 AWS Key Management Service(AWS KMS) 고객 관리형 키를 식별합니다. 이 옵션이 설정된 경우 encrypted 설정을 true로 지정해야 합니다. 이는 Amazon EFS API 참조의 KmsKeyId 파라미터에 대응합니다.

기본값이 없습니다.

efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab

업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.

encrypted

(선택 사항) 파일 시스템이 암호화되는지 여부를 나타냅니다. 이는 Amazon EFS API 참조의 Encrypted 파라미터에 대응합니다.

기본값은 false입니다.

encrypted = true

업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.

performance_mode

(선택 사항) 파일 시스템의 성능 모드를 정의합니다. 이는 Amazon EFS API 참조의 PerformanceMode 파라미터에 대응합니다.

유효한 옵션은 다음과 같습니다.

  • generalPurpose

  • maxIO

두 값 모두 대소문자를 구분합니다.

대부분의 파일 시스템에 generalPurpose 성능 모드를 사용하는 것이 좋습니다.

maxIO 성능 모드를 사용하는 파일 시스템은 더 높은 수준의 집계 처리량 및 초당 작업으로 확장할 수 있습니다. 그러나 대부분의 파일 작업에서 대기 시간이 조금 더 길다는 단점이 있습니다.

파일 시스템을 생성한 후에는 이 파라미터를 변경할 수 없습니다.

기본값은 generalPurpose입니다.

performance_mode = generalPurpose

업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.

provisioned_throughput

(선택 사항) MiB/s로 측정되는 프로비저닝된 파일 시스템 처리량을 정의합니다. 이는 Amazon EFS API 참조의 ProvisionedThroughputInMibps 파라미터에 대응합니다.

이 파라미터를 사용할 경우 throughput_mode를 provisioned로 설정해야 합니다.

처리량 할당량은 1024MiB/s입니다. 할당량 증가를 요청하려면 AWS Support에 문의하세요.

최소값은 0.0MiB/s입니다.

provisioned_throughput = 1024

업데이트 정책: 업데이트 중에 이 설정을 변경할 수 있습니다.

shared_dir

(필수) 헤드 및 컴퓨팅 노드의 Amazon EFS 탑재 지점을 정의합니다.

이 파라미터는 필수 항목입니다. Amazon EFS 섹션은 shared_dir이 지정되는 경우에만 사용됩니다.

NONE 또는 /NONE을 공유 디렉터리로 사용하지 마세요.

다음 예에서는 Amazon EFS를 /efs에 탑재합니다.

shared_dir = efs

업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.

throughput_mode

(선택 사항) 파일 시스템의 처리량 모드를 정의합니다. 이는 Amazon EFS API 참조의 ThroughputMode 파라미터에 대응합니다.

유효한 옵션은 다음과 같습니다.

  • bursting

  • provisioned

기본값은 bursting입니다.

throughput_mode = provisioned

업데이트 정책: 업데이트 중에 이 설정을 변경할 수 있습니다.