本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `[cluster]` 部分
定义可用于创建集群的集群模板。配置文件可以包含多个 `[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`
**（可选）**定义要与集群一起启动的附加 AWS CloudFormation 模板。此附加模板用于创建存在于集群外部但属于集群生命周期一部分的资源。
值必须是指向公有模板的 HTTP URL，并提供所有参数。
没有默认值。
```
additional_cfn_template = https://.s3.amazonaws.com/my-cfn-template.yaml
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `additional_iam_policies`
**（可选）**指定 Amazon EC2 的 IAM 策略的 Amazon 资源名称 (ARN) 列表。除了 AWS ParallelCluster 所需的权限（以逗号分隔）之外，此列表也附加到集群中使用的根角色。IAM 策略名称及其 ARN 不相同。名称不能用作 `additional_iam_policies` 的参数。
如果您打算在集群节点的默认设置中添加额外的策略，我们建议您使用 `additional_iam_policies` 设置传递其他自定义 IAM 策略，而不是使用 [`ec2_iam_role`](#ec2-iam-role) 设置添加特定的 EC2 策略。这是因为`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
```
**注意**
在 AWS ParallelCluster 版本 2.5.0 中增加了对 [`additional_iam_policies`](#additional-iam-policies) 的支持。
[更新策略：可以在更新期间更改此设置。](using-pcluster-update.md#update-policy-setting-supported)
## `base_os`
**（必需）**指定在集群中使用的操作系统类型。
可用的选项为：
+ `alinux2`
+ `centos7`
+ `ubuntu1804`
+ `ubuntu2004`
**注意**
对于 AWS 基于 Graviton 的实例，仅`alinux2`支持`ubuntu1804`、或`ubuntu2004`。
**注意**
在 2.11.4 AWS ParallelCluster 版本中删除`centos8`了对 Support 的支持。在 AWS ParallelCluster 版本 2.11.0 中增加了对 `ubuntu2004` 的支持，并删除了对 `alinux` 和 `ubuntu1604` 的支持。在 2.10.0 AWS ParallelCluster 版本中添加`centos8``centos6`了对的支持，并删除了对的支持。在 AWS ParallelCluster 版本 2.6.0 中增加了对 `alinux2` 的支持。在 AWS ParallelCluster 版本 2.5.0 中增加了对 `ubuntu1804` 的支持，并删除了对 `ubuntu1404` 的支持。
除下表中 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`
**注意**
在 2.7.0 AWS ParallelCluster 版本之前，该[`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`
**（可选）**指定用于托管创建集群时生成的资源的 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
```
**注意**
在 2.10.0 AWS ParallelCluster 版本中添加[`cluster_resource_bucket`](#cluster-resource-bucket-section)了对 Support 的支持。
[更新策略：如果更改此设置，则不允许更新。不能强制更新此设置。](using-pcluster-update.md#update-policy-read-only-resource-bucket)
## `cluster_type`
**（可选）**定义要启动的集群的类型。如果定义了 [`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`
**（可选）**定义用于集群计算节点的 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 用户界面中创建的计算环境以获取支持的实例类型列表。
默认值为 `t2.micro`；当调度器为 `awsbatch` 时，为 `optimal`。
```
compute_instance_type = t2.micro
```
**注意**
2.8.0 版本中增加了对 AWS 基于 Graviton 的`C6g`实例（包括`A1`和实例）的 AWS ParallelCluster 支持。
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `compute_root_volume_size`
**（可选）**以千兆字节 (GiB) 为单位指定 ComputeFleet 根卷大小。AMI 必须支持 `growroot`。
默认值为 `35`。
**注意**
对于 2.5.0 和 2.10.4 之间的 AWS ParallelCluster 版本，默认值为 25。在 2.5.0 AWS ParallelCluster 版本之前，默认值为 20。
```
compute_root_volume_size = 35
```
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `custom_ami`
**（可选）**指定用于头节点和计算节点的自定义 AMI 的 ID，而不是默认[发布](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/amis.txt)的 AMI AMIs。有关更多信息，请参阅 [修改 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/"
]
}
]
}
```
------
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `cw_log_settings`
**（可选）**使用 CloudWatch 日志配置标识该`[cw_log]`部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[cw_log]` 部分](cw-log-section.md)、[亚马逊 CloudWatch 控制面板](cloudwatch-dashboard.md) 和 [与 Amazon CloudWatch 日志集成](cloudwatch-logs.md)。
例如，以下设置指定启动部分`[cw_log custom-cw]`用于 CloudWatch 日志配置。
```
cw_log_settings = custom-cw
```
**注意**
在 2.6.0 AWS ParallelCluster 版本中添加[`cw_log_settings`](#cw-log-settings)了对 Support 的支持。
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `dashboard_settings`
**（可选）**使用 CloudWatch仪表板配置标识该`[dashboard]`部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[dashboard]` 部分](dashboard-section.md)。
例如，以下设置指定启动的部分`[dashboard custom-dashboard`用于 CloudWatch 仪表板配置。
```
dashboard_settings = custom-dashboard
```
**注意**
在 2.10.0 AWS ParallelCluster 版本中添加[`dashboard_settings`](#dashboard-settings)了对 Support 的支持。
[更新策略：可以在更新期间更改此设置。](using-pcluster-update.md#update-policy-setting-supported)
## `dcv_settings`
**（可选）**使用 Amazon DCV 配置标识 `[dcv]` 部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[dcv]` 部分](dcv-section.md)。
例如，以下设置指定将以 `[dcv custom-dcv]` 开始的部分用于 Amazon DCV 配置。
```
dcv_settings = custom-dcv
```
**注意**
在 AWS 基于 Graviton 的实例上，仅支持 Amazon DCV。`alinux2`
**注意**
在 2.5.0 AWS ParallelCluster 版本中添加[`dcv_settings`](#dcv-settings)了对 Support 的支持。
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `desired_vcpus`
**（可选）**指定计算环境CPUs 中所需的 v 数。仅在调度器为 `awsbatch` 时使用。
默认值为 `4`。
```
desired_vcpus = 4
```
[更新策略：在更新期间不分析此设置。](using-pcluster-update.md#update-policy-setting-ignored)
## `disable_cluster_dns`
**（可选）**指定是否不应为集群创建 DNS 条目。默认情况下， AWS ParallelCluster 会创建 Route 53 托管区域。如果 `disable_cluster_dns` 设置为 `true`，则不会创建托管区。
默认值为 `false`。
```
disable_cluster_dns = true
```
**警告**
集群需要名称解析系统才能正常运行。如果 `disable_cluster_dns` 设置为 `true`，则还必须提供其他名称解析系统。
**重要**
只有在指定了 [`queue_settings`](#queue-settings) 设置时才支持 [`disable_cluster_dns`](#disable-cluster-dns-settings) = `true`。
**注意**
在 2.9.1 AWS ParallelCluster 版本中增加了对 Support 的支持。[`disable_cluster_dns`](#disable-cluster-dns-settings)
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `disable_hyperthreading`
**（可选）**禁用头节点和计算节点上的超线程。并非所有实例类型都可以禁用超线程。有关支持禁用超线程的实例类型列表，请参阅《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`
**（可选）**使用头节点上挂载的 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`
**（可选）**定义将附加到集群中所有实例的 Amazon EC2 的现有 IAM 角色的名称。IAM 角色名称与其 Amazon 资源名称 (ARN) 不同。 ARNs 不能用作论据`ec2_iam_role`。
如果指定了此选项，则忽略 [`additional_iam_policies`](#additional-iam-policies) 设置。如果您打算在集群节点的默认设置中添加额外的策略，我们建议您使用 [`additional_iam_policies`](#additional-iam-policies) 设置传递其他自定义 IAM 策略，而不是使用 `ec2_iam_role` 设置。
如果未指定此选项，则使用 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`
**（可选）**指定与 Amazon EFS 文件系统相关的设置。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[efs]` 部分](efs-section.md)。
例如，以下设置指定将以 `[efs customfs]` 开始的部分用于 Amazon EFS 文件系统配置。
```
efs_settings = customfs
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `enable_efa`
**（可选）**如果存在，则指定为计算节点启用 Elastic Fabric Adapter (EFA)。要查看支持 EFA 的 EC2 实例的列表，请参阅 *Amazon EC2 用户指南（适用于 Linux 实例）*中的[支持的实例类型](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
```
**注意**
在 2.10.1 版本中，在基于 ARM 的 Graviton2 实例上增加了对 EFA 的支持。 AWS ParallelCluster
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `enable_efa_gdr`
**（可选）**从 2.11.3 AWS ParallelCluster 版本开始，此设置无效。如果实例类型和操作系统都支持 GPUDirect Elastic Fabric Adapter (EFA)，则始终启用对 RDMA（远程直接内存访问）的支持。
**注意**
AWS ParallelCluster 版本 2.10.0 到 2.11.2：如果`compute`，则指定计算节点启用弹性结构适配器 (EFA) 对 GPUDirect RDMA（远程直接内存访问）的支持。将此设置设置为 `compute` 需要先将 [`enable_efa`](#enable-efa) 设置设为 `compute`。特定操作系统（是`alinux2`、`centos7`、或 `p4d.24xlarge``ubuntu2004`）上的特定实例类型 () 支持对 GPUDirect RDMA [`base_os`](#base-os) 的 EFA 支持。`ubuntu1804`如果定义了 [`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
```
**注意**
在 2.10.0 AWS ParallelCluster 版本中添加`enable_efa_gdr`了对 Support 的支持。
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `enable_intel_hpc_platform`
**（可选）**如果存在，则表示接受 Intel Parallel Studio 的[最终用户许可协议](https://software.intel.com/en-us/articles/end-user-license-agreement)。这将导致 Intel Parallel Studio 安装在头节点上并与计算节点共享。这使头节点进行引导的时间增加了几分钟。仅 CentOS 7 ([`base_os`](#base-os)` = centos7`) 上支持 [`enable_intel_hpc_platform`](#enable-intel-hpc-platform) 设置。
默认值为 `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`
**（可选）**使用 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`
**（可选）**定义实例存储卷（如果使用）的挂载路径。
默认值为 `/scratch`。
```
ephemeral_dir = /scratch
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `extra_json`
**（可选）**定义合并到 Chef `dna.json` 中的额外 JSON。有关更多信息，请参阅 [构建自定义 AWS ParallelCluster AMI](tutorials_02_ami_customization.md)。
默认值为 `{}`。
```
extra_json = {}
```
**注意**
从 AWS ParallelCluster 版本 2.6.1 开始，启动节点时默认会跳过大多数安装配方，以缩短启动时间。要以牺牲启动时间为代价运行所有安装食谱以获得更好的向后兼容性，请将 `"skip_install_recipes" : "no"` 添加到 [`extra_json`](#extra-json) 设置中的 `cluster` 键。例如：
```
extra_json = { "cluster" : { "skip_install_recipes" : "no" } }
```
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `fsx_settings`
**（可选）**指定定义 for Lustre 配置 FSx 的部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[fsx]` 部分](fsx-section.md)。
例如，以下设置指定启动部分用`[fsx fs]`于 for Lustre 配置。 FSx
```
fsx_settings = fs
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `iam_lambda_role`
**（可选）**定义现有 AWS Lambda 执行角色的名称。此角色附加到集群中所有 Lambda 函数。有关更多信息，请参阅*AWS Lambda 开发人员指南* 中的 [AWS Lambda 执行角色](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html)。
**注意**
从 2.11.5 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
IAM 角色名称与其 Amazon 资源名称 (ARN) 不同。 ARNs 不能用作论据`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
```
**注意**
在 2.10.1 AWS ParallelCluster 版本中增加了对 Support 的支持。`iam_lambda_role`
[更新策略：可以在更新期间更改此设置。](using-pcluster-update.md#update-policy-setting-supported)
## `initial_queue_size`
**（可选）**设置要作为集群中的计算节点启动的 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 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
此设置仅适用于传统调度器（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`
**（可选）**用于启用对实例进行的 SSH 访问的现有 Amazon EC2 密钥对的名称。
```
key_name = mykey
```
**注意**
在 2.11.0 AWS ParallelCluster 版本之前，`key_name`是必需的设置。
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `maintain_initial_size`
**注意**
从 2.11.5 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
**（可选）**为传统的调度器（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`
**（可选）**定义用于头节点的 Amazon EC2 实例类型。该实例类型的架构必须与用于 [`compute_instance_type`](#compute-instance-type) 设置的架构相同。
如果有免费套餐，则默认为免费套餐实例类型（`t2.micro`或`t3.micro`）。 AWS 区域 其中 AWS 区域 没有免费套餐，默认为`t3.micro`。有关 AWS 免费套餐的更多信息，请参阅[AWS 免费套餐 FAQs](https://aws.amazon.com/free/free-tier-faqs/)。
```
master_instance_type = t2.micro
```
**注意**
在 2.10.1 AWS ParallelCluster 版本之前，全部默认为。`t2.micro` AWS 区域在 AWS ParallelCluster 版本2.10.0 中，头节点不支持 `p4d.24xlarge`。2.8.0 版本中增加了对 AWS 基于 Graviton 的实例（例如`A1`和`C6g`）的 AWS ParallelCluster 支持。
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `master_root_volume_size`
**（可选）**指定头节点根卷大小，以吉字节 (GiB) 为单位。AMI 必须支持 `growroot`。
默认值为 `35`。
**注意**
对于 2.5.0 和 2.10.4 之间的 AWS ParallelCluster 版本，默认值为 25。在 2.5.0 AWS ParallelCluster 版本之前，默认值为 20。
```
master_root_volume_size = 35
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `max_queue_size`
**（可选）**设置集群中可以启动的 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 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
此设置仅适用于传统调度器（SGE、Slurm 和 Torque）。
如果调度器是 `awsbatch`，请改用 [`max_vcpus`](#max-vcpus)。
默认值为 `10`。
```
max_queue_size = 10
```
更新策略：可以在更新期间更改此设置，但如果该值降低，则应停止计算实例集。否则，现有节点可能会被终止。
## `max_vcpus`
**（可选）**指定计算环境CPUs 中 v 的最大数量。仅在调度器为 `awsbatch` 时使用。
默认值为 `20`。
```
max_vcpus = 20
```
[更新策略：更新期间不能减小此设置。](using-pcluster-update.md#update-policy-no-decrease)
## `min_vcpus`
**（可选）**为 `awsbatch` 调度器保持自动扩缩组的初始大小。
**注意**
从 2.11.5 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
如果调度器是 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`
**（可选）**定义集群置放群组逻辑，并使整个集群或仅计算实例能够使用集群置放群组。
如果定义了 [`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`
**（可选）**定义集群置放群组。如果定义了 [`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`
**（可选）**指定在所有节点引导操作完成后运行的安装后脚本的 URL。有关更多信息，请参阅 [自定义引导操作](pre_post_install.md)。
当使用 `awsbatch` 作为调度器时，安装后脚本仅在头节点上运行。
参数格式可以是 `http://hostname/path/to/script.sh` 或 `s3://bucket-name/path/to/script.sh`。
没有默认值。
```
post_install = s3:///my-post-install-script.sh
```
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `post_install_args`
**（可选）**指定要传递到安装后脚本的用双引号引起的参数列表。
没有默认值。
```
post_install_args = "argument-1 argument-2"
```
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `pre_install`
**（可选）**指定在启动任何节点部署引导操作之前运行的预安装脚本的 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`
**（可选）**指定要传递到预安装脚本的用双引号引起的参数列表。
没有默认值。
```
pre_install_args = "argument-3 argument-4"
```
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `proxy_server`
**（可选）**定义 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`
**（可选）**指定集群使用队列而不是同构计算队列，以及使用哪些[`[queue]`部分](queue-section.md)。列出的第一个 [`[queue]` 部分](queue-section.md)是默认的调度器队列。`queue` 部分名称必须以小写字母开头，不能超过 30 个字符，并且只能包含小写字母、数字和连字符 (-)。
**重要**
仅在 [`scheduler`](#scheduler) 设置为 `slurm` 时支持 [`queue_settings`](#queue-settings)。不得指定 [`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)中指定，但不能同时在这些部分中指定。
最多支持五 (5) 个 [`[queue]` 部分](queue-section.md)。
有关更多信息，请参阅 [`[queue]` 部分](queue-section.md)。
例如，以下设置指定使用以 `[queue q1]` 和 `[queue q2]` 开始的部分。
```
queue_settings = q1, q2
```
**注意**
在 2.9.0 AWS ParallelCluster 版本中添加[`queue_settings`](#queue-settings)了对 Support 的支持。
[更新策略：必须停止计算实例集才能更改此设置以进行更新。](using-pcluster-update.md#update-policy-compute-fleet)
## `raid_settings`
**（可选）**使用 Amazon EBS 卷 RAID 配置标识 `[raid]` 部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[raid]` 部分](raid-section.md)。
例如，以下设置指定将以 `[raid rs]` 开始的部分用于自动扩缩配置。
```
raid_settings = rs
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `s3_read_resource`
**（可选）**指定向 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`
**（可选）**指定向 AWS ParallelCluster 节点授予 read/write 访问权限的 Amazon S3 资源。
例如，`arn:aws:s3:::my_corporate_bucket/Development/*`提供对*my\$1corporate\$1bucket*存储桶`Development`文件夹中所有对象的 read/write 访问权限。
有关格式的详细信息，请参阅[使用 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`
使用自动扩缩配置标识 `[scaling]` 部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[scaling]` 部分](scaling-section.md)。
例如，以下设置指定将以 `[scaling custom]` 开始的部分用于自动扩缩配置。
```
scaling_settings = custom
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `scheduler`
**（必需）**定义集群调度器。
有效选项为以下值：
`awsbatch`
AWS Batch
有关 `awsbatch` 调度器的更多信息，请参阅[联网设置](networking.md#awsbatch-networking)和 [AWS Batch (`awsbatch`)](awsbatchcli.md)。
`sge`
从 2.11.5 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
Son of Grid Engine (SGE)
`slurm`
Slurm Workload Manager (Slurm)
`torque`
从 2.11.5 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
Torque Resource Manager (Torque)
**注意**
在 2.7.0 AWS ParallelCluster 版本之前，该`scheduler`参数是可选的，默认值为。`sge`从 2.7.0 AWS ParallelCluster 版开始，该`scheduler`参数为必填项。
```
scheduler = slurm
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `shared_dir`
**（可选）**定义共享 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`
**（可选）**设置按需百分比，用于计算计划程序的最高竞价价格。 ComputeFleet `awsbatch`
如果未指定，则选择当前 Spot 市场价格，最高为按需价格。
```
spot_bid_percentage = 85
```
[更新策略：可以在更新期间更改此设置。](using-pcluster-update.md#update-policy-setting-supported)
## `spot_price`
**注意**
从 2.11.5 版开始， AWS ParallelCluster 不支持使用SGE或Torque调度程序。
**（可选）**为传统调度程序（SGESlurm、和Torque）设置最高竞价价格。 ComputeFleet 仅当 [`cluster_type`](#cluster-type) 设置设为 `spot` 时使用。如果您不指定值，则按 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 中，如果[`spot_price`](#spot-price)未指定`cluster_type = spot`但未指定，则实例启动 ComputeFleet 失败。此问题已在 2.5.1 AWS ParallelCluster 版本中修复。
[更新策略：可以在更新期间更改此设置。](using-pcluster-update.md#update-policy-setting-supported)
## `tags`
**（可选）**定义要使用的标签 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`
**（可选）**定义用于创建集群的 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`
**（必需）**使用将在其中部署集群的 Amazon VPC 配置标识 `[vpc]` 部分。部分名称必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
有关更多信息，请参阅 [`[vpc]` 部分](vpc-section.md)。
例如，以下设置指定将以 `[vpc public]` 开始的部分用于 Amazon VPC 配置。
```
vpc_settings = public
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)