[cluster] 섹션 - AWS ParallelCluster

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

[cluster] 섹션

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

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

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

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

[cluster default]

additional_cfn_template

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

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

기본값이 없습니다.

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

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

additional_iam_policies

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

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

기본값이 없습니다.

additional_iam_policies = arn:aws:iam::123456789012:policy/CustomEC2Policy
참고

additional_iam_policies에 대한 지원이 AWS ParallelCluster 버전 2.5.0에서 추가되었습니다.

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

base_os

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

사용 가능한 옵션은 다음과 같습니다.

  • alinux2

  • centos7

  • ubuntu1804

  • ubuntu2004

참고

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

참고

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

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

파티션(AWS 리전) alinux2 centos7 ubuntu1804ubuntu2004
상용(모두 특별히 언급 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 파라미터는 클러스터에 로그인하는 데 사용되는 사용자 이름도 결정합니다.

  • centos7: centos

  • ubuntu1804ubuntu2004: ubuntu

  • alinux2: ec2-user

참고

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

참고

scheduler 파라미터가 awsbatch인 경우 alinux2만 지원됩니다.

base_os = alinux2

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

cluster_resource_bucket

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

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

기본값은 parallelcluster-random_string입니다.

cluster_resource_bucket = amzn-s3-demo-bucket
참고

AWS ParallelCluster 버전 2.10.0에서에 대한 지원이 cluster_resource_bucket 추가되었습니다.

업데이트 정책: 이 설정을 변경하면 업데이트가 허용되지 않습니다. 이 설정은 강제로 업데이트할 수 없습니다.

cluster_type

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

유효한 옵션은 ondemandspot입니다.

기본값은 ondemand입니다.

스팟 인스턴스에 대한 자세한 내용은 스팟 인스턴스 작업 섹션을 참조하세요.

참고

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

aws iam create-service-linked-role --aws-service-name spot.amazonaws.com

자세한 내용은 Amazon EC2 사용 설명서에서 스팟 인스턴스 요청을 위한 서비스 연결 역할을 참조하세요.

cluster_type = ondemand

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

compute_instance_type

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

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

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

compute_instance_type = t2.micro
참고

AWS Graviton 기반 인스턴스( A1C6g 인스턴스 포함)에 대한 지원이 AWS ParallelCluster 버전 2.8.0에 추가되었습니다.

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

compute_root_volume_size

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

기본값은 35입니다.

참고

2.5.0에서 2.10.4 사이의 AWS ParallelCluster 버전의 경우 기본값은 25였습니다. AWS ParallelCluster 버전 2.5.0 이전의 기본값은 20이었습니다.

compute_root_volume_size = 35

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

custom_ami

(선택 사항) 기본 게시된 AMI 대신 헤드 및 컴퓨팅 노드에 사용할 사용자 지정 AMI의 ID를 지정합니다. 자세한 내용은 AMI 수정 또는 사용자 지정 AWS ParallelCluster AMI 빌드을 참조하세요.

기본값이 없습니다.

custom_ami = ami-00d4efc81188687a0

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

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

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

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

cw_log_settings

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

자세한 내용은 [cw_log] 섹션, Amazon CloudWatch 대시보드Amazon CloudWatch Logs와 통합을 참조하세요.

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

cw_log_settings = custom-cw
참고

AWS ParallelCluster 버전 2.6.0에서에 대한 지원이 cw_log_settings 추가되었습니다.

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

dashboard_settings

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

자세한 내용은 [dashboard] 섹션을 참조하십시오.

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

dashboard_settings = custom-dashboard
참고

AWS ParallelCluster 버전 2.10.0에서에 대한 지원이 dashboard_settings 추가되었습니다.

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

dcv_settings

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

자세한 내용은 [dcv] 섹션을 참조하십시오.

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

dcv_settings = custom-dcv
참고

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

참고

AWS ParallelCluster 버전 2.5.0에서에 대한 지원이 dcv_settings 추가되었습니다.

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

desired_vcpus

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

기본값은 4입니다.

desired_vcpus = 4

업데이트 정책: 이 설정은 업데이트 중에 분석되지 않습니다.

disable_cluster_dns

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

기본값은 false입니다.

disable_cluster_dns = true
주의

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

중요

disable_cluster_dns = truequeue_settings 설정이 지정된 경우에만 지원됩니다.

참고

AWS ParallelCluster 버전 2.9.1에서에 대한 지원이 disable_cluster_dns 추가되었습니다.

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

disable_hyperthreading

(선택 사항) 헤드 및 컴퓨팅 노드에서 하이퍼 스레딩을 비활성화합니다. 모든 인스턴스 유형이 하이퍼 스레딩을 비활성화할 수 있는 것은 아닙니다. 하이퍼스레딩 비활성화를 지원하는 인스턴스 유형 목록은 Amazon EC2 사용 설명서에서 인스턴스 유형별 각 CPU 코어의 CPU 코어 및 스레드를 참조하세요. queue_settings 설정이 정의되어 있으면 이 설정과 [queue] 섹션disable_hyperthreading 설정 중에 하나만 정의할 수 있습니다.

기본값은 false입니다.

disable_hyperthreading = true
참고

disable_hyperthreading은 scheduler = awsbatch일 때만 헤드 노드에 영향을 줍니다.

참고

AWS ParallelCluster 버전 2.5.0에서 disable_hyperthreading에 대한 지원이 추가되었습니다.

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

ebs_settings

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

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

자세한 내용은 [ebs] 섹션을 참조하십시오.

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

ebs_settings = custom1, custom2

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

ec2_iam_role

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

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

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

기본값이 없습니다.

ec2_iam_role = ParallelClusterInstanceRole

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

efs_settings

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

자세한 내용은 [efs] 섹션을 참조하십시오.

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

efs_settings = customfs

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

enable_efa

(선택 사항) 있는 경우 Elastic Fabric Adapter(EFA)가 컴퓨팅 노드에 대해 활성화되도록 지정합니다. EFA를 지원하는 EC2 인스턴스 목록을 보려면 Linux 인스턴스용 Amazon EC2 사용 설명서의 지원되는 인스턴스 유형을 참조하세요. 자세한 내용은 Elastic Fabric Adapter 단원을 참조하십시오. queue_settings 설정이 정의되어 있으면 이 설정과 [queue] 섹션enable_efa 설정 중에 하나만 정의할 수 있습니다. 클러스터 배치 그룹은 인스턴스 간의 대기 시간을 최소화하기 위해 사용해야 합니다. 자세한 내용은 placementplacement_group 단원을 참조하세요.

enable_efa = compute
참고

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

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

enable_efa_gdr

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

참고

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

enable_efa_gdr = compute
참고

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

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

enable_intel_hpc_platform

(선택 사항) 있는 경우 Intel Parallel Studio에 대한 최종 사용자 라이선스 계약에 동의했음을 나타냅니다. 이렇게 하면 Intel Parallel Studio가 헤드 노드에 설치되고 컴퓨팅 노드와 공유됩니다. 이로 인해 헤드 노드의 부트스트랩을 수행하는 데 걸리는 시간이 몇 분 더 추가됩니다. enable_intel_hpc_platform 설정은 CentOS 7(base_os = centos7)에서만 지원됩니다.

기본값은 false입니다.

enable_intel_hpc_platform = true
참고

enable_intel_hpc_platform 파라미터는 AWS Graviton 기반 인스턴스와 호환되지 않습니다.

참고

AWS ParallelCluster 버전 2.5.0에서 enable_intel_hpc_platform에 대한 지원이 추가되었습니다.

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

encrypted_ephemeral

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

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

기본값은 false입니다.

encrypted_ephemeral = true

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

ephemeral_dir

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

기본값은 /scratch입니다.

ephemeral_dir = /scratch

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

extra_json

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

기본값은 {}입니다.

extra_json = {}
참고

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

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

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

fsx_settings

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

자세한 내용은 [fsx] 섹션을 참조하십시오.

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

fsx_settings = fs

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

iam_lambda_role

(선택 사항) 기존 AWS Lambda 실행 역할의 이름을 정의합니다. 이 역할은 클러스터의 모든 Lambda 함수에 연결됩니다. 자세한 내용은AWS Lambda 개발자 가이드AWS Lambda 실행 역할을 참조하세요.

참고

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

IAM 역할 이름과 Amazon 리소스 이름(ARN)은 다릅니다. ARN은 iam_lambda_role의 인수로 사용할 수 없습니다. ec2_iam_roleiam_lambda_role 가 모두 정의되고 schedulersge, slurm 또는 torque인 경우 역할이 생성되지 않습니다. schedulerawsbatch인 경우 pcluster start 중에 역할이 생성됩니다. 예제 정책은 SGE, Slurm, 또는 Torque를 사용하는 ParallelClusterLambdaPolicyawsbatch을 사용하는 ParallelClusterLambdaPolicy 항목을 참조하세요.

기본값이 없습니다.

iam_lambda_role = ParallelClusterLambdaRole
참고

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

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

initial_queue_size

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

참고

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

이 설정은 기존 스케줄러(SGE, Slurm 및 Torque)에만 적용할 수 있습니다. maintain_initial_size 설정이 true인 경우 initial_queue_size 설정이 1 이상이어야 합니다.

스케줄러가 awsbatch인 경우 min_vcpus를 사용합니다.

기본값은 2입니다.

initial_queue_size = 2

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

key_name

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

key_name = mykey
참고

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

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

maintain_initial_size

참고

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

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

스케줄러가 awsbatch인 경우 desired_vcpus를 사용합니다.

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

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

queue_settings 설정이 정의된 경우 이 설정을 제거한 다음 [compute_resource] 섹션initial_countmin_count 설정으로 교체해야 합니다.

기본값은 false입니다.

maintain_initial_size = false

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

master_instance_type

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

프리 티어가 AWS 리전 있는에서는 기본적으로 프리 티어 인스턴스 유형(t2.micro 또는 )으로 설정됩니다t3.micro. 프리 티어 AWS 리전 가 없는에서는 기본적으로 로 설정됩니다t3.micro. AWS 프리 티어에 대한 자세한 내용은 AWS 프리 티어 FAQs.

master_instance_type = t2.micro
참고

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

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

master_root_volume_size

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

기본값은 35입니다.

참고

2.5.0에서 2.10.4 사이의 AWS ParallelCluster 버전의 경우 기본값은 25였습니다. AWS ParallelCluster 버전 2.5.0 이전의 기본값은 20이었습니다.

master_root_volume_size = 35

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

max_queue_size

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

참고

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

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

스케줄러가 awsbatch인 경우 max_vcpus를 사용합니다.

기본값은 10입니다.

max_queue_size = 10

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

max_vcpus

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

기본값은 20입니다.

max_vcpus = 20

업데이트 정책: 업데이트 중에는 이 설정을 줄일 수 없습니다.

min_vcpus

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

참고

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

스케줄러가 SGE, Slurm 또는 Torque인 경우 maintain_initial_size를 사용합니다.

컴퓨팅 환경의 구성원은 min_vcpus 값보다 적을 수 없습니다.

기본값은 0입니다.

min_vcpus = 0

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

placement

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

queue_settings 설정이 정의된 경우 이 설정을 제거한 다음 각 [queue] 섹션에 대해 placement_group 설정으로 교체해야 합니다. 다른 인스턴스 유형에 동일한 배치 그룹을 사용하는 경우 용량 부족 오류로 인해 요청이 실패할 가능성이 높습니다. 자세한 내용은 Amazon EC2 사용 설명서부족한 인스턴스 용량을 참조하세요. 배치 그룹을 미리 생성하여 각 대기열의 placement_group 설정에 구성한 경우에만 여러 대기열이 공유할 수 있습니다. 각 [queue] 섹션placement_group 설정을 정의하는 경우 헤드 노드는 대기열의 배치 그룹에 속할 수 없습니다.

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

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

기본값은 compute입니다.

placement = compute

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

placement_group

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

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

  • DYNAMIC

  • 기존의 Amazon EC2 클러스터 배치 그룹 이름입니다.

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

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

배치 그룹에 대한 자세한 내용은 Amazon EC2 사용 설명서배치 그룹을 참조하세요. 다른 인스턴스 유형에 동일한 배치 그룹을 사용하는 경우 용량 부족 오류로 인해 요청이 실패할 가능성이 높습니다. 자세한 내용은 Amazon EC2 사용 설명서부족한 인스턴스 용량을 참조하세요.

기본값이 없습니다.

모든 인스턴스 유형이 클러스터 배치 그룹을 지원하는 것은 아닙니다. 예를 들어, t3.micro의 기본 인스턴스 유형은 클러스터 배치 그룹을 지원하지 않습니다. 클러스터 배치 그룹을 지원하는 인스턴스 유형에 대한 자세한 내용은 Amazon EC2 사용 설명서클러스터 배치 그룹의 규칙 및 제한 사항을 참조하세요. 배치 그룹 작업 시 팁은 배치 그룹 및 인스턴스 시작 문제 섹션을 참고하세요.

placement_group = DYNAMIC

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

post_install

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

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

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

기본값이 없습니다.

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

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

post_install_args

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

기본값이 없습니다.

post_install_args = "argument-1 argument-2"

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

pre_install

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

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

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

기본값이 없습니다.

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

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

pre_install_args

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

기본값이 없습니다.

pre_install_args = "argument-3 argument-4"

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

proxy_server

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

기본값이 없습니다.

proxy_server = http://10.11.12.13:8080

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

queue_settings

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

중요

queue_settings은 schedulerslurm로 설정된 경우에만 지원됩니다. cluster_type, compute_instance_type, initial_queue_size, maintain_initial_size, max_queue_size, placement, placement_groupspot_price 설정은 지정하지 않아야 합니다. disable_hyperthreadingenable_efa 설정은[cluster] 섹션 또는 [queue] 섹션에서 지정할 수 있지만 둘 다에서 지정할 수는 없습니다.

[queue] 섹션은 최대 5개까지 지원됩니다.

자세한 내용은 [queue] 섹션을 참조하십시오.

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

queue_settings = q1, q2
참고

AWS ParallelCluster 버전 2.9.0에서에 대한 지원이 queue_settings 추가되었습니다.

업데이트 정책: 업데이트를 위해 이 설정을 변경하려면 컴퓨팅 플릿을 중지해야 합니다.

raid_settings

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

자세한 내용은 [raid] 섹션을 참조하십시오.

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

raid_settings = rs

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

s3_read_resource

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

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

형식에 대한 자세한 내용은 Amazon S3 작업을 참조하세요.

기본값이 없습니다.

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

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

s3_read_write_resource

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

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

형식에 대한 자세한 내용은 Amazon S3 작업을 참조하세요.

기본값이 없습니다.

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

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

scaling_settings

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

자세한 내용은 [scaling] 섹션을 참조하십시오.

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

scaling_settings = custom

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

scheduler

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

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

awsbatch

AWS Batch

awsbatch 스케줄러에 대한 자세한 내용은 네트워킹 설정AWS Batch (awsbatch)을 참조하세요.

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

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

shared_dir

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

다중 Amazon EBS 볼륨에는 이 옵션을 사용하지 마세요. 대신 각 [ebs] 섹션에 shared_dir 값을 제공합니다.

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

기본값은 /shared입니다.

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

shared_dir = myshared

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

spot_bid_percentage

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

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

spot_bid_percentage = 85

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

spot_price

참고

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

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

스케줄러가 awsbatch인 경우 spot_bid_percentage를 사용합니다.

필요에 맞는 입찰 스팟 인스턴스를 찾는 데 도움이 필요한 경우 스팟 인스턴스 어드바이저를 참조하세요.

spot_price = 1.50
참고

AWS ParallelCluster 버전 2.5.0에서는 cluster_type = spot spot_price를 지정하지 않으면 ComputeFleet의 인스턴스 시작이 실패합니다. 이는 AWS ParallelCluster 버전 2.5.1에서 수정되었습니다.

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

tags

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

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

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

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

자세한 내용을 알아보려면AWS CloudFormation 사용 설명서AWS CloudFormation 리소스 태그 유형을 참조하세요.

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

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

참고

업데이트 정책에서는 AWS ParallelCluster 버전 2.8.0에서 버전 2.9.1까지의 tags 설정 변경을 지원하지 않았습니다.

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

template_url

(선택 사항) 클러스터를 생성하는 데 사용되는 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

업데이트 정책: 이 설정은 업데이트 중에 분석되지 않습니다.

vpc_settings

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

자세한 내용은 [vpc] 섹션을 참조하십시오.

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

vpc_settings = public

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