기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# `[efs]` 섹션
헤드 및 컴퓨팅 노드에 탑재된 Amazon EFS에 대한 구성 설정을 정의합니다. 자세한 내용은 Amazon EFS API Reference**의 [CreateFileSystem](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html)을 참조하세요.
클러스터 정의에 Amazon EFS 파일 시스템을 포함하는 방법을 알아보려면 ``[cluster]` 섹션`/``efs_settings``를 참조하세요.
클러스터 수명 주기에 구애받지 않는 장기 영구 스토리지에 기존 Amazon EFS 파일 시스템을 사용하려면 [`efs_fs_id`](#efs-efs-fs-id)을 지정하세요.
를 지정하지 않으면는 클러스터를 [`efs_fs_id`](#efs-efs-fs-id) AWS ParallelCluster 생성할 때 `[efs]` 설정에서 Amazon EFS 파일 시스템을 생성하고 클러스터가 삭제될 때 파일 시스템 및 데이터를 삭제합니다.
자세한 내용은 [모범 사례: 클러스터를 새 AWS ParallelCluster 마이너 또는 패치 버전으로 이동](best-practices.md#best-practices-cluster-upgrades) 단원을 참조하십시오.
형식은 `[efs efs-name]`입니다. *efs-name*은 문자로 시작해야 하고, 30자 이하여야 하며, 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.
```
[efs customfs]
shared_dir = efs
encrypted = false
performance_mode = generalPurpose
```
**Topics**
+ [`efs_fs_id`](#efs-efs-fs-id)
+ [`efs_kms_key_id`](#efs-efs-kms-key-id)
+ [`encrypted`](#efs-encrypted)
+ [`performance_mode`](#efs-performance-mode)
+ [`provisioned_throughput`](#efs-provisioned-throughput)
+ [`shared_dir`](#efs-shared-dir)
+ [`throughput_mode`](#efs-throughput-mode)
## `efs_fs_id`
(선택 사항)**** 기존 파일 시스템의 Amazon EFS 파일 시스템 ID를 정의합니다.
이 옵션을 지정하면 [`shared_dir`](cluster-definition.md#cluster-shared-dir)을 제외한 기타 모든 Amazon EFS 옵션이 무효화됩니다.
이 옵션을 설정하면 다음과 같은 파일 시스템 유형만 지원됩니다.
+ 스택의 가용 영역에 탑재 대상이 없는 파일 시스템
+ 스택의 가용 영역에 기존 탑재 대상이 있으며 `0.0.0.0/0`에서 허용된 인바운드 및 아웃바운드 NFS 트래픽이 있는 파일 시스템
[`efs_fs_id`](#efs-efs-fs-id)를 확인하기 위한 안전성 검사를 수행하려면 IAM 역할에 다음 권한이 있어야 합니다.
+ `elasticfilesystem:DescribeMountTargets`
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeNetworkInterfaceAttribute`
오류를 방지하려면 이러한 권한을 IAM 역할에 추가하거나 `sanity_check = false`를 설정해야 합니다.
**중요**
에서 허용되는 인바운드 및 아웃바운드 NFS 트래픽으로 탑재 대상을 설정하면 탑재 대상의 가용 영역에 있는 모든 위치에서 NFS 탑재 요청에 파일 시스템이 `0.0.0.0/0`노출됩니다. 스택의 가용 영역에 탑재 대상을 생성하는 AWS 것은 권장하지 않습니다. 대신이 단계를 AWS 처리해 보겠습니다. 스택의 가용 영역에 탑재 대상이 있어야 하는 경우 [`[vpc]` 섹션](vpc-section.md)에서 [`vpc_security_group_id`](vpc-section.md#vpc-security-group-id) 옵션을 제공하여 사용자 지정 보안 그룹을 사용하는 것을 고려합니다. 그런 다음 해당 보안 그룹을 탑재 대상에 추가하고 `sanity_check`을 해제하여 클러스터를 생성합니다.
기본값이 없습니다.
```
efs_fs_id = fs-12345
```
[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)
## `efs_kms_key_id`
**(선택 사항)** 암호화된 파일 시스템을 보호하는 데 사용할 AWS Key Management Service (AWS KMS) 고객 관리형 키를 식별합니다. 이 옵션이 설정된 경우 [`encrypted`](#efs-encrypted) 설정을 `true`로 지정해야 합니다. 이는 Amazon EFS API 참조**의 [KmsKeyId](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-KmsKeyId) 파라미터에 대응합니다.
기본값이 없습니다.
```
efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab
```
[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)
## `encrypted`
(선택 사항)**** 파일 시스템이 암호화되는지 여부를 나타냅니다. 이는 Amazon EFS API 참조**의 [Encrypted](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-Encrypted) 파라미터에 대응합니다.
기본값은 `false`입니다.
```
encrypted = true
```
[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)
## `performance_mode`
(선택 사항)**** 파일 시스템의 성능 모드를 정의합니다. 이는 Amazon EFS API 참조**의 [PerformanceMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-PerformanceMode) 파라미터에 대응합니다.
유효한 옵션은 다음과 같습니다.
+ `generalPurpose`
+ `maxIO`
두 값 모두 대소문자를 구분합니다.
대부분의 파일 시스템에 `generalPurpose` 성능 모드를 사용하는 것이 좋습니다.
`maxIO` 성능 모드를 사용하는 파일 시스템은 더 높은 수준의 집계 처리량 및 초당 작업으로 확장할 수 있습니다. 그러나 대부분의 파일 작업에서 대기 시간이 조금 더 길다는 단점이 있습니다.
파일 시스템을 생성한 후에는 이 파라미터를 변경할 수 없습니다.
기본값은 `generalPurpose`입니다.
```
performance_mode = generalPurpose
```
[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)
## `provisioned_throughput`
(선택 사항)**** MiB/s로 측정되는 프로비저닝된 파일 시스템 처리량을 정의합니다. 이는 Amazon EFS API 참조**의 [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps) 파라미터에 대응합니다.
이 파라미터를 사용할 경우 [`throughput_mode`](#efs-throughput-mode)를 `provisioned`로 설정해야 합니다.
처리량 할당량은 `1024`MiB/s입니다. 할당량 증가를 요청하려면 지원에 문의하십시오.
최소값은 `0.0`MiB/s입니다.
```
provisioned_throughput = 1024
```
[업데이트 정책: 업데이트 중에 이 설정을 변경할 수 있습니다.](using-pcluster-update.md#update-policy-setting-supported)
## `shared_dir`
(필수)**** 헤드 및 컴퓨팅 노드의 Amazon EFS 탑재 지점을 정의합니다.
이 파라미터는 필수 사항입니다. Amazon EFS 섹션은 [`shared_dir`](cluster-definition.md#cluster-shared-dir)이 지정되는 경우에만 사용됩니다.
`NONE` 또는 `/NONE`을 공유 디렉터리로 사용하지 마세요.
다음 예에서는 Amazon EFS를 `/efs`에 탑재합니다.
```
shared_dir = efs
```
[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)
## `throughput_mode`
(선택 사항)**** 파일 시스템의 처리량 모드를 정의합니다. 이는 Amazon EFS API 참조**의 [ThroughputMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-ThroughputMode) 파라미터에 대응합니다.
유효한 옵션은 다음과 같습니다.
+ `bursting`
+ `provisioned`
기본값은 `bursting`입니다.
```
throughput_mode = provisioned
```
[업데이트 정책: 업데이트 중에 이 설정을 변경할 수 있습니다.](using-pcluster-update.md#update-policy-setting-supported)