翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
[cluster]
セクション
クラスターを作成するために使用できるクラスターテンプレートを定義します。設定ファイルには、複数の [cluster]
セクションを含めることができます。
同じクラスターテンプレートを使用して、複数のクラスターを作成できます。
形式は [cluster
です。[global] セクションの cluster_template 設定によって名付けられた[cluster] セクションがデフォルトで使用されますが、pcluster コマンドラインでオーバーライドすることができます。cluster-template-name
]
cluster-template-name
は文字で始まり、30 文字以内で、文字、数字、ハイフン (-)、アンダースコア (_) のみを含む必要があります。
[cluster default]
トピック
- additional_cfn_template
- additional_iam_policies
- base_os
- cluster_resource_bucket
- cluster_type
- compute_instance_type
- compute_root_volume_size
- custom_ami
- cw_log_settings
- dashboard_settings
- dcv_settings
- desired_vcpus
- disable_cluster_dns
- disable_hyperthreading
- ebs_settings
- ec2_iam_role
- efs_settings
- enable_efa
- enable_efa_gdr
- enable_intel_hpc_platform
- encrypted_ephemeral
- ephemeral_dir
- extra_json
- fsx_settings
- iam_lambda_role
- initial_queue_size
- key_name
- maintain_initial_size
- master_instance_type
- master_root_volume_size
- max_queue_size
- max_vcpus
- min_vcpus
- placement
- placement_group
- post_install
- post_install_args
- pre_install
- pre_install_args
- proxy_server
- queue_settings
- raid_settings
- s3_read_resource
- s3_read_write_resource
- scaling_settings
- scheduler
- shared_dir
- spot_bid_percentage
- spot_price
- tags
- template_url
- vpc_settings
additional_cfn_template
(オプション) クラスターとともに起動する追加の AWS CloudFormation テンプレートを定義します。この追加のテンプレートは、クラスターの外部にありながらクラスターのライフサイクルの一部であるリソースを作成するために使用されます。
値はパブリックテンプレートHTTPURLの で、すべてのパラメータを指定する必要があります。
デフォルト値はありません。
additional_cfn_template = https://
<bucket-name>
.s3.amazonaws.com/my-cfn-template.yaml
更新ポリシー: この設定が変更された場合、更新は許可されません。
additional_iam_policies
(オプション) Amazon のIAMポリシーの Amazon リソースネーム (ARNs) のリストを指定しますEC2。このリストは、カンマで区切られた AWS ParallelCluster で必要なアクセス権限に加えて、クラスターで使用されるルートロールにアタッチされます。IAM ポリシー名とポリシー名ARNは異なります。名前を additional_iam_policies
の引数として使用することはできません。
クラスターノードのデフォルト設定にポリシーを追加する場合は、 additional_iam_policies
設定を使用して特定のIAMポリシーを追加するのではなく、 ec2_iam_role設定で追加のカスタムEC2ポリシーを渡すことをお勧めします。これは、 additional_iam_policies
が必要なデフォルトのアクセス許可に が追加されたためです AWS ParallelCluster 。既存の ec2_iam_role には必要なアクセス許可がすべて含まれている必要があります。ただし、必要とされるアクセス許可は機能が追加されるたびに変更されることが多いため、既存の ec2_iam_role は古くなる可能性があります。
デフォルト値はありません。
additional_iam_policies = arn:aws:iam::123456789012:policy/
CustomEC2Policy
注記
AWS ParallelCluster バージョン 2.5.0 で additional_iam_policies をサポートしました。
base_os
(必須) クラスターで使用する OS タイプを指定します。
使用できるオプションは、以下のとおりです。
-
alinux2
-
centos7
-
ubuntu1804
-
ubuntu2004
注記
AWS Graviton ベースのインスタンスでは、alinux2
、ubuntu1804
、または のみがサポートubuntu2004
されています。
注記
AWS ParallelCluster バージョン 2.11.4 で のサポートcentos8
が削除されました。 AWS ParallelCluster バージョン 2.11.0 で ubuntu2004
のサポートが追加され、alinux
および ubuntu1604
のサポートが削除されました。のサポートcentos8
が追加され、 のサポートcentos6
が AWS ParallelCluster バージョン 2.10.0 で削除されました。 AWS ParallelCluster
バージョン 2.6.0 で alinux2
をサポートしました。ubuntu1804
のサポートが追加され、ubuntu1404
のサポートが AWS ParallelCluster バージョン 2.5.0 で削除されました。
次の表で 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 パラメータは、クラスターへのログインに使用されるユーザー名も決定します。
-
centos7
:centos
-
ubuntu1804
およびubuntu2004
: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 ユーザーガイド」の「Using versioning」(バージョニングの使用) を参照してください。このバケットは、複数のクラスターに使用することができます。バケットはクラスターと同じリージョンにあることが必要です。
このパラメータが指定されていない場合、クラスター作成時に新しいバケットが作成されます。新しいバケツは 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
注記
のサポートcluster_resource_bucketが AWS ParallelCluster バージョン 2.10.0 に追加されました。
更新ポリシー: この設定が変更された場合、更新は許可されません。この設定を強制的に更新することはできません。
cluster_type
(オプション) 起動するクラスターのタイプを定義します。queue_settings の設定が定義されている場合、この設定は [queue] セクションの compute_type の設定に置き換える必要があります。
有効なオプションは、ondemand
と spot
です。
デフォルト値は 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 ベースのインスタンス ( A1
および C6g
インスタンスを含む) のサポートが 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
(オプション) デフォルトで公開AMIs
デフォルト値はありません。
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 ログ設定で [cw_log]
セクションを識別します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳しくは、「[cw_log] セクション」、「Amazon CloudWatch ダッシュボード」、「Amazon CloudWatch Logs との統合」を参照してください。
例えば、次の設定では、 が開始するセクション[cw_log custom-cw]
が CloudWatch ログ設定に使用されることを指定します。
cw_log_settings = custom-cw
注記
のサポートcw_log_settingsが AWS ParallelCluster バージョン 2.6.0 に追加されました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
dashboard_settings
(オプション) ダッシュボード設定で [dashboard]
セクションを識別します CloudWatch。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳細については、「[dashboard] セクション」を参照してください。
例えば、次の設定では、 が開始するセクション[dashboard custom-dashboard
が CloudWatch ダッシュボード設定に使用されることを指定します。
dashboard_settings = custom-dashboard
注記
のサポートdashboard_settingsが AWS ParallelCluster バージョン 2.10.0 に追加されました。
dcv_settings
(オプション) Amazon DCV設定で [dcv]
セクションを識別します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳細については、「[dcv] セクション」を参照してください。
例えば、次の設定では、 が開始するセクション[dcv custom-dcv]
が Amazon DCV設定に使用されることを指定します。
dcv_settings = custom-dcv
注記
AWS Graviton ベースのインスタンスでは、Amazon DCVは でのみサポートされていますalinux2
。
注記
のサポートdcv_settingsが AWS ParallelCluster バージョン 2.5.0 に追加されました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
desired_vcpus
(オプション) コンピューティング環境で必要な の数 vCPUs を指定します。スケジューラが awsbatch
の場合にのみ使用します。
デフォルト値は 4
です。
desired_vcpus = 4
disable_cluster_dns
(オプション) クラスターのDNSエントリを作成しないかどうかを指定します。デフォルトでは、 は Route 53 ホストゾーン AWS ParallelCluster を作成します。disable_cluster_dns
が true
に設定されている場合、ホストゾーンは作成されません。
デフォルト値は false
です。
disable_cluster_dns = true
警告
クラスターが正常に動作するためには、名前解決システムが必要です。disable_cluster_dns
を true
に設定した場合、追加の名前解決システムも提供する必要があります。
重要
disable_cluster_dns = true
は、queue_settings 設定が指定された場合のみサポートされます。
注記
のサポートdisable_cluster_dnsが AWS ParallelCluster バージョン 2.9.1 に追加されました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
disable_hyperthreading
(Optional) ヘッドノードとコンピューティングノードでハイパースレッディングを無効にします。すべてのインスタンスタイプがハイパースレッディングを無効にできるわけではありません。ハイパースレッディングの無効化をサポートするインスタンスタイプのリストについては、「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 (5) の Amazon EBSボリュームが追加されています。
詳細については、「 [ebs] セクション」を参照してください。
例えば、次の設定[ebs custom2]
では、Amazon EBSボリュームで [ebs custom1]
と が起動するセクションが使用されるように指定します。
ebs_settings = custom1, custom2
更新ポリシー: この設定が変更された場合、更新は許可されません。
ec2_iam_role
(オプション) クラスター内のすべてのインスタンスにアタッチEC2されている Amazon の既存のIAMロールの名前を定義します。IAM ロール名とその Amazon リソースネーム (ARN) は異なります。ARNs は の引数として使用できませんec2_iam_role
。
このオプションを指定すると、additional_iam_policies 設定は無視されます。クラスターノードのデフォルト設定にポリシーを追加する場合は、 additional_iam_policies設定を使用する代わりに、 ec2_iam_role
設定で追加のカスタムIAMポリシーを渡すことをお勧めします。
このオプションを指定しない場合、Amazon のデフォルト AWS ParallelCluster IAMロールEC2が使用されます。詳細については、「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) が有効になっていることを指定します。をサポートするEC2インスタンスのリストを表示するにはEFA、「Linux インスタンス用 Amazon ユーザーガイド」の「サポートされているインスタンスタイプ」を参照してください。 EC2 詳細については、「Elastic Fabric Adapter」を参照してください。queue_settings の設定が定義されている場合、この設定を定義するか、[queue] のセクションの enable_efa の設定を定義することができます。クラスタープレイスメントグループは、インスタンス間のレイテンシーを最小限に抑えるために使用する必要があります。詳細については、「placement」および「placement_group」を参照してください。
enable_efa = compute
注記
Arm ベースの Graviton2 インスタンスEFAでの のサポートが AWS ParallelCluster バージョン 2.10.1 に追加されました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
enable_efa_gdr
(オプション) AWS ParallelCluster バージョン 2.11.3 以降、この設定は効果がありません。Elastic Fabric Adapter (EFA) GPUDirect RDMA (リモート直接メモリアクセス) のサポートは、インスタンスタイプとオペレーティングシステムの両方でサポートされている場合、常に有効になります。
注記
AWS ParallelCluster バージョン 2.10.0 から 2.11.2: の場合compute
、 はコンピューティングノードで Elastic Fabric Adapter (EFA) のサポート GPUDirect RDMA (リモート直接メモリアクセス) が有効になっていることを指定します。この設定を compute
にするためには、enable_efa の設定が compute
に設定されている必要があります。EFA のサポートGPUDirectRDMAは、特定のオペレーティングシステム上の特定のインスタンスタイプ (p4d.24xlarge
) でサポートされています (base_os は alinux2
、centos7
、ubuntu1804
、または ですubuntu2004
)。queue_settings の設定が定義されている場合、この設定を定義するか、[queue]のセクションの enable_efa_gdr の設定を定義することができます。クラスタープレイスメントグループは、インスタンス間のレイテンシーを最小限に抑えるために使用する必要があります。詳細については、「placement」および「placement_group」を参照してください。
enable_efa_gdr = compute
注記
のサポートenable_efa_gdr
が AWS ParallelCluster バージョン 2.10.0 に追加されました。
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
enable_intel_hpc_platform
(オプション) 存在する場合は、インテル Parallel Studio のエンドユーザー使用許諾契約書 = 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 統合キーセットアップ) を使用して、回復不可能なインメモリキーでエフェメラルインスタンスストアボリュームを暗号化します。
詳細については、「https://gitlab.com/cryptsetup/cryptsetup/blob/master/README.md
デフォルト値は false
です。
encrypted_ephemeral = true
更新ポリシー: この設定が変更された場合、更新は許可されません。
ephemeral_dir
(オプション) インスタンスストアボリュームをマウントするパスを定義します (使用されている場合)。
デフォルト値は /scratch
です。
ephemeral_dir = /scratch
更新ポリシー: この設定が変更された場合、更新は許可されません。
extra_json
(オプション) にJSONマージされる追加を定義します。Chef dna.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
(オプション) Lustre 設定FSxの を定義するセクションを指定します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳細については、「[fsx] セクション」を参照してください。
例えば、次の設定では、 がスタートするセクション[fsx fs]
が の FSx for Lustre 設定に使用されることを指定します。
fsx_settings = fs
更新ポリシー: この設定が変更された場合、更新は許可されません。
iam_lambda_role
(オプション) 既存の AWS Lambda 実行ロールの名前を定義します。このロールは、クラスター内のすべての Lambda 関数にアタッチされます。詳細については、「AWS Lambda デベロッパーガイド」の「AWS Lambda execution role」を参照してください。
注記
バージョン 2.11.5 AWS ParallelCluster 以降、 は の使用をサポートしていません SGE または Torque スケジューラ。
IAM ロール名とその Amazon リソースネーム (ARN) は異なります。ARNs は の引数として使用できませんiam_lambda_role
。ec2_iam_role および iam_lambda_role
の両方が定義されており、scheduler が sge
、slurm
または torque
の場合、ロールは作成されません。scheduler が awsbatch
であれば、pcluster start の間にロールが作成されます。ポリシーの例ついては、「ParallelClusterLambdaPolicy の使用 SGE, Slurm、または Torque」および「awsbatch を使用する ParallelClusterLambdaPolicy」を参照してください。
デフォルト値はありません。
iam_lambda_role = ParallelClusterLambdaRole
注記
のサポートiam_lambda_role
が AWS ParallelCluster バージョン 2.10.1 に追加されました。
initial_queue_size
(オプション) クラスター内のコンピューティングノードとして起動する Amazon EC2インスタンスの初期数を設定します。queue_settings の設定が定義されている場合、この設定は削除され、[compute_resource] セクションの initial_count の設定に置き換わります。
注記
バージョン 2.11.5 AWS ParallelCluster 以降、 は の使用をサポートしていません SGE または Torque スケジューラ。
この設定は、従来のスケジューラ (SGE, Slurm および Torque)。 maintain_initial_size 設定が の場合true
、initial_queue_size設定は少なくとも 1 (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 AWS ParallelCluster 以降、 は の使用をサポートしていません SGE または Torque スケジューラ。
(オプション) Auto Scaling 従来のスケジューラ (SGE, Slurm および Torque).
スケジューラが awsbatch
の場合は、desired_vcpus を使用します。
この設定は、ブーリアン型フラグです。true
に設定した場合、Auto Scaling グループのメンバーは initial_queue_size の値より少なくなることはなく、initial_queue_size の値は 1 以上でなければなりません。クラスターは max_queue_size の値にスケールアップできます。cluster_type = spot
の場合、Auto Scaling グループはインスタンスを中断し、initial_queue_size サイズを下回る可能性があります。
false
に設定した場合、Auto Scaling グループは、不要なときにリソースがアイドル状態で待機するのを回避するため、ゼロ (0) メンバーにスケールダウンできます。
queue_settings の設定が定義されている場合、この設定は削除され、[compute_resource] セクションの initial_count および min_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 ベースのインスタンス ( A1
や などC6g
) のサポートが 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 AWS ParallelCluster 以降、 は の使用をサポートしていません SGE または Torque スケジューラ。
この設定は、従来のスケジューラ (SGE, Slurm および Torque).
スケジューラが awsbatch
の場合は、max_vcpus を使用します。
デフォルトは 10
です。
max_queue_size = 10
更新ポリシー: この設定はアップデート中に変更することができますが、値が小さくなった場合はコンピューティングフリートを停止する必要があります。そうでなければ、既存のノードを終了させることができます。
max_vcpus
(オプション) コンピューティング環境 vCPUs 内の の最大数を指定します。スケジューラが awsbatch
の場合にのみ使用します。
デフォルト値は 20
です。
max_vcpus = 20
更新ポリシー: これらの設定は、更新中に減らすことはできません。
min_vcpus
(オプション) awsbatch
スケジューラの Auto Scaling グループの最初のサイズを維持します。
注記
バージョン 2.11.5 AWS ParallelCluster 以降、 は の使用をサポートしていません SGE または Torque スケジューラ。
スケジューラが の場合 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://
」を指定できます。bucketname/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://
」を指定できます。bucketname/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 は、scheduler が slurm
に設定されている場合にのみサポートされます。cluster_type、compute_instance_type、initial_queue_size、maintain_initial_size、max_queue_size、placement、placement_group および spot_price の設定を指定してはいけません。disable_hyperthreading および enable_efa の設定は、[cluster] セクションか [queue] セクションのどちらかに指定できますが、両方に指定することはできません。
最大で 5 つの [queue] セクションに対応しています。
詳細については、「[queue] セクション」を参照してください。
例えば、以下の設定では、[queue q1]
と [queue q2]
で始まるセクションが使用されるように指定します。
queue_settings = q1, q2
注記
のサポートqueue_settingsが AWS ParallelCluster バージョン 2.9.0 に追加されました。
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
raid_settings
(オプション) Amazon EBSボリュームRAID設定で [raid]
セクションを識別します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳細については、「[raid] セクション」を参照してください。
例えば、[raid rs]
で始まるセクションを指定する次の設定がオートスケーリング設定で使用されます。
raid_settings = rs
更新ポリシー: この設定が変更された場合、更新は許可されません。
s3_read_resource
(オプション) AWS ParallelCluster ノードに読み取り専用アクセスを付与する Amazon S3 リソースを指定します。
例えば、 arn:aws:s3:::
は への読み取り専用アクセスを提供します。my_corporate_bucket
*my_corporate_bucket
バケットと をバケット内のオブジェクトに。
形式の詳細については、「working with Amazon S3」(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/*Development
フォルダ内のすべてのオブジェクトへの読み取り/書き込みアクセスを提供します。my_corporate_bucket
バケット。
形式の詳細については、「working with Amazon S3」(Amazon S3 の使用) を参照してください。
デフォルト値はありません。
s3_read_write_resource = arn:aws:s3:::
my_corporate_bucket
/*
scaling_settings
オートスケーリングボリューム RAID 設定で [scaling]
セクションを識別します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳細については、「[scaling] セクション」を参照してください。
例えば、[scaling custom]
で始まるセクションを指定する次の設定がオートスケーリング設定で使用されます。
scaling_settings = custom
更新ポリシー: この設定が変更された場合、更新は許可されません。
scheduler
(必須) クラスターのスケジューラを定義します。
有効なオプションは、次の値です。
awsbatch
-
AWS Batch
awsbatch
スケジューラの詳細については、「ネットワークのセットアップ」および「AWS Batch (awsbatch)」を参照してください。 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)
注記
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
です。
次の例は、 にマウントされた共有 Amazon EBSボリュームを示しています/myshared
。
shared_dir = myshared
更新ポリシー: この設定が変更された場合、更新は許可されません。
spot_bid_percentage
(オプション) awsbatch
がスケジューラの場合 ComputeFleet、 の最大スポット料金の計算に使用されるオンデマンドの割合を設定します。
指定しない場合は、オンデマンド料金を上限として、現在のスポット市場価格が選択されます。
spot_bid_percentage = 85
spot_price
注記
バージョン 2.11.5 AWS ParallelCluster 以降、 は の使用をサポートしていません SGE または Torque スケジューラ。
(オプション) ComputeFleet 従来のスケジューラ (SGE, Slurm および Torque)。 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"}
更新ポリシー: この設定が変更された場合、更新は許可されません。
注記
更新ポリシーでは、バージョン 2.8.0 からバージョン 2.9.1 までの AWS ParallelCluster
の 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
更新ポリシー: この設定が変更された場合、更新は許可されません。