[cluster] セクション

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

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

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

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

更新ポリシー: この設定は、更新中に変更できます。

base_os

(必須) クラスターで使用する OS タイプを指定します。

使用できるオプションは、以下のとおりです。

centos7 をサポートしていない下表の特定の AWS リージョン 以外。その他の AWS 商用リージョンは、以下の OS をすべてサポートします。

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_type

(オプション) 起動するクラスターのタイプを定義します。queue_settings の設定が定義されている場合、この設定は [queue] セクションの compute_type の設定に置き換える必要があります。

有効なオプションは、ondemand と spot です。

デフォルト値は ondemand です。

スポットインスタンスの詳細については、「スポットインスタンスの操作」を参照してください。

aws iam create-service-linked-role --aws-service-name spot.amazonaws.com

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

更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。

compute_root_volume_size

(オプション) ComputeFleet のルートボリュームのサイズをジビバイト (GiB) 単位で指定します。AMI が growroot をサポートしている必要があります。

デフォルト値は 35 です。

compute_root_volume_size = 35

更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。

custom_ami

(オプション) デフォルトの公開された AMI の代わりにヘッドノードおよびコンピューティングノードに使用するカスタム AMI の 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 Logs の設定を持つ [cw_log] セクションを特定します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。

詳しくは、「[cw_log] セクション」、「Amazon CloudWatch ダッシュボード」、「Amazon CloudWatch Logs との統合」を参照してください。

例えば、[cw_log custom-cw] で始まるセクションを指定する次の設定が CloudWatch Logs 設定で使用されます。

cw_log_settings = custom-cw

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

dashboard_settings

(オプション) CloudWatch ダッシュボードの設定を持つ [dashboard] セクションを特定します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。

詳細については、「[dashboard] セクション」を参照してください。

例えば、[dashboard custom-dashboard で始まるセクションを指定する次の設定が CloudWatch ダッシュボード 設定で使用されます。

dashboard_settings = custom-dashboard

更新ポリシー: この設定は、更新中に変更できます。

dcv_settings

(オプション) Amazon DCV 設定がある [dcv] セクションを識別します。セクション名は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。

詳細については、「[dcv] セクション」を参照してください。

例えば、次の設定は、[dcv custom-dcv] を開始するセクションを Amazon DCV 設定で使用することを指定します。

dcv_settings = custom-dcv

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

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_hyperthreading

(Optional) ヘッドノードとコンピューティングノードでハイパースレッディングを無効にします。すべてのインスタンスタイプがハイパースレッディングを無効にできるわけではありません。ハイパースレッディングの無効化をサポートするインスタンスタイプの一覧については、「Amazon EC2 ユーザーガイド」の「インスタンスタイプ別の CPU コア数と CPU コアごとのスレッド数」を参照してください。queue_settings の設定が定義されている場合、この設定を定義するか、[queue] セクションの disable_hyperthreading の設定を定義することができます。

デフォルト値は false です。

disable_hyperthreading = true

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

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

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

enable_efa_gdr

(オプション) AWS ParallelCluster バージョン 2.11.3 より、この設定は無効となりました。Elastic Fabric Adapter (EFA) の GPUDirect RDMA (リモートディレクトメモリーアクセス) のサポートは、インスタンスタイプとオペレーティングシステムの両方でサポートされていれば、常に有効です。

enable_efa_gdr = compute

更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。

enable_intel_hpc_platform

(オプション) 存在する場合は、インテル Parallel Studio のエンドユーザー使用許諾契約書が承認されたことを示します。これにより、インテル Parallel Studio がマスターノードにインストールされ、コンピューティングノードと共有されます。これにより、ヘッドノードのブートストラップに要する時間が数分長くなります。enable_intel_hpc_platform 設定は CentOS 7 (base_os = centos7) でのみサポートされています。

デフォルト値は false です。

enable_intel_hpc_platform = true

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

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 = {}

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」を参照してください。

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

更新ポリシー: この設定は、更新中に変更できます。

initial_queue_size

(オプション) クラスターでコンピューティングノードとして起動する Amazon EC2 インスタンスの最初の数を設定します。queue_settings の設定が定義されている場合、この設定は削除され、[compute_resource] セクションの initial_count の設定に置き換わります。

この設定は、従来のスケジューラ (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

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

maintain_initial_size

(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

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

master_root_volume_size

(オプション) ヘッドノードルートボリュームサイズをジビバイト (GiB) 単位で指定します。AMI が growroot をサポートしている必要があります。

デフォルト値は 35 です。

master_root_volume_size = 35

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

max_queue_size

(オプション) クラスターで起動可能な最大数の Amazon EC2 インスタンスの最大数を設定します。queue_settings の設定が定義されている場合、この設定は削除され、[compute_resource] セクションの max_count の設定に置き換わります。

この設定は、従来のスケジューラ (SGE、Slurm、Torque) にのみ適用されます。

スケジューラが awsbatch の場合は、max_vcpus を使用します。

デフォルトは 10 です。

max_queue_size = 10

更新ポリシー: この設定はアップデート中に変更することができますが、値が小さくなった場合はコンピューティングフリートを停止する必要があります。そうでなければ、既存のノードを終了させることができます。

max_vcpus

(オプション) コンピューティング環境での vCPU の最大数を指定します。スケジューラが awsbatch の場合にのみ使用します。

デフォルト値は 20 です。

max_vcpus = 20

更新ポリシー: これらの設定は、更新中に減らすことはできません。

min_vcpus

(オプション) awsbatch スケジューラの Auto Scaling グループの最初のサイズを維持します。

スケジューラが 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 に設定されている場合、一意のプレイスメントグループはクラスタースタックの一部として作成され、削除されます。

このパラメータは、スケジューラが 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 文字以下で、小文字の英字、数字、ハイフン (-) のみで構成される必要があります。

最大で 5 つの [queue] セクションに対応しています。

詳細については、「[queue] セクション」を参照してください。

例えば、以下の設定では、[queue q1] と [queue q2] で始まるセクションが使用されるように指定します。

queue_settings = q1, q2

更新ポリシー: この設定を更新で変更するためには、コンピューティングフリートを停止する必要があります。

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

(必須) クラスターのスケジューラを定義します。

有効なオプションは、次の値です。

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

(オプション) 従来のスケジューラ (SGE、Slurm、および Torque) で必要に応じて ComputeFleet の最大スポット料金を設定します。cluster_type が spot に設定されている場合にのみ使用されます。値を指定しない場合、オンデマンド料金を上限とするスポット料金が課金されます。queue_settings の設定が定義されている場合、この設定は削除され、[compute_resource] セクションの spot_price の設定に置き換わります。

スケジューラが awsbatch の場合は、代わりに spot_bid_percentage を使用します。

ニーズに合ったスポットインスタンスを見つける方法については、「スポットインスタンスアドバイザー」を参照してください。

spot_price = 1.50

更新ポリシー: この設定は、更新中に変更できます。

tags

(オプション) AWS CloudFormation で使用するタグを定義します。

コマンドラインタグが --tags を介して指定されている場合は、設定タグとマージされます。

コマンドラインタグは、同じキーを持つタグ設定を上書きします。

タグは JSON 形式です。中括弧の外側に引用符を使用しないでください。

詳細については、「AWS CloudFormation ユーザーガイド」の「AWS CloudFormation リソースタグタイプ」を参照してください。

tags = {"key" : "value", "key2" : "value2"}

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

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

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