[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 テンプレートを定義します。この追加のテンプレートは、クラスターの外部にありながらクラスターのライフサイクルの一部であるリソースを作成するために使用されます。

この値は、すべてのパラメータが指定されているパブリックテンプレートへの 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 ベースのインスタンスでは、alinux2ubuntu1804ubuntu2004 のみがサポートされています。

注記

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_directorystack_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 の設定に置き換える必要があります。

有効なオプションは、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 ParallelCluster バージョン 2.8.0 で Graviton-based の AWS インスタンス (A1C6g インスタンスを含む) をサポートしました。

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

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 の代わりにヘッドノードおよびコンピューティングノードに使用するカスタム 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
注記

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_dnstrue に設定されている場合、ホストゾーンは作成されません。

デフォルト値は false です。

disable_cluster_dns = true
警告

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

重要

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_osalinux2centos7ubuntu1804、または 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 のエンドユーザー使用許諾契約書が承認されたことを示します。これにより、インテル 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 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 の両方が定義されており、schedulersgeslurm または torque の場合、ロールは作成されません。schedulerawsbatch であれば、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 インスタンス (A1C6g など) をサポートしました。

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

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 は、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
注記

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_typespot に設定されている場合にのみ使用されます。値を指定しない場合、オンデマンド料金を上限とするスポット料金が課金されます。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

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