Build 섹션 - AWS ParallelCluster
Build 속성

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

Build 섹션

(필수) 이미지를 빌드할 구성을 지정합니다.

Build:
  Imds:
    ImdsSupport: string
  InstanceType: string
  SubnetId: string
  ParentImage: string
  Iam:
    InstanceRole: string
    InstanceProfile: string
    CleanupLambdaRole: string
    AdditionalIamPolicies:
      - Policy: string
    PermissionsBoundary: string
  Components:
    - Type: string
      Value: string
  Tags:
    - Key: string
      Value: string
  SecurityGroupIds:
    - string
  UpdateOsPackages:
    Enabled: boolean
  Installation:
    NvidiaSoftware: 
      Enabled: boolean
    LustreClient:
      Enabled: boolean

Build 속성

InstanceType(필수, String)

이미지를 빌드하는 데 사용되는 인스턴스의 인스턴스 유형을 지정합니다.

SubnetId(선택 사항, String)

이미지를 빌드할 인스턴스를 프로비저닝할 기존 서브넷의 ID를 지정합니다. 제공된 서브넷에는 인터넷 액세스가 필요합니다.

주의

pcluster build-image는 기본 VPC를 사용합니다. AWS Control Tower 또는 AWS 랜딩 존을 사용하여 기본 VPC를 삭제한 경우 서브넷 ID를 지정해야 합니다.

ParentImage(필수, String)

기본 이미지를 지정합니다. 상위 이미지는 동일한 버전의 비 AWS ParallelCluster AMI 또는 공식 AWS ParallelCluster AMI일 수 있습니다. 다른 버전의 AWS ParallelCluster 공식 또는 사용자 지정 AMI는 사용할 수 없습니다 AWS ParallelCluster. 형식은 이미지 arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion의 ARN 또는 AMI ID ami-12345678여야 합니다.

SecurityGroupIds(선택 사항, [String])

이미지의 보안 그룹 ID의 목록을 지정합니다.

Imds

Imds 속성

(선택 사항) Amazon EC2 ImageBuilder 빌드 및 테스트 인스턴스 메타데이터 서비스(IMDS) 설정을 지정합니다.

Imds:
  ImdsSupport: string
ImdsSupport(선택 사항, String)

Amazon EC2 ImageBuilder 빌드 및 테스트 인스턴스에서 지원되는 IMDS 버전을 지정합니다. 지원되는 값은 v2.0 및 v1.0입니다. 기본값은 v2.0입니다.

ImdsSupport이 v1.0로 설정되어 있으면 IMDSv1 및 IMDSv2가 모두 지원됩니다.

ImdsSupport이 v2.0로 설정되어 있으면 IMDSv2만 지원됩니다.

자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 IMDSv2 사용을 참조하세요.

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

참고

AWS ParallelCluster 버전 3.7.0부터 ImdsSupport 기본값은 입니다v2.0. 사용자 지정 작업 호출에서 IMDSv1을 IMDSv2를 교체하고 ImdsSupport을 v2.0로 설정하는 것이 좋습니다.

AWS ParallelCluster 버전 3.3.0에서 Imds /에 대한 지원이 ImdsSupport 추가되었습니다.

Iam

Iam 속성

(선택 사항) 이미지 빌드의 IAM 리소스를 지정합니다.

Iam:
  InstanceRole: string
  InstanceProfile: string
  CleanupLambdaRole: string
  AdditionalIamPolicies:
    - Policy: string
  PermissionsBoundary: string
InstanceProfile(선택 사항, String)

EC2 Image Builder 인스턴스의 기본 인스턴스 프로파일을 재정의할 인스턴스 프로파일을 지정합니다. InstanceProfile, InstanceRole, AdditionalIamPolicies는 함께 지정할 수 없습니다. 형식은 arn:Partition:iam::Account:instance-profile/InstanceProfileName입니다.

InstanceRole(선택 사항, String)

EC2 Image Builder 인스턴스의 기본 인스턴스 역할을 재정의할 인스턴스 역할을 지정합니다. InstanceProfile, InstanceRole, AdditionalIamPolicies는 함께 지정할 수 없습니다. 형식은 arn:Partition:iam::Account:role/RoleName입니다.

CleanupLambdaRole(선택 사항, String)

빌드 완료 시 빌드 아티팩트를 제거하는 AWS CloudFormation 사용자 지정 리소스를 지원하는 AWS Lambda 함수에 사용할 IAM 역할의 ARN입니다. Lambda를 역할을 맡도록 허용된 보안 주체로 구성해야 합니다. 형식은 arn:Partition:iam::Account:role/RoleName입니다.

