Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bagian dari CloudFormation template untuk AWS PCS
CloudFormation Template memiliki 1 atau lebih bagian yang masing-masing melayani tujuan tertentu. CloudFormation mendefinisikan format standar, sintaks, dan bahasa dalam template. Untuk informasi selengkapnya, lihat [Bekerja dengan CloudFormation templat](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) di *Panduan AWS CloudFormation Pengguna*.
CloudFormation template sangat dapat disesuaikan dan oleh karena itu formatnya dapat bervariasi. Untuk memahami bagian yang diperlukan dari CloudFormation template untuk membuat cluster AWS PCS, kami sarankan Anda memeriksa template sampel yang kami sediakan untuk membuat cluster sampel. Topik ini menjelaskan secara singkat bagian-bagian dari template sampel itu.
**penting**
Contoh kode dalam topik ini **tidak lengkap**. Kehadiran ellipsis (`[...]`) menunjukkan bahwa ada kode tambahan yang tidak ditampilkan. Untuk mengunduh CloudFormation template berformat YAML lengkap, lihat. [CloudFormation template untuk membuat contoh cluster AWS PCS](get-started-cfn-sample-templates.md)
**Contents**
+ [Header](#get-started-cfn-template-parts-header)
+ [Metadata](#get-started-cfn-template-parts-metadata)
+ [Parameter](#get-started-cfn-template-parts-parameters)
+ [Pemetaan](#get-started-cfn-template-parts-mappings)
+ [Sumber Daya](#get-started-cfn-template-parts-resources)
+ [Output](#get-started-cfn-template-parts-outputs)
## Header
```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: AWS Parallel Computing Service "getting started" cluster
```
`AWSTemplateFormatVersion`mengidentifikasi versi format template yang sesuai dengan template. Untuk informasi selengkapnya, lihat [sintaks versi format CloudFormation templat](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/format-version-structure.html) di *Panduan AWS CloudFormation Pengguna*.
`Transform`menentukan makro yang CloudFormation menggunakan untuk memproses template. Untuk informasi selengkapnya, lihat [bagian Transform CloudFormation template](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html) di *Panduan AWS CloudFormation Pengguna*. `AWS::Serverless-2016-10-31`Transformasi memungkinkan CloudFormation untuk memproses template yang ditulis dalam sintaks AWS Serverless Application Model (AWS SAM). Untuk informasi selengkapnya, lihat [`AWS::Serverless`mengubah](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html) dalam *Panduan AWS CloudFormation Pengguna*.
## Metadata
```
### Stack metadata
Metadata:
AWS::CloudFormation::Interface:
ParameterGroups:
- Label:
default: PCS Cluster configuration
Parameters:
- SlurmVersion
- ManagedAccounting
- AccountingPolicyEnforcement
- Label:
default: PCS ComputeNodeGroups configuration
Parameters:
- NodeArchitecture
- KeyName
- ClientIpCidr
- Label:
default: HPC Recipes configuration
Parameters:
- HpcRecipesS3Bucket
- HpcRecipesBranch
```
`metadata`Bagian CloudFormation template memberikan informasi tentang template itu sendiri. Template sampel membuat cluster komputasi kinerja tinggi (HPC) lengkap yang menggunakan AWS PCS. Bagian metadata dari template sampel mendeklarasikan parameter yang mengontrol cara CloudFormation meluncurkan (ketentuan) tumpukan yang sesuai. Ada parameter yang mengontrol pilihan arsitektur (`NodeArchitecture`), versi Slurm (`SlurmVersion`), dan kontrol akses (`KeyName`dan`ClientIpCidr`).
## Parameter
`Parameters`Bagian ini mendefinisikan parameter kustom untuk template. CloudFormation menggunakan definisi parameter ini untuk membangun dan memvalidasi formulir yang berinteraksi dengan Anda ketika Anda meluncurkan tumpukan dari template ini.
```
Parameters:
NodeArchitecture:
Type: String
Default: x86
AllowedValues:
- x86
- Graviton
Description: Processor architecture for the login and compute node instances
SlurmVersion:
Type: String
Default: 25.05
Description: Version of Slurm to use
AllowedValues:
- 24.11
- 25.05
ManagedAccounting:
Type: String
Default: 'disabled'
AllowedValues:
- 'enabled'
- 'disabled'
Description: Monitor cluster usage, manage access control, and enforce resource limits with Slurm accounting. Requires Slurm 24.11 or newer.
AccountingPolicyEnforcement:
Description: Specify which Slurm accounting policies to enforce
Type: String
Default: none
AllowedValues:
- none
- 'associations,limits,safe'
KeyName:
Description: SSH keypair to log in to the head node
Type: AWS::EC2::KeyPair::KeyName
AllowedPattern: ".+" # Required
ClientIpCidr:
Description: IP(s) allowed to access the login node over SSH. We recommend that you restrict it with your own IP/subnet (x.x.x.x/32 for your own ip or x.x.x.x/24 for range. Replace x.x.x.x with your own PUBLIC IP. You can get your public IP using tools such as https://ifconfig.co/)
Default: 127.0.0.1/32
Type: String
AllowedPattern: (\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})/(\d{1,2})
ConstraintDescription: Value must be a valid IP or network range of the form x.x.x.x/x.
HpcRecipesS3Bucket:
Type: String
Default: aws-hpc-recipes
Description: HPC Recipes for AWS S3 bucket
AllowedValues:
- aws-hpc-recipes
- aws-hpc-recipes-dev
HpcRecipesBranch:
Type: String
Default: main
Description: HPC Recipes for AWS release branch
AllowedPattern: '^(?!.*/\.git$)(?!.*/\.)(?!.*\\.\.)[a-zA-Z0-9-_\.]+$'
```
## Pemetaan
`Mappings`Bagian ini mendefinisikan pasangan kunci-nilai yang menentukan nilai berdasarkan kondisi atau dependensi tertentu.
```
Mappings:
Architecture:
AmiArchParameter:
Graviton: arm64
x86: x86_64
LoginNodeInstances:
Graviton: c7g.xlarge
x86: c6i.xlarge
ComputeNodeInstances:
Graviton: c7g.xlarge
x86: c6i.xlarge
```
## Sumber Daya
`Resources`Bagian ini mendeklarasikan AWS sumber daya untuk menyediakan dan mengkonfigurasi sebagai bagian dari tumpukan.
```
Resources:
[...]
```
Template menyediakan infrastruktur cluster sampel dalam lapisan. Dimulai dengan `Networking` untuk konfigurasi VPC. Penyimpanan disediakan oleh sistem ganda: `EfsStorage` untuk penyimpanan bersama dan `FSxLStorage` untuk penyimpanan berkinerja tinggi. Cluster inti didirikan melalui`PCSCluster`.
```
Networking:
Type: AWS::CloudFormation::Stack
Properties:
Parameters:
ProvisionSubnetsC: "False"
TemplateURL: !Sub 'https://${HpcRecipesS3Bucket}.s3.amazonaws.com/${HpcRecipesBranch}/recipes/net/hpc_large_scale/assets/main.yaml'
EfsStorage:
Type: AWS::CloudFormation::Stack
Properties:
Parameters:
SubnetIds: !GetAtt [ Networking, Outputs.DefaultPrivateSubnet ]
SubnetCount: 1
VpcId: !GetAtt [ Networking, Outputs.VPC ]
TemplateURL: !Sub 'https://${HpcRecipesS3Bucket}.s3.amazonaws.com/${HpcRecipesBranch}/recipes/storage/efs_simple/assets/main.yaml'
FSxLStorage:
Type: AWS::CloudFormation::Stack
Properties:
Parameters:
PerUnitStorageThroughput: 125
SubnetId: !GetAtt [ Networking, Outputs.DefaultPrivateSubnet ]
VpcId: !GetAtt [ Networking, Outputs.VPC ]
TemplateURL: !Sub 'https://${HpcRecipesS3Bucket}.s3.amazonaws.com/${HpcRecipesBranch}/recipes/storage/fsx_lustre/assets/persistent.yaml'
[...]
# Cluster
PCSCluster:
Type: AWS::PCS::Cluster
Properties:
Name: !Sub '${AWS::StackName}'
Size: SMALL
Scheduler:
Type: SLURM
Version: !Ref SlurmVersion
Networking:
SubnetIds:
- !GetAtt [ Networking, Outputs.DefaultPrivateSubnet ]
SecurityGroupIds:
- !GetAtt [ PCSSecurityGroup, Outputs.ClusterSecurityGroupId ]
```
Untuk sumber daya komputasi, template membuat dua grup node: `PCSNodeGroupLogin` untuk satu node login dan `PCSNodeGroupCompute` hingga empat node komputasi. Grup node ini didukung oleh `PCSInstanceProfile` untuk izin dan `PCSLaunchTemplate` misalnya konfigurasi.
```
# Compute Node groups
PCSInstanceProfile:
Type: AWS::CloudFormation::Stack
Properties:
Parameters:
# We have to regionalize this in case CX use the template in more than one region. Otherwise,
# the create action will fail since instance-role-${AWS::StackName} already exists!
RoleName: !Sub '${AWS::StackName}-${AWS::Region}'
TemplateURL: !Sub 'https://${HpcRecipesS3Bucket}.s3.amazonaws.com/${HpcRecipesBranch}/recipes/pcs/getting_started/assets/pcs-iip-minimal.yaml'
PCSLaunchTemplate:
Type: AWS::CloudFormation::Stack
Properties:
Parameters:
VpcDefaultSecurityGroupId: !GetAtt [ Networking, Outputs.SecurityGroup ]
ClusterSecurityGroupId: !GetAtt [ PCSSecurityGroup, Outputs.ClusterSecurityGroupId ]
SshSecurityGroupId: !GetAtt [ PCSSecurityGroup, Outputs.InboundSshSecurityGroupId ]
EfsFilesystemSecurityGroupId: !GetAtt [ EfsStorage, Outputs.SecurityGroupId ]
FSxLustreFilesystemSecurityGroupId: !GetAtt [ FSxLStorage, Outputs.FSxLustreSecurityGroupId ]
SshKeyName: !Ref KeyName
EfsFilesystemId: !GetAtt [ EfsStorage, Outputs.EFSFilesystemId ]
FSxLustreFilesystemId: !GetAtt [ FSxLStorage, Outputs.FSxLustreFilesystemId ]
FSxLustreFilesystemMountName: !GetAtt [ FSxLStorage, Outputs.FSxLustreMountName ]
TemplateURL: !Sub 'https://${HpcRecipesS3Bucket}.s3.amazonaws.com/${HpcRecipesBranch}/recipes/pcs/getting_started/assets/cfn-pcs-lt-efs-fsxl.yaml'
# Compute Node groups - Login Nodes
PCSNodeGroupLogin:
Type: AWS::PCS::ComputeNodeGroup
Properties:
ClusterId: !GetAtt [PCSCluster, Id]
Name: login
ScalingConfiguration:
MinInstanceCount: 1
MaxInstanceCount: 1
IamInstanceProfileArn: !GetAtt [ PCSInstanceProfile, Outputs.InstanceProfileArn ]
CustomLaunchTemplate:
TemplateId: !GetAtt [ PCSLaunchTemplate, Outputs.LoginLaunchTemplateId ]
Version: 1
SubnetIds:
- !GetAtt [ Networking, Outputs.DefaultPublicSubnet ]
AmiId: !GetAtt [PcsSampleAmi, AmiId]
InstanceConfigs:
- InstanceType: !FindInMap [ Architecture, LoginNodeInstances, !Ref NodeArchitecture ]
# Compute Node groups - Compute Nodes
PCSNodeGroupCompute:
Type: AWS::PCS::ComputeNodeGroup
Properties:
ClusterId: !GetAtt [PCSCluster, Id]
Name: compute-1
ScalingConfiguration:
MinInstanceCount: 0
MaxInstanceCount: 4
IamInstanceProfileArn: !GetAtt [ PCSInstanceProfile, Outputs.InstanceProfileArn ]
CustomLaunchTemplate:
TemplateId: !GetAtt [ PCSLaunchTemplate, Outputs.ComputeLaunchTemplateId ]
Version: 1
SubnetIds:
- !GetAtt [ Networking, Outputs.DefaultPrivateSubnet ]
AmiId: !GetAtt [PcsSampleAmi, AmiId]
InstanceConfigs:
- InstanceType: !FindInMap [ Architecture, ComputeNodeInstances, !Ref NodeArchitecture ]
```
Penjadwalan Job ditangani melalui. `PCSQueueCompute`
```
PCSQueueCompute:
Type: AWS::PCS::Queue
Properties:
ClusterId: !GetAtt [PCSCluster, Id]
Name: demo
ComputeNodeGroupConfigurations:
- ComputeNodeGroupId: !GetAtt [PCSNodeGroupCompute, Id]
```
Pemilihan AMI terjadi secara otomatis melalui fungsi Pcs AMILookup Fn Lambda dan sumber daya terkait.
```
PcsAMILookupRole:
Type: AWS::IAM::Role
[...]
PcsAMILookupFn:
Type: AWS::Lambda::Function
Properties:
Runtime: python3.12
Handler: index.handler
Role: !GetAtt PcsAMILookupRole.Arn
Code:
[...]
Timeout: 30
MemorySize: 128
# Example of using the custom resource to look up an AMI
PcsSampleAmi:
Type: Custom::AMILookup
Properties:
ServiceToken: !GetAtt PcsAMILookupFn.Arn
OperatingSystem: 'amzn2'
Architecture: !FindInMap [ Architecture, AmiArchParameter, !Ref NodeArchitecture ]
SlurmVersion: !Ref SlurmVersion
```
## Output
Template menghasilkan identifikasi dan manajemen cluster URLs melalui`ClusterId`,`PcsConsoleUrl`, dan`Ec2ConsoleUrl`.
```
Outputs:
ClusterId:
Description: The Id of the PCS cluster
Value: !GetAtt [ PCSCluster, Id ]
PcsConsoleUrl:
Description: URL to access the cluster in the PCS console
Value: !Sub
- https://${ConsoleDomain}/pcs/home?region=${AWS::Region}#/clusters/${ClusterId}
- { ConsoleDomain: !If [ GovCloud, 'console.amazonaws-us-gov.com', !If [ China, 'console.amazonaws.cn', !Sub '${AWS::Region}.console.aws.amazon.com']],
ClusterId: !GetAtt [ PCSCluster, Id ]
}
Export:
Name: !Sub ${AWS::StackName}-PcsConsoleUrl
Ec2ConsoleUrl:
Description: URL to access instance(s) in the login node group via Session Manager
Value: !Sub
- https://${ConsoleDomain}/ec2/home?region=${AWS::Region}#Instances:instanceState=running;tag:aws:pcs:compute-node-group-id=${NodeGroupLoginId}
- { ConsoleDomain: !If [ GovCloud, 'console.amazonaws-us-gov.com', !If [ China, 'console.amazonaws.cn', !Sub '${AWS::Region}.console.aws.amazon.com']],
NodeGroupLoginId: !GetAtt [ PCSNodeGroupLogin, Id ]
}
Export:
Name: !Sub ${AWS::StackName}-Ec2ConsoleUrl
```