

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

# `[cluster]` 섹션
<a name="cluster-definition"></a>

클러스터를 생성하는 데 사용할 수 있는 클러스터 템플릿을 정의합니다. 구성 파일은 여러 `[cluster]` 섹션을 포함할 수 있습니다.

동일한 클러스터 템플릿을 사용하여 여러 클러스터를 만들 수 있습니다.

형식은 `[cluster cluster-template-name]`입니다. [`[global]` 섹션](global.md)의 [`cluster_template`](global.md#cluster-template) 설정으로 이름이 지정된 [`[cluster]` 섹션](#cluster-definition)이 기본적으로 사용되지만 [`pcluster`](pcluster.md) 명령줄에서 재정의할 수 있습니다.

*cluster-template-name*은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

```
[cluster default]
```

**Topics**
+ [`additional_cfn_template`](#additional-cfn-template)
+ [`additional_iam_policies`](#additional-iam-policies)
+ [`base_os`](#base-os)
+ [`cluster_resource_bucket`](#cluster-resource-bucket-section)
+ [`cluster_type`](#cluster-type)
+ [`compute_instance_type`](#compute-instance-type)
+ [`compute_root_volume_size`](#compute-root-volume-size)
+ [`custom_ami`](#custom-ami-section)
+ [`cw_log_settings`](#cw-log-settings)
+ [`dashboard_settings`](#dashboard-settings)
+ [`dcv_settings`](#dcv-settings)
+ [`desired_vcpus`](#desired-vcpus)
+ [`disable_cluster_dns`](#disable-cluster-dns-settings)
+ [`disable_hyperthreading`](#disable-hyperthreading)
+ [`ebs_settings`](#ebs-settings)
+ [`ec2_iam_role`](#ec2-iam-role)
+ [`efs_settings`](#efs-settings)
+ [`enable_efa`](#enable-efa)
+ [`enable_efa_gdr`](#enable-efa-gdr)
+ [`enable_intel_hpc_platform`](#enable-intel-hpc-platform)
+ [`encrypted_ephemeral`](#encrypted-ephemeral)
+ [`ephemeral_dir`](#ephemeral-dir)
+ [`extra_json`](#extra-json)
+ [`fsx_settings`](#fsx-settings)
+ [`iam_lambda_role`](#iam-lambda-role)
+ [`initial_queue_size`](#configuration-initial-queue-size)
+ [`key_name`](#key-name)
+ [`maintain_initial_size`](#maintain-initial-size)
+ [`master_instance_type`](#master-instance-type)
+ [`master_root_volume_size`](#master-root-volume-size)
+ [`max_queue_size`](#configuration-max-queue-size)
+ [`max_vcpus`](#max-vcpus)
+ [`min_vcpus`](#min-vcpus)
+ [`placement`](#placement)
+ [`placement_group`](#placement-group)
+ [`post_install`](#post-install)
+ [`post_install_args`](#post-install-args)
+ [`pre_install`](#pre-install)
+ [`pre_install_args`](#pre-install-args)
+ [`proxy_server`](#proxy-server)
+ [`queue_settings`](#queue-settings)
+ [`raid_settings`](#raid-settings)
+ [`s3_read_resource`](#s3-read-resource)
+ [`s3_read_write_resource`](#s3-read-write-resource)
+ [`scaling_settings`](#scaling-settings)
+ [`scheduler`](#scheduler)
+ [`shared_dir`](#cluster-shared-dir)
+ [`spot_bid_percentage`](#spot-bid-percentage)
+ [`spot_price`](#spot-price)
+ [`tags`](#tags)
+ [`template_url`](#template-url)
+ [`vpc_settings`](#vpc-settings)

## `additional_cfn_template`
<a name="additional-cfn-template"></a>

**(선택 사항)** 클러스터와 함께 시작할 추가 AWS CloudFormation 템플릿을 정의합니다. 이 추가 템플릿은 클러스터 외부에 있지만 클러스터 수명 주기의 일부인 리소스를 생성하는 데 사용됩니다.

해당 값은 모든 파라미터가 제공된 퍼블릭 템플릿의 HTTP URL이어야 합니다.

기본값이 없습니다.

```
additional_cfn_template = https://<bucket-name>.s3.amazonaws.com/my-cfn-template.yaml
```

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

## `additional_iam_policies`
<a name="additional-iam-policies"></a>

(선택 사항)**** Amazon EC2에 대한 IAM 정책의 Amazon 리소스 이름(ARN) 목록을 쉼표로 구분하여 지정합니다. 이 목록은 쉼표로 구분된 AWS ParallelCluster 에서 필요한 권한 외에 클러스터에서 사용되는 루트 역할에 연결됩니다. IAM 정책 이름과 해당 ARN은 서로 다릅니다. 이름은 `additional_iam_policies`의 인수로 사용할 수 없습니다.

클러스터 노드의 기본 설정에 추가 정책을 추가하려는 경우 [`ec2_iam_role`](#ec2-iam-role) 설정을 사용하여 특정 EC2 정책을 추가하는 대신 `additional_iam_policies` 설정과 함께 추가 사용자 지정 IAM 정책을 전달하는 것이 좋습니다. 이는이 `additional_iam_policies`에 AWS ParallelCluster 필요한 기본 권한에 추가되기 때문입니다. 기존 [`ec2_iam_role`](#ec2-iam-role)에는 필요한 모든 권한이 포함되어야 합니다. 그러나 특성이 추가됨에 따라 필요한 권한이 릴리스마다 변경되는 경우가 많기 때문에 기존 [`ec2_iam_role`](#ec2-iam-role)는 더 이상 사용되지 않을 수 있습니다.

기본값이 없습니다.

```
additional_iam_policies = arn:aws:iam::123456789012:policy/CustomEC2Policy
```

**참고**  
[`additional_iam_policies`](#additional-iam-policies)에 대한 지원이 AWS ParallelCluster 버전 2.5.0에서 추가되었습니다.

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

## `base_os`
<a name="base-os"></a>

(필수)**** 클러스터에서 사용되는 OS 유형을 지정합니다.

사용 가능한 옵션은 다음과 같습니다.
+ `alinux2`
+ `centos7`
+ `ubuntu1804`
+ `ubuntu2004`

**참고**  
 AWS Graviton 기반 인스턴스의 경우 , `ubuntu1804`또는 `alinux2`만 지원`ubuntu2004`됩니다.

**참고**  
 AWS ParallelCluster 버전 2.11.4에서에 대한 지원이 제거`centos8`되었습니다. AWS ParallelCluster 버전 2.11.0에서 `alinux` 및 `ubuntu1604`에 대한 지원이 제거되었으며 `ubuntu2004`에 대한 지원이 추가되었습니다. AWS ParallelCluster 버전 `centos8` 2.10.0에서에 대한 지원이 추가되고에 대한 지원이 제거`centos6`되었습니다. AWS ParallelCluster 버전 2.6.0에서 `alinux2`에 대한 지원이 추가되었습니다. AWS ParallelCluster 버전 2.5.0에서 `ubuntu1404`에 대한 지원은 제거되었으며 `ubuntu1804`에 대한 지원이 추가되었습니다.

를 지원하지 않는 다음 표에 AWS 리전 언급된 특정 이외의 `centos7`. 다른 모든 AWS 상용 리전은 다음 운영 체제를 모두 지원합니다.


| 파티션(AWS 리전) | `alinux2` | `centos7` | `ubuntu1804` 및 `ubuntu2004` | 
| --- | --- | --- | --- | 
| 상용(모두 특별히 언급 AWS 리전 되지 않음) | True | True | True | 
| AWS GovCloud(미국 동부)(us-gov-east-1) | True | False | True | 
| AWS GovCloud(미국 서부)(us-gov-west-1) | True | False | True | 
| 중국(베이징)(cn-north-1) | True | False | True | 
| 중국(닝샤)(cn-northwest-1) | True | False | True | 

**참고**  
[`base_os`](#base-os) 파라미터는 클러스터에 로그인하는 데 사용되는 사용자 이름도 결정합니다.
+ `centos7`: `centos` 
+ `ubuntu1804` 및 `ubuntu2004`: `ubuntu` 
+ `alinux2`: `ec2-user` 

**참고**  
 AWS ParallelCluster 버전 2.7.0 이전에는 [`base_os`](#base-os) 파라미터가 선택 사항이었고 기본값은 이었습니다`alinux`. AWS ParallelCluster 버전 2.7.0부터 [`base_os`](#base-os) 파라미터가 필요합니다.

**참고**  
[`scheduler`](#scheduler) 파라미터가 `awsbatch`인 경우 `alinux2`만 지원됩니다.

```
base_os = alinux2
```

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

## `cluster_resource_bucket`
<a name="cluster-resource-bucket-section"></a>

(선택 사항)**** 클러스터를 생성할 때 생성되는 리소스를 호스트하는 데 사용되는 Amazon S3 버킷의 이름을 지정합니다. 버킷에 버전 관리를 활성화해야 합니다. 자세한 내용은 Amazon Simple Storage Service 사용 설명서**의 [버전 관리 사용](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html)을 참조하세요. 이 버킷은 여러 클러스터에 사용할 수 있습니다. 버킷이 클러스터와 동일한 리전에 있어야 합니다.

이 파라미터를 지정하지 않으면 클러스터를 생성할 때 새 버킷이 생성됩니다. 새 버킷의 이름은 `parallelcluster-random_string`입니다. 이 이름에서 *random\$1string*은 임의의 영숫자 문자열입니다. 모든 클러스터 리소스는 형식의 경로에 있는이 버킷에 저장됩니다`bucket_name/resource_directory`. `resource_directory`에는 형식이 있습니다. `stack_name-random_string`여기서 *stack\$1name*은에서 사용하는 CloudFormation 스택 중 하나의 이름입니다 AWS ParallelCluster. *bucket\$1name*의 값은 `parallelcluster-clustername` 스택 출력의 `ResourcesS3Bucket` 값에서 찾을 수 있습니다. *resource\$1directory* 값은 동일한 스택의 `ArtifactS3RootDirectory` 출력 값에서 찾을 수 있습니다.

기본값은 `parallelcluster-random_string`입니다.

```
cluster_resource_bucket = amzn-s3-demo-bucket
```

**참고**  
 AWS ParallelCluster 버전 2.10.0에서에 대한 지원이 [`cluster_resource_bucket`](#cluster-resource-bucket-section) 추가되었습니다.

[업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다. 이 설정은 강제로 업데이트할 수 없습니다.](using-pcluster-update.md#update-policy-read-only-resource-bucket)

## `cluster_type`
<a name="cluster-type"></a>

(선택 사항)**** 시작할 클러스터의 유형을 정의합니다. [`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 [`[queue]` 섹션](queue-section.md)의 [`compute_type`](queue-section.md#queue-compute-type) 설정으로 바꿔야 합니다.

유효한 옵션은 `ondemand` 및 `spot`입니다.

기본값은 `ondemand`입니다.

스팟 인스턴스에 대한 자세한 내용은 [스팟 인스턴스 작업](spot.md) 섹션을 참조하세요.

**참고**  
스팟 인스턴스를 사용하려면 계정에 `AWSServiceRoleForEC2Spot` 서비스 연결 역할이 있어야 합니다. 를 사용하여 계정에서이 역할을 생성하려면 다음 명령을 AWS CLI실행합니다.  

```
aws iam create-service-linked-role --aws-service-name spot.amazonaws.com
```
자세한 내용은 *Amazon EC2 사용 설명서*에서 [스팟 인스턴스 요청을 위한 서비스 연결 역할](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-requests.html#service-linked-roles-spot-instance-requests)을 참조하세요.

```
cluster_type = ondemand
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `compute_instance_type`
<a name="compute-instance-type"></a>

(선택 사항)**** 클러스터 컴퓨팅 노드에 사용되는 Amazon EC2 인스턴스 유형을 정의합니다. 인스턴스 유형의 아키텍처는 [`master_instance_type`](#master-instance-type) 설정에 사용된 아키텍처와 동일해야 합니다. [`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 [`[compute_resource]` 섹션](compute-resource-section.md)의 [`instance_type`](compute-resource-section.md#compute-resource-instance-type) 설정으로 바꿔야 합니다.

`awsbatch` 스케줄러를 사용하는 경우 지원되는 인스턴스 유형 목록은 AWS Batch UI의 컴퓨팅 환경 생성을 참조하세요.

스케줄러가 `awsbatch`인 경우 기본적으로 `t2.micro`, `optimal`로 설정됩니다.

```
compute_instance_type = t2.micro
```

**참고**  
 AWS Graviton 기반 인스턴스( `A1` 및 `C6g` 인스턴스 포함)에 대한 지원이 AWS ParallelCluster 버전 2.8.0에 추가되었습니다.

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `compute_root_volume_size`
<a name="compute-root-volume-size"></a>

(선택 사항)**** ComputeFleet 루트 볼륨 크기를 기비바이트(GiB) 단위로 지정합니다. AMI는 `growroot`를 지원해야 합니다.

기본값은 `35`입니다.

**참고**  
2.5.0\$12.10.4 AWS ParallelCluster 버전의 경우 기본값은 25였습니다. AWS ParallelCluster 버전 2.5.0 이전의 기본값은 20이었습니다.

```
compute_root_volume_size = 35
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `custom_ami`
<a name="custom-ami-section"></a>

(선택 사항)**** 기본 [게시된 AMI](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/amis.txt) 대신 헤드 및 컴퓨팅 노드에 사용할 사용자 지정 AMI의 ID를 지정합니다. 자세한 내용은 [AMI 수정](tutorials_02_ami_customization.md#modify-an-aws-parallelcluster-ami) 또는 [사용자 지정 AWS ParallelCluster AMI 빌드](tutorials_02_ami_customization.md#build-a-custom-aws-parallelcluster-ami)을 참조하세요.

기본값이 없습니다.

```
custom_ami = ami-00d4efc81188687a0
```

사용자 지정 AMI를 시작하기 위해 추가 권한이 필요한 경우 이러한 권한을 사용자 및 헤드 노드 정책 모두에 추가해야 합니다.

예를 들어 사용자 지정 AMI에 암호화된 스냅샷이 연결된 경우 사용자 및 헤드 노드 정책 모두에 다음과 같은 추가 정책이 필요합니다.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:DescribeKey",
                "kms:ReEncrypt*",
                "kms:CreateGrant",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/<AWS_KMS_KEY_ID>"
            ]
        }
    ]
}
```

------

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

## `cw_log_settings`
<a name="cw-log-settings"></a>

(선택 사항)**** CloudWatch Logs 구성이 있는 `[cw_log]` 섹션을 식별합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[cw_log]` 섹션](cw-log-section.md), [Amazon CloudWatch 대시보드](cloudwatch-dashboard.md) 및 [Amazon CloudWatch Logs와 통합](cloudwatch-logs.md)을 참조하세요.

예를 들어, 다음 설정은 `[cw_log custom-cw]`을 시작하는 섹션이 CloudWatch Logs 구성에 사용되도록 지정합니다.

```
cw_log_settings = custom-cw
```

**참고**  
 AWS ParallelCluster 버전 2.6.0에서에 대한 지원이 [`cw_log_settings`](#cw-log-settings) 추가되었습니다.

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

## `dashboard_settings`
<a name="dashboard-settings"></a>

(선택 사항)**** CloudWatch 대시보드 구성을 사용하여 `[dashboard]` 섹션을 식별합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[dashboard]` 섹션](dashboard-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[dashboard custom-dashboard`을 시작하는 섹션이 CloudWatch 대시보드 구성에 사용되도록 지정합니다.

```
dashboard_settings = custom-dashboard
```

**참고**  
 AWS ParallelCluster 버전 2.10.0에서에 대한 지원이 [`dashboard_settings`](#dashboard-settings) 추가되었습니다.

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

## `dcv_settings`
<a name="dcv-settings"></a>

**(선택 사항)** Amazon DCV 구성이 있는 `[dcv]` 섹션을 식별합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[dcv]` 섹션](dcv-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[dcv custom-dcv]`를 시작하는 섹션이 Amazon DCV 구성에 사용되도록 지정합니다.

```
dcv_settings = custom-dcv
```

**참고**  
 AWS Graviton 기반 인스턴스에서는 Amazon DCV가 에서만 지원됩니다`alinux2`.

**참고**  
 AWS ParallelCluster 버전 2.5.0에서에 대한 지원이 [`dcv_settings`](#dcv-settings) 추가되었습니다.

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

## `desired_vcpus`
<a name="desired-vcpus"></a>

(선택 사항)**** 컴퓨팅 환경에 필요한 vCPU 수를 지정합니다. 스케줄러가 `awsbatch`인 경우에만 사용됩니다.

기본값은 `4`입니다.

```
desired_vcpus = 4
```

[업데이트 정책: 이 설정은 업데이트 중에 분석되지 않습니다.](using-pcluster-update.md#update-policy-setting-ignored)

## `disable_cluster_dns`
<a name="disable-cluster-dns-settings"></a>

(선택 사항)**** 클러스터의 DNS 항목을 생성하지 않아야 하는지 여부를 지정합니다. 기본적으로는 Route 53 호스팅 영역을 AWS ParallelCluster 생성합니다. `disable_cluster_dns`이 `true`로 설정되어 있으면 호스팅 영역이 생성되지 않습니다.

기본값은 `false`입니다.

```
disable_cluster_dns = true
```

**주의**  
클러스터가 제대로 작동하려면 이름 확인 시스템이 필요합니다. `disable_cluster_dns`이 `true`로 설정된 경우 추가 이름 확인 시스템도 제공해야 합니다.

**중요**  
[`disable_cluster_dns`](#disable-cluster-dns-settings) = `true`는 [`queue_settings`](#queue-settings) 설정이 지정된 경우에만 지원됩니다.

**참고**  
 AWS ParallelCluster 버전 2.9.1에서에 대한 지원이 [`disable_cluster_dns`](#disable-cluster-dns-settings) 추가되었습니다.

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

## `disable_hyperthreading`
<a name="disable-hyperthreading"></a>

(선택 사항)**** 헤드 및 컴퓨팅 노드에서 하이퍼 스레딩을 비활성화합니다. 모든 인스턴스 유형이 하이퍼 스레딩을 비활성화할 수 있는 것은 아닙니다. 하이퍼스레딩 비활성화를 지원하는 인스턴스 유형 목록은 *Amazon EC2 사용 설명서*에서 [인스턴스 유형별 각 CPU 코어의 CPU 코어 및 스레드](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-supported-instances-values)를 참조하세요. [`queue_settings`](#queue-settings) 설정이 정의되어 있으면 이 설정과 [`[queue]` 섹션](queue-section.md)의 [`disable_hyperthreading`](queue-section.md#queue-disable-hyperthreading) 설정 중에 하나만 정의할 수 있습니다.

기본값은 `false`입니다.

```
disable_hyperthreading = true
```

**참고**  
[`disable_hyperthreading`](#disable-hyperthreading)은 `scheduler = awsbatch`일 때만 헤드 노드에 영향을 줍니다.

**참고**  
 AWS ParallelCluster 버전 2.5.0에서 [`disable_hyperthreading`](#disable-hyperthreading)에 대한 지원이 추가되었습니다.

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

## `ebs_settings`
<a name="ebs-settings"></a>

(선택 사항)**** 헤드 노드에 탑재된 Amazon EBS 볼륨이 있는 `[ebs]` 섹션을 식별합니다. 여러 Amazon EBS 볼륨을 사용하는 경우 각 매개 변수를 쉼표로 구분하여 목록에 입력합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

최대 5개의 추가 Amazon EBS 볼륨이 지원됩니다.

자세한 내용은 [`[ebs]` 섹션](ebs-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[ebs custom1]` 및 `[ebs custom2]`를 시작하는 섹션이 Amazon EBS 볼륨에 사용되도록 지정합니다.

```
ebs_settings = custom1, custom2
```

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

## `ec2_iam_role`
<a name="ec2-iam-role"></a>

(선택 사항)**** 클러스터에 있는 모든 인스턴스에 연결된 Amazon EC2에 대한 기존 IAM 역할의 이름을 정의합니다. IAM 역할 이름과 Amazon 리소스 이름(ARN)은 다릅니다. ARN은 `ec2_iam_role`의 인수로 사용할 수 없습니다.

이 옵션을 지정하면 [`additional_iam_policies`](#additional-iam-policies) 설정이 무시됩니다. 클러스터 노드의 기본 설정에 추가 정책을 추가하려는 경우, `ec2_iam_role` 설정을 사용하는 대신 [`additional_iam_policies`](#additional-iam-policies) 설정과 함께 추가 사용자 지정 IAM 정책을 전달하는 것이 좋습니다.

이 옵션을 지정하지 않으면 Amazon EC2의 기본 AWS ParallelCluster IAM 역할이 사용됩니다. 자세한 내용은 [AWS Identity and Access Management 의 역할 AWS ParallelCluster](iam.md) 단원을 참조하십시오.

기본값이 없습니다.

```
ec2_iam_role = ParallelClusterInstanceRole
```

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

## `efs_settings`
<a name="efs-settings"></a>

(선택 사항)**** Amazon EFS 파일 시스템과 관련된 설정을 지정합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[efs]` 섹션](efs-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[efs customfs]`를 시작하는 섹션이 Amazon EFS 파일 시스템 구성에 사용되도록 지정합니다.

```
efs_settings = customfs
```

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

## `enable_efa`
<a name="enable-efa"></a>

(선택 사항)**** 있는 경우 Elastic Fabric Adapter(EFA)가 컴퓨팅 노드에 대해 활성화되도록 지정합니다. EFA를 지원하는 EC2 인스턴스 목록을 보려면 Linux 인스턴스용 Amazon EC2 사용 설명서의** [지원되는 인스턴스 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types)을 참조하세요. 자세한 내용은 [Elastic Fabric Adapter](efa.md) 단원을 참조하십시오. [`queue_settings`](#queue-settings) 설정이 정의되어 있으면 이 설정과 [`[queue]` 섹션](queue-section.md)의 [`enable_efa`](queue-section.md#queue-enable-efa) 설정 중에 하나만 정의할 수 있습니다. 클러스터 배치 그룹은 인스턴스 간의 대기 시간을 최소화하기 위해 사용해야 합니다. 자세한 내용은 [`placement`](#placement) 및 [`placement_group`](#placement-group) 섹션을 참조하세요.

```
enable_efa = compute
```

**참고**  
Arm 기반 Graviton2 인스턴스의 EFA에 대한 지원이 AWS ParallelCluster 버전 2.10.1에 추가되었습니다.

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

## `enable_efa_gdr`
<a name="enable-efa-gdr"></a>

**(선택 사항)** AWS ParallelCluster 버전 2.11.3부터는이 설정이 적용되지 않습니다. GPUDirect RDMA(원격 직접 메모리 액세스)에 대한 Elastic Fabric Adapter(EFA) 지원은 인스턴스 유형과 운영 체제에서 모두 지원되는 경우 항상 활성화됩니다.

**참고**  
AWS ParallelCluster 버전 2.10.0\$12.11.2: `compute`인 경우 컴퓨팅 노드에 대해 GPUDirect RDMA(원격 직접 메모리 액세스)에 대한 EFA(Elastic Fabric Adapter) 지원이 활성화되도록 지정합니다. 이 설정을 `compute`로 설정하려면 [`enable_efa`](#enable-efa) 설정을 `compute`로 설정해야 합니다. GPUDirect RDMA에 대한 EFA 지원은 특정 운영 체제([`base_os`](#base-os)가 `alinux2`, `centos7`, `ubuntu1804`, 또는 `ubuntu2004`)의 특정 인스턴스 유형(`p4d.24xlarge`)에서 지원됩니다. [`queue_settings`](#queue-settings) 설정이 정의되어 있으면 이 설정과 [`[queue]` 섹션](queue-section.md)의 [`enable_efa_gdr`](queue-section.md#queue-enable-efa-gdr) 설정 중에 하나만 정의할 수 있습니다. 클러스터 배치 그룹은 인스턴스 간의 대기 시간을 최소화하기 위해 사용해야 합니다. 자세한 내용은 [`placement`](#placement) 및 [`placement_group`](#placement-group) 섹션을 참조하세요.

```
enable_efa_gdr = compute
```

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

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `enable_intel_hpc_platform`
<a name="enable-intel-hpc-platform"></a>

(선택 사항)**** 있는 경우 Intel Parallel Studio에 대한 [최종 사용자 라이선스 계약](https://software.intel.com/en-us/articles/end-user-license-agreement)에 동의했음을 나타냅니다. 이렇게 하면 Intel Parallel Studio가 헤드 노드에 설치되고 컴퓨팅 노드와 공유됩니다. 이로 인해 헤드 노드의 부트스트랩을 수행하는 데 걸리는 시간이 몇 분 더 추가됩니다. [`enable_intel_hpc_platform`](#enable-intel-hpc-platform) 설정은 CentOS 7([`base_os`](#base-os)` = centos7`)에서만 지원됩니다.

기본값은 `false`입니다.

```
enable_intel_hpc_platform = true
```

**참고**  
[`enable_intel_hpc_platform`](#enable-intel-hpc-platform) 파라미터는 AWS Graviton 기반 인스턴스와 호환되지 않습니다.

**참고**  
 AWS ParallelCluster 버전 2.5.0에서 [`enable_intel_hpc_platform`](#enable-intel-hpc-platform)에 대한 지원이 추가되었습니다.

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

## `encrypted_ephemeral`
<a name="encrypted-ephemeral"></a>

(선택 사항)**** LUKS(Linux Unified Key Setup)를 사용하여 복구 불가능한 인 메모리 키로 임시 인스턴스 스토어 볼륨을 암호화합니다.

자세한 내용은 [https://gitlab.com/cryptsetup/cryptsetup/blob/master/README.md](https://gitlab.com/cryptsetup/cryptsetup/blob/master/README.md) 단원을 참조하십시오.

기본값은 `false`입니다.

```
encrypted_ephemeral = true
```

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

## `ephemeral_dir`
<a name="ephemeral-dir"></a>

(선택 사항)**** 인스턴스 스토어 볼륨이 사용되는 경우 탑재되는 경로를 정의합니다.

기본값은 `/scratch`입니다.

```
ephemeral_dir = /scratch
```

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

## `extra_json`
<a name="extra-json"></a>

(선택 사항)**** Chef `dna.json`에 병합되는 추가 JSON을 정의합니다. 자세한 내용은 [사용자 지정 AWS ParallelCluster AMI 빌드](tutorials_02_ami_customization.md) 단원을 참조하십시오.

기본값은 `{}`입니다.

```
extra_json = {}
```

**참고**  
 AWS ParallelCluster 버전 2.6.1부터는 시작 시간을 개선하기 위해 노드를 시작할 때 대부분의 설치 레시피를 기본적으로 건너뜁니다. 시작 시간을 희생하면서 이전 버전과의 호환성을 개선하기 위해 모든 설치 레시피를 실행하려면 [`extra_json`](#extra-json) 설정의 `cluster` 키에 `"skip_install_recipes" : "no"`를 추가하세요. 예제:  

```
extra_json = { "cluster" : { "skip_install_recipes" : "no" } }
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `fsx_settings`
<a name="fsx-settings"></a>

(선택 사항)**** FSx for Lustre 구성을 정의하는 섹션을 지정합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[fsx]` 섹션](fsx-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[fsx fs]`를 시작하는 섹션이 FSx for Lustre 구성에 사용되도록 지정합니다.

```
fsx_settings = fs
```

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

## `iam_lambda_role`
<a name="iam-lambda-role"></a>

**(선택 사항)** 기존 AWS Lambda 실행 역할의 이름을 정의합니다. 이 역할은 클러스터의 모든 Lambda 함수에 연결됩니다. 자세한 내용은AWS Lambda 개발자 가이드**의 [AWS Lambda 실행 역할](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html)을 참조하세요.

**참고**  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.

IAM 역할 이름과 Amazon 리소스 이름(ARN)은 다릅니다. ARN은 `iam_lambda_role`의 인수로 사용할 수 없습니다. [`ec2_iam_role`](#ec2-iam-role)와 `iam_lambda_role` 가 모두 정의되고 [`scheduler`](#scheduler)이 `sge`, `slurm` 또는 `torque`인 경우 역할이 생성되지 않습니다. [`scheduler`](#scheduler)이 `awsbatch`인 경우 [`pcluster start`](pcluster.start.md) 중에 역할이 생성됩니다. 예제 정책은 [SGE, Slurm, 또는 Torque를 사용하는 `ParallelClusterLambdaPolicy`](iam.md#parallelcluster-lambda-policy) 및 [`awsbatch`을 사용하는 `ParallelClusterLambdaPolicy`](iam.md#parallelcluster-lambda-policy-batch) 항목을 참조하세요.

기본값이 없습니다.

```
iam_lambda_role = ParallelClusterLambdaRole
```

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

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

## `initial_queue_size`
<a name="configuration-initial-queue-size"></a>

(선택 사항)**** 클러스터에서 컴퓨팅 노드로 시작할 초기 Amazon EC2 인스턴스 수를 설정합니다. [`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 제거한 다음 [`[compute_resource]` 섹션](compute-resource-section.md)의 [`initial_count`](compute-resource-section.md#compute-resource-initial-count) 설정으로 교체해야 합니다.

**참고**  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.

이 설정은 기존 스케줄러(SGE, Slurm 및 Torque)에만 적용할 수 있습니다. [`maintain_initial_size`](#maintain-initial-size) 설정이 `true`인 경우 [`initial_queue_size`](#configuration-initial-queue-size) 설정이 1 이상이어야 합니다.

스케줄러가 `awsbatch`인 경우 [`min_vcpus`](#min-vcpus)를 사용합니다.

기본값은 `2`입니다.

```
initial_queue_size = 2
```

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

## `key_name`
<a name="key-name"></a>

(선택 사항)**** 인스턴스에 대한 SSH 액세스를 활성화하는 기존 Amazon EC2 키 페어의 이름을 지정합니다.

```
key_name = mykey
```

**참고**  
 AWS ParallelCluster 버전 2.11.0 이전에는가 필수 설정`key_name`이었습니다.

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

## `maintain_initial_size`
<a name="maintain-initial-size"></a>

**참고**  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.

(선택 사항)**** 기존 스케줄러(SGE, Slurm 및 Torque)에 대한 오토 스케일링 그룹의 초기 크기를 유지합니다.

스케줄러가 `awsbatch`인 경우 [`desired_vcpus`](#desired-vcpus)를 사용합니다.

이 설정은 부울 플래그입니다. `true`로 설정하면 오토 스케일링 그룹의 구성원 수는 [`initial_queue_size`](#configuration-initial-queue-size)의 값보다 적지 않으며 [`initial_queue_size`](#configuration-initial-queue-size)의 값은 1 이상이어야 합니다. 클러스터는 [`max_queue_size`](#configuration-max-queue-size)의 값으로 여전히 스케일 업할 수 있습니다. `cluster_type = spot`인 경우 오토 스케일링 그룹에서 인스턴스가 중단될 수 있으며 크기가 [`initial_queue_size`](#configuration-initial-queue-size) 아래로 떨어질 수 있습니다.

`false`로 설정하면 필요 없는 리소스가 유휴 상태로 있지 않도록 오토 스케일링 그룹이 0개의 멤버로 스케일 다운될 수 있습니다.

[`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 제거한 다음 [`[compute_resource]` 섹션](compute-resource-section.md)의 [`initial_count`](compute-resource-section.md#compute-resource-initial-count) 및 [`min_count`](compute-resource-section.md#compute-resource-min-count) 설정으로 교체해야 합니다.

기본값은 `false`입니다.

```
maintain_initial_size = false
```

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

## `master_instance_type`
<a name="master-instance-type"></a>

(선택 사항)**** 헤드 노드에 사용되는 Amazon EC2 인스턴스 유형을 정의합니다. 인스턴스 유형의 아키텍처는 [`compute_instance_type`](#compute-instance-type) 설정에 사용된 아키텍처와 동일해야 합니다.

프리 티어가 AWS 리전 있는에서는 기본적으로 프리 티어 인스턴스 유형(`t2.micro` 또는 )으로 설정됩니다`t3.micro`. 프리 티어 AWS 리전 가 없는의 기본값은 입니다`t3.micro`. AWS 프리 티어에 대한 자세한 내용은 [AWS 프리 티어 FAQs](https://aws.amazon.com/free/free-tier-faqs/).

```
master_instance_type = t2.micro
```

**참고**  
 AWS ParallelCluster 버전 2.10.1 이전에는 기본적으로 모두 `t2.micro` 로 설정되었습니다 AWS 리전. AWS ParallelCluster 버전 2.10.0에서는 헤드 노드에 `p4d.24xlarge`가 지원되지 않았습니다. AWS Graviton 기반 인스턴스(예: `A1` 및 `C6g`)에 대한 지원이 AWS ParallelCluster 버전 2.8.0에 추가되었습니다.

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

## `master_root_volume_size`
<a name="master-root-volume-size"></a>

(선택 사항)**** 헤드 노드 루트 볼륨 크기를 기비바이트(GiB) 단위로 지정합니다. AMI는 `growroot`를 지원해야 합니다.

기본값은 `35`입니다.

**참고**  
2.5.0\$12.10.4 AWS ParallelCluster 버전의 경우 기본값은 25였습니다. AWS ParallelCluster 버전 2.5.0 이전의 기본값은 20이었습니다.

```
master_root_volume_size = 35
```

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

## `max_queue_size`
<a name="configuration-max-queue-size"></a>

(선택 사항)**** 클러스터에서 시작할 수 있는 최대 Amazon EC2 인스턴스 수를 설정합니다. [`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 제거한 다음 [`[compute_resource]` 섹션](compute-resource-section.md)의 [`max_count`](compute-resource-section.md#compute-resource-max-count) 설정으로 교체해야 합니다.

**참고**  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.

이 설정은 기존 스케줄러(SGE, Slurm 및 Torque)에만 적용할 수 있습니다.

스케줄러가 `awsbatch`인 경우 [`max_vcpus`](#max-vcpus)를 사용합니다.

기본값은 `10`입니다.

```
max_queue_size = 10
```

업데이트 정책: 이 설정은 업데이트 중에 변경할 수 있지만 값이 감소하면 컴퓨팅 플릿을 중지해야 합니다. 그렇지 않으면 기존 노드가 종료될 수 있습니다.

## `max_vcpus`
<a name="max-vcpus"></a>

(선택 사항)**** 컴퓨팅 환경의 최대 vCPU 수를 지정합니다. 스케줄러가 `awsbatch`인 경우에만 사용됩니다.

기본값은 `20`입니다.

```
max_vcpus = 20
```

[업데이트 정책: 업데이트 중에는 이 설정을 줄일 수 없습니다.](using-pcluster-update.md#update-policy-no-decrease)

## `min_vcpus`
<a name="min-vcpus"></a>

(선택 사항)**** `awsbatch` 스케줄러에 대한 오토 스케일링 그룹의 초기 크기를 유지합니다.

**참고**  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.

스케줄러가 SGE, Slurm 또는 Torque인 경우 [`maintain_initial_size`](#maintain-initial-size)를 사용합니다.

컴퓨팅 환경의 구성원은 [`min_vcpus`](#min-vcpus) 값보다 적을 수 없습니다.

기본값은 `0`입니다.

```
min_vcpus = 0
```

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

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

(선택 사항)**** 클러스터 배치 그룹 로직을 정의합니다. 이렇게 하면 전체 클러스터 또는 클러스터 배치 그룹을 사용할 컴퓨팅 인스턴스만 활성화됩니다.

[`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 제거한 다음 각 [`[queue]` 섹션](queue-section.md)에 대해 [`placement_group`](queue-section.md#queue-placement-group) 설정으로 교체해야 합니다. 다른 인스턴스 유형에 동일한 배치 그룹을 사용하는 경우 용량 부족 오류로 인해 요청이 실패할 가능성이 높습니다. 자세한 내용은 *Amazon EC2 사용 설명서*의 [부족한 인스턴스 용량](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/troubleshooting-launch.html#troubleshooting-launch-capacity)을 참조하세요. 배치 그룹을 미리 생성하여 각 대기열의 [`placement_group`](queue-section.md#queue-placement-group) 설정에 구성한 경우에만 여러 대기열이 공유할 수 있습니다. 각 [`[queue]` 섹션](queue-section.md)이 [`placement_group`](queue-section.md#queue-placement-group) 설정을 정의하는 경우 헤드 노드는 대기열의 배치 그룹에 속할 수 없습니다.

유효한 옵션은 `cluster` 또는 `compute`입니다.

스케줄러가 `awsbatch`인 경우에는 이 파라미터가 사용되지 않습니다.

기본값은 `compute`입니다.

```
placement = compute
```

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

## `placement_group`
<a name="placement-group"></a>

(선택 사항)**** 클러스터 배치 그룹을 정의합니다. [`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 제거한 다음 [`[queue]` 섹션](queue-section.md)의 [`placement_group`](queue-section.md#queue-placement-group) 설정으로 교체해야 합니다.

유효한 옵션은 다음과 같습니다.
+ `DYNAMIC`
+ 기존의 Amazon EC2 클러스터 배치 그룹 이름입니다.

`DYNAMIC`으로 설정하면 고유의 배치 그룹이 클러스터 스택의 일부로 생성되고 삭제됩니다.

스케줄러가 `awsbatch`인 경우에는 이 파라미터가 사용되지 않습니다.

배치 그룹에 대한 자세한 내용은 *Amazon EC2 사용 설명서*의 [배치 그룹](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html)을 참조하세요. 다른 인스턴스 유형에 동일한 배치 그룹을 사용하는 경우 용량 부족 오류로 인해 요청이 실패할 가능성이 높습니다. 자세한 내용은 *Amazon EC2 사용 설명서*의 [부족한 인스턴스 용량](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/troubleshooting-launch.html#troubleshooting-launch-capacity)을 참조하세요.

기본값이 없습니다.

모든 인스턴스 유형이 클러스터 배치 그룹을 지원하는 것은 아닙니다. 예를 들어, `t3.micro`의 기본 인스턴스 유형은 클러스터 배치 그룹을 지원하지 않습니다. 클러스터 배치 그룹을 지원하는 인스턴스 유형에 대한 자세한 내용은 *Amazon EC2 사용 설명서*의 [클러스터 배치 그룹의 규칙 및 제한 사항](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#placement-groups-limitations-cluster)을 참조하세요. 배치 그룹 작업 시 팁은 [배치 그룹 및 인스턴스 시작 문제](troubleshooting.md#placement-groups-and-instance-launch-issues) 섹션을 참고하세요.

```
placement_group = DYNAMIC
```

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

## `post_install`
<a name="post-install"></a>

(선택 사항)**** 모든 노드 부트스트랩 작업이 완료된 후 실행되는 설치 후 스크립트의 URL을 지정합니다. 자세한 내용은 [사용자 지정 부트스트랩 작업](pre_post_install.md) 단원을 참조하십시오.

`awsbatch`를 스케줄러로 사용할 경우 사후 설치 스크립트는 헤드 노드에서만 실행됩니다.

파라미터 형식을 `http://hostname/path/to/script.sh` 또는 `s3://bucket-name/path/to/script.sh`로 지정할 수 있습니다.

기본값이 없습니다.

```
post_install = s3://<bucket-name>/my-post-install-script.sh
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `post_install_args`
<a name="post-install-args"></a>

(선택 사항)**** 사후 설치 스크립트에 전달할 인수의 목록을 따옴표로 묶어 지정합니다.

기본값이 없습니다.

```
post_install_args = "argument-1 argument-2"
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `pre_install`
<a name="pre-install"></a>

(선택 사항)**** 노드 배포 부트스트랩 작업이 시작되기 전에 실행되는 사전 설치 스크립트의 URL을 지정합니다. 자세한 내용은 [사용자 지정 부트스트랩 작업](pre_post_install.md) 단원을 참조하십시오.

`awsbatch`를 스케줄러로 사용할 경우 사전 설치 스크립트는 헤드 노드에서만 실행됩니다.

파라미터 형식을 `http://hostname/path/to/script.sh` 또는 `s3://bucket-name/path/to/script.sh`로 지정할 수 있습니다.

기본값이 없습니다.

```
pre_install = s3://bucket-name/my-pre-install-script.sh
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `pre_install_args`
<a name="pre-install-args"></a>

(선택 사항)**** 사전 설치 스크립트에 전달할 인수의 목록을 따옴표로 묶어 지정합니다.

기본값이 없습니다.

```
pre_install_args = "argument-3 argument-4"
```

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `proxy_server`
<a name="proxy-server"></a>

(선택 사항)**** HTTP 또는 HTTPS 프록시 서버, 일반적으로 `http://x.x.x.x:8080`을 정의합니다.

기본값이 없습니다.

```
proxy_server = http://10.11.12.13:8080
```

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

## `queue_settings`
<a name="queue-settings"></a>

**(선택 사항)** 클러스터가 동종 컴퓨팅 플릿 대신 대기열을 사용하도록 지정하고 사용되는 [`[queue]` 섹션을](queue-section.md) 지정합니다. 나열된 첫 번째 [`[queue]` 섹션은](queue-section.md) 기본 스케줄러 대기열입니다. `queue` 섹션 이름은 소문자로 시작해야 하고 30자 이내로 소문자, 숫자 및 하이픈(-)만 포함되어야 합니다.

**중요**  
[`queue_settings`](#queue-settings)은 [`scheduler`](#scheduler)가 `slurm`로 설정된 경우에만 지원됩니다. [`cluster_type`](#cluster-type), [`compute_instance_type`](#compute-instance-type), [`initial_queue_size`](#configuration-initial-queue-size), [`maintain_initial_size`](#maintain-initial-size), [`max_queue_size`](#configuration-max-queue-size), [`placement`](#placement), [`placement_group`](#placement-group) 및 [`spot_price`](#spot-price) 설정은 지정하지 않아야 합니다. [`disable_hyperthreading`](#disable-hyperthreading) 및 [`enable_efa`](#enable-efa) 설정은[`[cluster]` 섹션](#cluster-definition) 또는 [`[queue]` 섹션](queue-section.md)에서 지정할 수 있지만 둘 다에서 지정할 수는 없습니다.

[`[queue]` 섹션은](queue-section.md) 최대 5개까지 지원됩니다.

자세한 내용은 [`[queue]` 섹션](queue-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[queue q1]` 및 `[queue q2]`을 시작하는 섹션을 지정합니다.

```
queue_settings = q1, q2
```

**참고**  
 AWS ParallelCluster 버전 2.9.0에서에 대한 지원이 [`queue_settings`](#queue-settings) 추가되었습니다.

[업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.](using-pcluster-update.md#update-policy-compute-fleet)

## `raid_settings`
<a name="raid-settings"></a>

(선택 사항)**** Amazon EBS 볼륨 RAID 구성이 있는 `[raid]` 섹션을 식별합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[raid]` 섹션](raid-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[raid rs]`를 시작하는 섹션이 Auto Scaling 구성에 사용되도록 지정합니다.

```
raid_settings = rs
```

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

## `s3_read_resource`
<a name="s3-read-resource"></a>

**(선택 사항)** AWS ParallelCluster 노드에 읽기 전용 액세스 권한이 부여된 Amazon S3 리소스를 지정합니다.

예를 들어, `arn:aws:s3:::my_corporate_bucket*`은 *my\$1corporate\$1bucket* 버킷과 그 안에 있는 모든 객체에 대한 읽기 전용 액세스를 제공합니다.

형식에 대한 자세한 내용은 [Amazon S3 작업](s3_resources.md)을 참조하세요.

기본값이 없습니다.

```
s3_read_resource = arn:aws:s3:::my_corporate_bucket*
```

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

## `s3_read_write_resource`
<a name="s3-read-write-resource"></a>

(선택 사항)**** AWS ParallelCluster 노드에 읽기/쓰기 액세스를 부여할 Amazon S3 리소스를 지정합니다.

예를 들어, `arn:aws:s3:::my_corporate_bucket/Development/*`는 *my\$1corporate\$1bucket* 버킷의 `Development` 폴더에 있는 모든 객체에 대한 읽기/쓰기 액세스를 제공합니다.

형식에 대한 자세한 내용은 [Amazon S3 작업](s3_resources.md)을 참조하세요.

기본값이 없습니다.

```
s3_read_write_resource = arn:aws:s3:::my_corporate_bucket/*
```

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

## `scaling_settings`
<a name="scaling-settings"></a>

Auto Scaling 구성이 있는 `[scaling]` 섹션을 식별합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[scaling]` 섹션](scaling-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[scaling custom]`를 시작하는 섹션이 Auto Scaling 구성에 사용되도록 지정합니다.

```
scaling_settings = custom
```

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

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

(필수)**** 클러스터 스케줄러를 정의합니다.

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

`awsbatch`  
AWS Batch  
`awsbatch` 스케줄러에 대한 자세한 내용은 [네트워킹 설정](networking.md#awsbatch-networking) 및 [AWS Batch (`awsbatch`)](awsbatchcli.md)을 참조하세요.

`sge`  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.
Son of Grid Engine (SGE)

`slurm`  
Slurm Workload Manager (Slurm)

`torque`  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.
Torque Resource Manager (Torque)

**참고**  
 AWS ParallelCluster 버전 2.7.0 이전에는 `scheduler` 파라미터가 선택 사항이었고 기본값은 이었습니다`sge`. AWS ParallelCluster 버전 2.7.0부터는 `scheduler` 파라미터가 필요합니다.

```
scheduler = slurm
```

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

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

(선택 사항)**** 공유 Amazon EBS 볼륨이 탑재될 경로를 정의합니다.

다중 Amazon EBS 볼륨에는 이 옵션을 사용하지 마세요. 대신 각 [`[ebs]` 섹션](ebs-section.md)에 [`shared_dir`](#cluster-shared-dir) 값을 제공합니다.

여러 Amazon EBS 볼륨을 사용하는 방법에 대한 자세한 내용은 [`[ebs]` 섹션](ebs-section.md)을 참조하세요.

기본값은 `/shared`입니다.

다음 예제에서는 `/myshared`에 탑재된 공유 Amazon EBS 볼륨을 보여줍니다.

```
shared_dir = myshared
```

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

## `spot_bid_percentage`
<a name="spot-bid-percentage"></a>

(선택 사항)**** `awsbatch`가 스케줄러인 경우 ComputeFleet의 최고 스팟 가격을 계산하는 데 사용되는 온디맨드 비율을 설정합니다.

값을 지정하지 않으면 온디맨드 가격 이하의 현재 스팟 시장 가격이 선택됩니다.

```
spot_bid_percentage = 85
```

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

## `spot_price`
<a name="spot-price"></a>

**참고**  
버전 2.11.5부터 SGE 또는 Torque 스케줄러 사용을 지원하지 AWS ParallelCluster 않습니다.

(선택 사항)**** 기존 스케줄러(SGE, Slurm 및 Torque)에서 ComputeFleet에 대한 최고 스팟 가격을 설정할 수 있습니다. [`cluster_type`](#cluster-type) 설정이 `spot`으로 설정된 경우에만 사용됩니다. 값을 지정하지 않으면 온디맨드 가격 이하의 스팟 가격이 부과됩니다. [`queue_settings`](#queue-settings) 설정이 정의된 경우 이 설정을 제거한 다음 [`[compute_resource]` 섹션](compute-resource-section.md)의 [`spot_price`](compute-resource-section.md#compute-resource-spot-price) 설정으로 교체해야 합니다.

스케줄러가 `awsbatch`인 경우 [spot\$1bid\$1percentage](#spot-bid-percentage)를 사용합니다.

필요에 맞는 입찰 스팟 인스턴스를 찾는 데 도움이 필요한 경우 [스팟 인스턴스 어드바이저](https://aws.amazon.com/ec2/spot/instance-advisor/)를 참조하세요.

```
spot_price = 1.50
```

**참고**  
 AWS ParallelCluster 버전 2.5.0에서는 `cluster_type = spot` [`spot_price`](#spot-price)를 지정하지 않으면 ComputeFleet의 인스턴스 시작이 실패합니다. 이는 AWS ParallelCluster 버전 2.5.1에서 수정되었습니다.

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

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

**(선택 사항)** 사용할 태그를 정의합니다 CloudFormation.

--tags**를 통해 명령줄 태그를 지정하면 이러한 태그는 구성 태그와 병합됩니다.

명령줄 태그는 동일한 키가 있는 구성 태그를 덮어씁니다.

태그는 JSON 형식입니다. 중괄호 밖에 따옴표를 사용하지 마세요.

자세한 내용을 알아보려면AWS CloudFormation 사용 설명서**의 [CloudFormation 리소스 태그 유형](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html)을 참조하세요.

```
tags = {"key" : "value", "key2" : "value2"}
```

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

**참고**  
업데이트 정책에서는 AWS ParallelCluster 버전 2.8.0에서 버전 2.9.1까지의 `tags` 설정 변경을 지원하지 않았습니다.  
버전 2.10.0에서 버전 2.11.7의 경우 `tags` 설정 변경을 지원하는 나열된 업데이트 정책이 정확하지 않습니다. 이 설정을 수정할 때는 클러스터 업데이트가 지원되지 않습니다.

## `template_url`
<a name="template-url"></a>

**(선택 사항)** 클러스터를 생성하는 데 사용되는 AWS CloudFormation 템플릿의 경로를 정의합니다.

업데이트는 원래 스택을 생성하는 데 사용된 템플릿을 사용합니다.

기본값은 `https://aws_region_name-aws-parallelcluster.s3.amazonaws.com/templates/aws-parallelcluster-version.cfn.json`입니다.

**주의**  
이것은 고급 파라미터입니다. 이 설정을 변경할 때는 사용자의 주의가 필요합니다.

```
template_url = https://us-east-1-aws-parallelcluster.s3.amazonaws.com/templates/aws-parallelcluster-2.11.9.cfn.json
```

[업데이트 정책: 이 설정은 업데이트 중에 분석되지 않습니다.](using-pcluster-update.md#update-policy-setting-ignored)

## `vpc_settings`
<a name="vpc-settings"></a>

(필수)**** 클러스터가 배포되는 Amazon VPC 구성이 있는 `[vpc]` 섹션을 식별합니다. 섹션 이름은 문자로 시작해야 하고, 30자 이내로 문자, 숫자, 하이픈(-) 및 밑줄(\$1)만 포함되어야 합니다.

자세한 내용은 [`[vpc]` 섹션](vpc-section.md)을 참조하세요.

예를 들어, 다음 설정은 `[vpc public]`을 시작하는 섹션이 Amazon VPC 구성에 사용되도록 지정합니다.

```
vpc_settings = public
```

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