AdditionalIamPolicies (선택 사항)

사용자 지정 AMI를 생성하는 데 사용되는 EC2 Image Builder 인스턴스에 연결할 추가 IAM 정책을 지정합니다.

AdditionalIamPolicies:
  - Policy: string
Policy(선택 사항, [String])

IAM 정책 목록 형식은 arn:Partition:iam::Account:policy/PolicyName입니다.

PermissionsBoundary(선택 사항, String)

AWS ParallelCluster에서 생성한 모든 역할의 권한 경계로 사용할 IAM 정책의 ARN IAM 권한 경계에 대한 자세한 정보는 IAM 사용 설명서의 IAM 엔터티에 대한 권한 경계를 참조하세요. 형식은 arn:Partition:iam::Account:policy/PolicyName입니다.

Components

Components 속성

(선택 사항) AWS ParallelCluster에서 기본적으로 제공하는 구성 요소 외에 AMI 빌드 프로세스 중에 사용할 Amazon EC2 ImageBuilder 구성 요소를 지정합니다. 이러한 구성 요소를 사용하여 AMI 빌드 프로세스를 사용자 지정할 수 있습니다. 자세한 내용은 AWS ParallelCluster AMI 사용자 지정 항목을 참조하세요.

Components:
  - Type: string
    Value: string
Type(선택 사항, String)

구성 요소의 유형-값 쌍의 유형을 지정합니다. 유형은 arn 또는 script일 수 있습니다.

Value(선택 사항, String)

구성 요소의 유형-값 쌍의 값을 지정합니다. 유형이 arn인 경우 이것이 EC2 Image Builder 구성 요소의 ARN입니다. 유형이 script인 경우 이것이 EC2 Image Builder 구성 요소를 생성할 때 사용할 스크립트를 가리키는 https 또는 s3 링크입니다.

Tags

Tags 속성

(선택 사항) AMI를 구축하는 데 사용되는 리소스에 설정할 태그 목록을 지정합니다.

Tags:
  - Key: string
    Value: string
Key(선택 사항, String)

태그의 이름을 정의합니다.

Value(선택 사항, String)

태그의 값을 정의합니다.

UpdateOsPackages

UpdateOsPackages 속성

(선택 사항) AWS ParallelCluster 소프트웨어 스택을 설치하기 전에 운영 체제를 업데이트할지 여부를 지정합니다.

UpdateOsPackages:
  Enabled: boolean
Enabled(선택 사항, Boolean)

true인 경우 AWS ParallelCluster 소프트웨어를 설치하기 전에 OS가 업데이트되고 재부팅됩니다. 기본값은 false입니다.

참고

UpdateOsPackages가 활성화되면 커널을 포함하여 사용 가능한 모든 OS 패키지가 업데이트됩니다. 고객은 업데이트가 업데이트에 포함되지 않은 AMI 종속성과 호환되는지 확인할 책임이 있습니다.

예를 들어 커널 AWS ParallelCluster 버전 Y.0 및 일부 구성 요소 버전 Z.0과 함께 제공되는 버전 X.0용 AMI를 빌드한다고 가정해 보겠습니다. 사용 가능한 업데이트에 구성 요소 Z.0에 대한 업데이트가 없는 업데이트된 커널 버전 Y.1이 포함되어 있다고 가정해 보겠습니다. UpdateOsPackages를 활성화하기 전에 구성 요소 Z.0이 커널 Y.1을 지원하는지 확인하는 것은 사용자의 책임입니다.

Installation

Installation 속성

(선택 사항) 이미지에 설치할 추가 소프트웨어를 지정합니다.

Installation:
  NvidiaSoftware: 
    Enabled: boolean
  LustreClient:
    Enabled: boolean
NvidiaSoftware 속성(선택 사항)

설치할 Nvidia 소프트웨어를 지정합니다.

NvidiaSoftware: 
    Enabled: boolean
Enabled(선택 사항, boolean)

true인 경우 Nvidia GPU 드라이버와 CUDA가 설치됩니다. 기본값은 false입니다.

LustreClient 속성(선택 사항)

Amazon FSx Lustre 클라이언트가 설치되도록 지정합니다.

LustreClient:
    Enabled: boolean
Enabled(선택 사항, boolean)

true인 경우 Lustre 클라이언트가 설치됩니다. 기본값은 true입니다.