[cluster] セクション - AWS ParallelCluster

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

[cluster] セクション

クラスターを作成するために使用できるクラスターテンプレートを定義します。設定ファイルには、複数の [cluster] セクションを含めることができます。

同じクラスターテンプレートを使用して、複数のクラスターを作成できます。

形式は [cluster cluster-template-name] です。[global] セクションcluster_template 設定によって名付けられた[cluster] セクションがデフォルトで使用されますが、pcluster コマンドラインでオーバーライドすることができます。

cluster-template-name は文字で始まり、30 文字以内で、文字、数字、ハイフン (-)、アンダースコア (_) のみを含む必要があります。

[cluster default]

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 ベースのインスタンスでは、alinux2ubuntu1804、または のみがサポート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_directoryresource_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 の設定に置き換える必要があります。

有効なオプションは、ondemandspot です。

デフォルト値は 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.microoptimal です。

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

(オプション) デフォルトで公開AMIsAMIされている の代わりに、ヘッドノードとコンピューティングノードに使用するカスタムの ID を指定します。詳細については、AMI を変更する または カスタム AWS ParallelCluster 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 ログ設定で [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_dnstrue に設定されている場合、ホストゾーンは作成されません。

デフォルト値は false です。

disable_cluster_dns = true
警告

クラスターが正常に動作するためには、名前解決システムが必要です。disable_cluster_dnstrue に設定した場合、追加の名前解決システムも提供する必要があります。

重要

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_osalinux2centos7ubuntu1804、または です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 のエンドユーザー使用許諾契約書が承認されたことを示します。これにより、インテル Parallel Studio がマスターノードにインストールされ、コンピューティングノードと共有されます。これにより、ヘッドノードのブートストラップに要する時間が数分長くなります。enable_intel_hpc_platform この設定は でのみサポートされています CentOS 7 (base_os = 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_roleec2_iam_role および iam_lambda_role の両方が定義されており、schedulersgeslurm または torque の場合、ロールは作成されません。schedulerawsbatch であれば、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 は、schedulerslurm に設定されている場合にのみサポートされます。cluster_typecompute_instance_typeinitial_queue_sizemaintain_initial_sizemax_queue_sizeplacementplacement_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

更新ポリシー: この設定が変更された場合、更新は許可されません。