翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
[cluster] セクション
クラスターを作成するために使用できるクラスターテンプレートを定義します。設定ファイルには、複数の [cluster] セクションを含めることができます。
同じクラスターテンプレートを使用して、複数のクラスターを作成できます。
形式は [cluster です。[global] セクションの cluster_template 設定によって名付けられた[cluster] セクションがデフォルトで使用されますが、pcluster コマンドラインでオーバーライドすることができます。cluster-template-name]
cluster-template-name は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
[cluster default]
トピック
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
注記
Graviton AWS ベースのインスタンスでは、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 | 正 |
AWS GovCloud (米国東部) (us-gov-east-1) |
正 | False | 正 |
AWS GovCloud (米国西部) (us-gov-west-1) |
正 | False | 正 |
中国 (北京) (cn-north-1) |
正 | False | 正 |
中国 (寧夏) (cn-northwest-1) |
正 | False | 正 |
注記
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_stringrandom_string は英数字からなるランダムな文字列です。すべてのクラスターリソースは、 という形式のパスでこのバケットに保存されます。 bucket_name/resource_directoryresource_directoryには という形式があります。ここで stack_name は、 で使用されるいずれかの CloudFormation スタックの名前です AWS ParallelCluster。 stack_name-random_stringbucket_name の値は、parallelcluster- スタックの出力にある clusternameResourcesS3Bucket 値で確認できます。resource_directory の値は、同じスタックから出力される ArtifactS3RootDirectory の値で確認することができます。
デフォルト値は parallelcluster- です。random_string
cluster_resource_bucket = amzn-s3-demo-bucket
注記
AWS ParallelCluster バージョン 2.10.0 で のサポートが追加されcluster_resource_bucketました。
更新ポリシー: この設定が変更された場合、更新は許可されません。この設定を強制的に更新することはできません。
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ケジューラを使用している場合は、UI AWS Batch のコンピューティング環境の作成で、サポートされているインスタンスタイプのリストを参照してください。
スケジューラが awsbatch の場合、デフォルトは t2.micro、optimal です。
compute_instance_type = t2.micro
注記
AWS ParallelCluster バージョン AWS 2.8.0 では、Graviton ベースのインスタンス ( A1 および C6gインスタンスを含む) のサポートが追加されました。
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
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
(オプション) デフォルトの公開された AMI
デフォルト値はありません。
custom_ami = ami-00d4efc81188687a0
カスタム AMI の起動に追加のアクセス許可が必要な場合は、これらのアクセス許可をユーザーポリシーとヘッドノードポリシーの両方に追加する必要があります。
例えば、カスタム AMI に暗号化されたスナップショットが関連付けられている場合、ユーザーおよびヘッドノードポリシーの両方に次の追加のポリシーが必要です。
更新ポリシー: この設定が変更された場合、更新は許可されません。
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
注記
Graviton AWS ベースのインスタンスでは、Amazon DCV は でのみサポートされていますalinux2。
注記
AWS ParallelCluster バージョン 2.5.0 で のサポートが追加されdcv_settingsました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
desired_vcpus
(オプション) コンピューティング環境で必要な vCPU 数を指定します。スケジューラが 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 設定が指定された場合のみサポートされます。
注記
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
注記
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、コンピューティングノードで 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 パラメータは Graviton AWS ベースのインスタンスと互換性がありません。
注記
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 を定義します。詳細については、「カスタム AMI AWS ParallelCluster の構築」を参照してください。
デフォルト値は {} です。
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 「 無料利用枠に関するFAQs
master_instance_type = t2.micro
注記
AWS ParallelCluster バージョン 2.10.1 より前では、 はデフォルトですべて t2.micro に設定されています AWS リージョン。 AWS ParallelCluster バージョン 2.10.0 では、ヘッドノードで p4d.24xlarge がサポートされていませんでした。 AWS ParallelCluster バージョン AWS 2.8.0 では、Graviton ベースのインスタンス ( A1や などC6g) のサポートが追加されました。
更新ポリシー: この設定が変更された場合、更新は許可されません。
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
(オプション) コンピューティング環境での 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.shs3://」を指定できます。bucket-name/path/to/script.sh
デフォルト値はありません。
post_install = s3://<bucket-name>/my-post-install-script.sh
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
post_install_args
(オプション) ポストインストールスクリプトに渡される引用符で囲んだ引数のリストを指定します。
デフォルト値はありません。
post_install_args = "argument-1argument-2"
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
pre_install
(オプション) ノードデプロイブートストラップアクションが開始される前に実行されるプレインストールスクリプトへの URL を指定します。詳細については、「カスタムブートストラップアクション」を参照してください。
awsbatch をスケジューラとして使用する場合、プレインストールスクリプトはマスターノードでのみ実行されます。
パラメータの形式には、「http://」または「hostname/path/to/script.shs3://」を指定できます。bucket-name/path/to/script.sh
デフォルト値はありません。
pre_install = s3://bucket-name/my-pre-install-script.sh
更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。
pre_install_args
(オプション) プレインストールスクリプトに渡される引用符で囲んだ引数のリストを指定します。
デフォルト値はありません。
pre_install_args = "argument-3argument-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] セクション」を参照してください。
たとえば、次の設定では、 が開始する セクションを Amazon EC2 Auto Scaling 設定[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
Amazon EC2 Auto Scaling 設定で [scaling]セクションを識別します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。
詳細については、「[scaling] セクション」を参照してください。
たとえば、次の設定では、 が開始する セクション[scaling custom]が Amazon EC2 Auto Scaling 設定に使用されることを指定します。
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
(オプション) 使用するタグを定義します CloudFormation。
コマンドラインタグが --tags を介して指定されている場合は、設定タグとマージされます。
コマンドラインタグは、同じキーを持つタグ設定を上書きします。
タグは JSON 形式です。中括弧の外側に引用符を使用しないでください。
詳細については、「AWS CloudFormation ユーザーガイド」の「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
更新ポリシー: この設定が変更された場合、更新は許可されません。