翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
[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 テンプレートを定義します。この追加のテンプレートは、クラスターの外部にありながらクラスターのライフサイクルの一部であるリソースを作成するために使用されます。
この値は、すべてのパラメータが指定されているパブリックテンプレートへの 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 ポリシーを追加する代わりに、追加のカスタム IAM ポリシーを additional_iam_policies
設定と一緒に渡すことをお勧めします。これは、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
のサポートが削除されました。AWS ParallelCluster バージョン 2.10.0 で centos8
のサポートが追加され、centos6
のサポートが削除されました。AWS ParallelCluster バージョン 2.6.0 で alinux2
をサポートしました。ubuntu1804
のサポートが追加され、ubuntu1404
のサポートが AWS ParallelCluster バージョン 2.5.0 で削除されました。
centos7
をサポートしていない下表の特定の AWS リージョン 以外。その他の AWS 商用リージョンは、以下の OS をすべてサポートします。
パーティション (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 ParallelCluster が使用する AWS CloudFormation スタックの 1 つの名前です。bucket_name
の値は、parallelcluster-
スタックの出力にある clustername
ResourcesS3Bucket
値で確認できます。resource_directory
の値は、同じスタックから出力される ArtifactS3RootDirectory
の値で確認することができます。
デフォルト値は parallelcluster-
です。random_string
cluster_resource_bucket = amzn-s3-demo-bucket
注記
cluster_resource_bucket バージョン 2.10.0 で AWS ParallelCluster をサポートしました。
更新ポリシー: この設定が変更された場合、更新は許可されません。この設定を強制的に更新することはできません。
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 ParallelCluster バージョン 2.8.0 で Graviton-based の AWS インスタンス (A1
、C6g
インスタンスを含む) をサポートしました。
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
compute_root_volume_size
(オプション) ComputeFleet のルートボリュームのサイズをジビバイト (GiB) 単位で指定します。AMI が growroot
をサポートしている必要があります。
デフォルト値は 35
です。
注記
AWS ParallelCluster バージョン 2.5.0 から 2.10.4 までの場合、デフォルトは 25 でした。AWS ParallelCluster バージョン 2.5.0 以前は、デフォルトは 20 でした。
compute_root_volume_size = 35
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
custom_ami
(オプション) デフォルトの公開された 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 エントリを作成しないようにするかどうかを指定します。デフォルトでは、AWS ParallelCluster は Route 53 ホストゾーンを作成します。disable_cluster_dns
が true
に設定されている場合、ホストゾーンは作成されません。
デフォルト値は false
です。
disable_cluster_dns = true
警告
クラスターが正常に動作するためには、名前解決システムが必要です。disable_cluster_dns
を true
に設定した場合、追加の名前解決システムも提供する必要があります。
重要
disable_cluster_dns = true
は、queue_settings 設定が指定された場合のみサポートされます。
注記
AWS ParallelCluster バージョン 2.9.1 で disable_cluster_dns をサポートしました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
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 つの追加の 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
設定を使用する代わりに、追加のカスタム IAM ポリシーを additional_iam_policies 設定と一緒に渡すことをお勧めします。
このオプションを指定しない場合、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 の設定を定義することができます。クラスタープレイスメントグループは、インスタンス間のレイテンシーを最小限に抑えるために使用する必要があります。詳細については、placementおよびplacement_groupを参照してください。
enable_efa = compute
注記
AWS ParallelCluster バージョン 2.10.1 で Arm-based Graviton2 インスタンスで EFA をサポートしました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
enable_efa_gdr
(オプション) AWS ParallelCluster バージョン 2.11.3 より、この設定は無効となりました。Elastic Fabric Adapter (EFA) の GPUDirect RDMA (リモートディレクトメモリーアクセス) のサポートは、インスタンスタイプとオペレーティングシステムの両方でサポートされていれば、常に有効です。
注記
AWS ParallelCluster バージョン 2.10.0 から 2.11.2: compute
の場合、コンピューティングノードで GPUDirect RDMA (リモートダイレクトメモリアクセス) の Elastic Fabric Adapter (EFA) サポートが有効であることを指定します。この設定を compute
にするためには、enable_efa の設定が compute
に設定されている必要があります。GPUDirect RDMA の EFA は、特定のオペレーティングシステム (base_os は alinux2
、centos7
、ubuntu1804
、または ubuntu2004
) 上の特定のインスタンスタイプ (p4d.24xlarge
) でサポートされています。queue_settings の設定が定義されている場合、この設定を定義するか、[queue]のセクションの enable_efa_gdr の設定を定義することができます。クラスタープレイスメントグループは、インスタンス間のレイテンシーを最小限に抑えるために使用する必要があります。詳細については、placementおよびplacement_groupを参照してください。
enable_efa_gdr = compute
注記
AWS ParallelCluster バージョン 2.10.0 で enable_efa_gdr
をサポートしました。
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
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 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 execution role」を参照してください。
注記
バージョン 2.11.5 以降、AWS ParallelCluster は SGE または Torque スケジューラの使用をサポートしていません。
IAM ロール名とその Amazon リソースネーム (ARN) は異なります。ARN を iam_lambda_role
の引数として使用することはできません 。ec2_iam_role および iam_lambda_role
の両方が定義されており、scheduler が sge
、slurm
または torque
の場合、ロールは作成されません。scheduler が awsbatch
であれば、pcluster start の間にロールが作成されます。ポリシーの例ついては、「SGE、Slurm または Torque を使用する ParallelClusterLambdaPolicy」および「awsbatch を使用する 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 以降、AWS ParallelCluster は SGE または Torque スケジューラの使用をサポートしていません。
この設定は、従来のスケジューラ (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 以降、AWS ParallelCluster は SGE または Torque スケジューラの使用をサポートしていません。
(Optional) 従来のスケジューラ (SGE、Slurm および Torque) の Auto Scaling グループの最初のサイズを維持します。
スケジューラが 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 無料利用枠に関するよくある質問
master_instance_type = t2.micro
注記
AWS ParallelCluster バージョン 2.10.1 以前は、すべての AWS リージョンで t2.micro
がデフォルトでした。AWS ParallelCluster バージョン 2.10.0 では、ヘッドノードで p4d.24xlarge
がサポートされていませんでした。AWS ParallelCluster バージョン 2.8.0 で AWS Graviton-based インスタンス (A1
や C6g
など) をサポートしました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
master_root_volume_size
(オプション) ヘッドノードルートボリュームサイズをジビバイト (GiB) 単位で指定します。AMI が growroot
をサポートしている必要があります。
デフォルト値は 35
です。
注記
AWS ParallelCluster バージョン 2.5.0 から 2.10.4 までの場合、デフォルトは 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
(オプション) コンピューティング環境での vCPU の最大数を指定します。スケジューラが 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://
」を指定できます。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 は、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
注記
AWS ParallelCluster バージョン 2.9.0 で queue_settings をサポートしました。
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
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/*my_corporate_bucket
バケットの Development
フォルダにあるすべてのオブジェクトに読み取り/書き込みアクセス許可を付与します。
形式の詳細については、「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
です。
/myshared
の共有 Amazon EBS ボリュームを以下の例に示します。
shared_dir = myshared
更新ポリシー: この設定が変更された場合、更新は許可されません。
spot_bid_percentage
(オプション) awsbatch
がスケジューラである場合は、必要に応じて、ComputeFleet の最大スポット料金の計算に使用されるオンデマンド割合を設定します。
指定しない場合は、オンデマンド料金を上限として、現在のスポット市場価格が選択されます。
spot_bid_percentage = 85
spot_price
注記
バージョン 2.11.5 以降、AWS ParallelCluster は SGE または Torque スケジューラの使用をサポートしていません。
(オプション) 従来のスケジューラ (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"}
更新ポリシー: この設定が変更された場合、更新は許可されません。
注記
更新ポリシーでは、バージョン 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
更新ポリシー: この設定が変更された場合、更新は許可されません。