

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

# `[ebs]` 섹션
<a name="ebs-section"></a>

헤드 노드에 탑재되고 NFS를 통해 컴퓨팅 노드에 공유되는 볼륨에 대한 Amazon EBS 볼륨 구성 설정을 정의합니다.

클러스터 정의에 Amazon EBS 볼륨을 포함하는 방법을 알아보려면 ``[cluster]` 섹션`/``ebs_settings``를 참조하세요.

클러스터 수명 주기에 구애받지 않는 장기 영구 스토리지에 기존 Amazon EBS 볼륨을 사용하려면 [`ebs_volume_id`](#ebs-volume-id)을 지정하세요.

를 지정하지 않으면는 클러스터를 [`ebs_volume_id`](#ebs-volume-id) AWS ParallelCluster 생성할 때 `[ebs]` 설정에서 EBS 볼륨을 생성하고 클러스터가 삭제될 때 볼륨과 데이터를 삭제합니다.

자세한 내용은 [모범 사례: 클러스터를 새 AWS ParallelCluster 마이너 또는 패치 버전으로 이동](best-practices.md#best-practices-cluster-upgrades) 단원을 참조하십시오.

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

```
[ebs custom1]
shared_dir = vol1
ebs_snapshot_id = snap-xxxxx
volume_type = io1
volume_iops = 200
...

[ebs custom2]
shared_dir = vol2
...

...
```

**Topics**
+ [

## `shared_dir`
](#ebs-shared-dir)
+ [

## `ebs_kms_key_id`
](#ebs-kms-key-id)
+ [

## `ebs_snapshot_id`
](#ebs-snapshot-id)
+ [

## `ebs_volume_id`
](#ebs-volume-id)
+ [

## `encrypted`
](#encrypted)
+ [

## `volume_iops`
](#volume-iops)
+ [

## `volume_size`
](#volume-size)
+ [

## `volume_throughput`
](#volume-throughput)
+ [

## `volume_type`
](#volume-type)

## `shared_dir`
<a name="ebs-shared-dir"></a>

(필수)**** 공유 Amazon EBS 볼륨이 탑재될 경로를 지정합니다.

이 파라미터는 여러 Amazon EBS 볼륨을 사용할 때 필요합니다.

Amazon EBS 볼륨 하나를 사용하는 경우 이 옵션은 [`[cluster]` 섹션](cluster-definition.md)에 지정된 [`shared_dir`](cluster-definition.md#cluster-shared-dir)을 덮어씁니다. 다음 예에서는 볼륨이 `/vol1`에 탑재됩니다.

```
shared_dir = vol1
```

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `ebs_kms_key_id`
<a name="ebs-kms-key-id"></a>

**(선택 사항)** 암호화에 사용할 사용자 지정 AWS KMS 키를 지정합니다.

이 파라미터는 `encrypted = true`와 함께 사용해야 합니다. 또한 사용자 지정 [`ec2_iam_role`](cluster-definition.md#ec2-iam-role)이 있어야 합니다.

자세한 내용은 [사용자 지정 KMS 키를 사용한 디스크 암호화](tutorials_04_encrypted_kms_fs.md) 항목을 참조하세요.

```
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `ebs_snapshot_id`
<a name="ebs-snapshot-id"></a>

(선택 사항)**** 스냅샷을 볼륨의 소스로 사용하는 경우 Amazon EBS 스냅샷 ID를 정의합니다.

기본값이 없습니다.

```
ebs_snapshot_id = snap-xxxxx
```

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `ebs_volume_id`
<a name="ebs-volume-id"></a>

(선택 사항)**** 헤드 노드에 연결할 기존 Amazon EBS 볼륨의 볼륨 ID를 정의합니다.

기본값이 없습니다.

```
ebs_volume_id = vol-xxxxxx
```

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `encrypted`
<a name="encrypted"></a>

(선택 사항)**** Amazon EBS 볼륨을 암호화할지 여부를 지정합니다. 참고: 스냅샷과 함께 사용하지 마세요**.

기본값은 `false`입니다.

```
encrypted = false
```

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `volume_iops`
<a name="volume-iops"></a>

(선택 사항)**** `io1`, `io2` 및 `gp3` 유형 볼륨의 IOPS 수를 정의합니다.

기본값, 지원되는 값, `volume_iops`와 `volume_size`의 비율 등은 [`volume_type`](raid-section.md#raid-volume-type) 및 [`volume_size`](#volume-size)에 따라 달라집니다.

`volume_type` = `io1`  
기본 `volume_iops` = 100  
지원되는 값 `volume_iops` = 100-64000 †  
최대 `volume_iops`:`volume_size` 비율은 GiB당 50 IOPS입니다. 5000 IOPS에는 최소 100GiB의 `volume_size` 필요합니다.

`volume_type` = `io2`  
기본 `volume_iops` = 100  
지원되는 값 `volume_iops` = 100-64000 (`io2` 블록 익스프레스 볼륨의 경우 256000) †  
최대 `volume_iops`:`volume_size` 비율은 GiB당 500 IOPS입니다. 5000 IOPS에는 최소 10GiB의 `volume_size`가 필요합니다.

`volume_type` = `gp3`  
기본 `volume_iops` = 3000  
지원되는 값 `volume_iops` = 3000-16000 †  
최대 `volume_iops`:`volume_size` 비율은 GiB당 500 IOPS입니다. 5000 IOPS에는 최소 10GiB의 `volume_size` 필요합니다.

```
volume_iops = 200
```

[업데이트 정책: 업데이트 중에 이 설정을 변경할 수 있습니다.](using-pcluster-update.md#update-policy-setting-supported)

† 최대 IOPS는 32,000 IOPS 이상으로 프로비저닝된 [Nitro 시스템 기반 인스턴스에](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances)서만 보장됩니다. 다른 인스턴스는 최대 32,000 IOPS를 보장합니다. [볼륨을 수정하지 않는 한](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html) 이전 `io1` 볼륨은 전체 성능에 도달할 수 없습니다. `io2` 블록 익스프레스 볼륨은 최대 256,000의 `volume_iops` 값을 지원합니다. 자세한 내용을 알아보려면 *Amazon EC2 사용 설명서*의 [`io2` Block Express 볼륨(평가판)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express)를 참조하세요.

## `volume_size`
<a name="volume-size"></a>

(선택 사항)**** 생성할 볼륨의 크기(GiB)를 지정합니다(스냅샷을 사용하지 않는 경우).

기본 값과 지원되는 값은 [`volume_type`](#volume-type)에 따라 달라집니다.

`volume_type` = `standard`  
기본 `volume_size` = 20GiB  
지원되는 값 `volume_size` = 1\$11024GiB

`volume_type` = `gp2`, `io1`, `io2` 및 `gp3`  
기본 `volume_size` = 20GiB  
지원되는 값 `volume_size` = 1\$116384GiB

`volume_type` = `sc1` 및 `st1`  
기본 `volume_size` = 500GiB  
지원되는 값 `volume_size` = 500\$116384GiB

```
volume_size = 20
```

**참고**  
 AWS ParallelCluster 버전 2.10.1 이전에는 모든 볼륨 유형의 기본값이 20GiB였습니다.

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `volume_throughput`
<a name="volume-throughput"></a>

(선택 사항)**** `gp3` 볼륨 유형의 처리량을 MiB/s 단위로 정의합니다.

기본값은 `125`입니다.

지원되는 값 `volume_throughput` = 125\$11000MiB/s

`volume_throughput`:`volume_iops`의 비율은 0.25를 초과할 수 없습니다. 1000MiB/s의 최대 처리량을 위해서는 `volume_iops` 설정이 최소 4000이어야 합니다.

```
volume_throughput = 1000
```

**참고**  
 AWS ParallelCluster 버전 2.10.1에서에 대한 지원이 `volume_throughput` 추가되었습니다.

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)

## `volume_type`
<a name="volume-type"></a>

(선택 사항)**** 시작할 볼륨의 [Amazon EBS 볼륨 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)을 지정합니다.

유효한 옵션은 다음 볼륨 유형입니다.

`gp2`, `gp3`  
General Purpose SSD

`io1`, `io2`  
Provisioned IOPS SSD

`st1`  
처리량 최적화 HDD

`sc1`  
콜드 HDD

`standard`  
이전 세대 마그네틱

자세한 내용을 알아보려면 Amazon EC2 사용 설명서**의 [Amazon EBS 볼륨 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)을 참조하세요.

기본값은 `gp2`입니다.

```
volume_type = io2
```

**참고**  
 AWS ParallelCluster 버전 2.10.1에서 `gp3` 및에 대한 지원이 `io2` 추가되었습니다.

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다.](using-pcluster-update.md#update-policy-fail)