HeadNode セクション - AWS ParallelCluster
HeadNode のプロパティNetworkingSshLocalStorageDcvCustomActionsIamImdsImage

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

HeadNode セクション

(必須) ヘッドノードの設定を指定します。

HeadNode:
  InstanceType: string
  Networking:
    SubnetId: string
    ElasticIp: string/boolean
    SecurityGroups:
      - string
    AdditionalSecurityGroups:
      - string
    Proxy:
      HttpProxyAddress: string
  DisableSimultaneousMultithreading: boolean
  Ssh:
    KeyName: string
    AllowedIps: string
  LocalStorage:
    RootVolume:
      Size: integer
      Encrypted: boolean
      VolumeType: string
      Iops: integer
      Throughput: integer
      DeleteOnTermination: boolean
    EphemeralVolume:
      MountDir: string
  SharedStorageType: string
  Dcv:
    Enabled: boolean
    Port: integer
    AllowedIps: string
  CustomActions:
    OnNodeStart:
      Sequence:
        - Script: string
          Args:
            - string
      Script: string
      Args:
        - string
    OnNodeConfigured:
      Sequence:
        - Script: string
          Args:
            - string
      Script: string
      Args:
        - string
    OnNodeUpdated:
      Sequence:
        - Script: string
          Args: 
            - string
      Script: string
      Args:
        - string
  Iam:
    InstanceRole: string
    InstanceProfile: string
    S3Access:
      - BucketName: string
        EnableWriteAccess: boolean
        KeyName: string
    AdditionalIamPolicies:
      - Policy: string
  Imds:
    Secured: boolean
  Image:
    CustomAmi: string

HeadNode のプロパティ

InstanceType (必須)、String)

ヘッドノードのインスタンスタイプを指定します。

ヘッドノードに使用される Amazon EC2インスタンスタイプを指定します。インスタンスタイプのアーキテクチャは、 または に使用されるアーキテクチャと同じである必要があります。 AWS Batch InstanceTypeSlurm InstanceType 設定。

注記

AWS ParallelCluster は、 HeadNode設定で次のインスタンスタイプをサポートしていません。

  • hpc6id

複数のネットワークインターフェイスまたはネットワークインターフェイスカードを持つ p4d インスタンスタイプまたは別のインスタンスタイプを定義する場合は、パブリックアクセスを提供するtrueように ElasticIp を設定する必要があります。 AWS パブリックは、単一のネットワークインターフェイスで起動されたインスタンスにのみ割り当てIPsることができます。この場合、NATゲートウェイを使用してクラスターコンピューティングノードへのパブリックアクセスを提供することをお勧めします。詳細については、「Linux インスタンス用 Amazon ユーザーガイド」の「インスタンスの起動中にパブリックIPv4アドレスを割り当てる」を参照してください。 EC2

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

DisableSimultaneousMultithreading (オプション、Boolean)

true の場合、ヘッドノードのハイパースレッディングを無効にします。デフォルト値は false です。

すべてのインスタンスタイプがハイパースレッディングを無効にできるわけではありません。ハイパースレッディングの無効化をサポートするインスタンスタイプのリストについては、Amazon EC2ユーザーガイドのCPU「インスタンスタイプごとの各コアのCPUコアとスレッド」を参照してください。

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

SharedStorageType (オプション、String)

内部共有データに使用されるストレージのタイプを指定します。内部共有データには、 AWS ParallelCluster を使用してクラスターを管理し、 で共有ファイルシステムボリュームをマウントするマウントディレクトリSharedStorage セクションとして指定/homeされていない場合は、デフォルトの共有データが含まれます。内部共有データの詳細については、「」を参照してくださいAWS ParallelCluster 内部ディレクトリ。

デフォルトのストレージタイプEbsである の場合、ヘッドノードは を使用して、ルートボリュームの一部をコンピューティングノードとログインノードの共有ディレクトリとしてエクスポートしますNFS。

の場合Efs、Parallelcluster は内部データの共有と に使用するEFSファイルシステムを作成します/home。

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

注記

クラスターがスケールアウトすると、ヘッドノードがNFSエクスポートを使用してルートボリュームからのデータをコンピューティングノードと共有するため、EBSストレージタイプにパフォーマンスのボトルネックが発生する可能性があります。を使用するとEFS、クラスターのスケールアウトに伴うNFSエクスポートを回避し、それに関連するパフォーマンスのボトルネックを回避できます。小さなファイルやインストールプロセスの最大読み取り/書き込み可能性EBSとして を選択することが推奨されます。スケールEFSを選択します。

Networking

(必須) ヘッドノードのネットワーク設定を定義します。

Networking:
  SubnetId: string
  ElasticIp: string/boolean
  SecurityGroups:
    - string
  AdditionalSecurityGroups:
    - string
  Proxy:
    HttpProxyAddress: string

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

Networking のプロパティ

SubnetId (必須、String)

ヘッドノードをプロビジョニングする既存のサブネットの ID を指定します。

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

ElasticIp (オプション、String)

ヘッドノードに Elastic IP アドレスを作成または割り当てます。サポートされる値は、true、false、または既存の Elastic IP アドレスの ID です。デフォルト: false。

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

SecurityGroups (オプション、[String])

ヘッドノードに使用する Amazon VPC セキュリティグループ ID のリスト。これらは、このプロパティが含まれていない場合に が AWS ParallelCluster 作成するセキュリティグループを置き換えます。

セキュリティグループがSharedStorageシステムに正しく設定されていることを確認します。

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

AdditionalSecurityGroups (オプション、[String])

ヘッドノードに使用する追加の Amazon VPC セキュリティグループ ID のリスト。

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

Proxy (オプション ）

ヘッドノードのプロキシ設定を指定します。

Proxy:
  HttpProxyAddress: string
HttpProxyAddress (オプション、String)

HTTP またはHTTPSプロキシサーバーを定義します。通常は ですhttps://x.x.x.x:8080。

デフォルト値はありません。

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

Ssh

（オプション） ヘッドノードSSHにアクセスするための設定を定義します。

Ssh:
  KeyName: string
  AllowedIps: string

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

Ssh のプロパティ

KeyName (オプション、String)

ヘッドノードSSHへのアクセスを有効にする既存の Amazon EC2キーペアに名前を付けます。

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

AllowedIps (オプション、String)

ヘッドノードSSHへの接続の CIDR形式の IP 範囲またはプレフィックスリスト ID を指定します。デフォルト: 0.0.0.0/0。

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

LocalStorage

(オプション) ヘッドノードのローカルストレージ構成を定義します。

LocalStorage:
  RootVolume:
    Size: integer
    Encrypted: boolean
    VolumeType: string
    Iops: integer
    Throughput: integer
    DeleteOnTermination: boolean
  EphemeralVolume:
    MountDir: string

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

LocalStorage のプロパティ

RootVolume (必須)

ヘッドノードのルートボリュームストレージを指定します。

RootVolume:
  Size: integer
  Encrypted: boolean
  VolumeType: string
  Iops: integer
  Throughput: integer
  DeleteOnTermination: boolean

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

Size (オプション、Integer)

ヘッドノードルートボリュームサイズをジビバイト (GiB) 単位で指定します。デフォルトのサイズは から取得されますAMI。別のサイズを使用するには、 が AMIをサポートしている必要がありますgrowroot。

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

Encrypted (オプション、Boolean)

ルートボリュームを暗号化するかどうかを指定します。デフォルト値は true です。

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

VolumeType (オプション、String)

Amazon EBSボリュームタイプ を指定します。サポートされている値は gp2、gp3、io1、io2、sc1、st1 および standard です。デフォルト値は gp3 です。

詳細については、「Amazon ユーザーガイド」の「Amazon EBSボリュームタイプ」を参照してください。 EC2

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

Iops (オプション、Integer)

io1、、io2および gp3タイプのボリュームIOPSの の数を定義します。

デフォルト値、対応値、volume_iops 対 volume_size の比率は、VolumeType と Size で異なります。

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

VolumeType = io1

デフォルト Iops = 100

サポートする値 Iops = 100 — 64000 †

最大Iops対Size比 = 50IOPS/GiB 。5000 には、少なくとも 100 GiB Sizeの IOPSが必要です。

VolumeType = io2

デフォルト Iops = 100

サポートする値 Iops = 100 — 64000 (io2 Block Express ボリュームの場合は 256000) †

最大Iops対Size比 = 500IOPS/GiB 。5000 には、少なくとも 10 GiB Sizeの IOPSが必要です。

VolumeType = gp3

デフォルト Iops = 3000

サポートされる値 Iops = 3000 — 16000

最大Iops対Size比 = 500IOPS/GiB 。5000 には、少なくとも 10 GiB Sizeの IOPSが必要です。

† 最大IOPSは、32,000 を超える でプロビジョニングされた Nitro System 上に構築されたインスタンスでのみ保証されますIOPS。その他のインスタンスでは、最大 32,000 を保証しますIOPS。ボリュームを変更しない限り、古い io1 ボリュームはパフォーマンスが完全にはならないことがあります。io2Block Express ボリュームは、R5b インスタンスタイプで最大 256000 までの Iops 値をサポートします。詳細については、「Amazon EC2ユーザーガイド」の「io2Express ボリュームのブロック」を参照してください。

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

Throughput (オプション、Integer)

gp3 ボリュームタイプのスループットを MiB/秒で定義します。この設定は、VolumeType が gp3 の場合のみ有効です。デフォルト値は 125 です。サポートされる値: 125 — 1000 MIB/秒

Throughput と Iops の比率は 0.25 以下にします。最大のスループットである 1000 MiB/秒を実現するためには、Iops の設定を 4000 以上にする必要があります。

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

DeleteOnTermination (オプション、Boolean)

ヘッドノードの終了時にルートボリュームを削除するかどうかを指定します。デフォルト値は true です。

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

EphemeralVolume (オプション ）

任意のインスタンスストアボリュームの詳細を指定します。詳細については、「Amazon ユーザーガイド」の「インスタンスストアボリューム」を参照してください。 EC2 

EphemeralVolume:
  MountDir: string

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

MountDir (オプション、String)

インスタンスストアボリュームのマウントディレクトリを指定します。デフォルト: /scratch。

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

Dcv

（オプション） ヘッドノードで実行されている Amazon DCVサーバーの設定を定義します。

詳細については、「Amazon 経由でヘッドノードとログインノードに接続する DCV」を参照してください。

Dcv:
  Enabled: boolean
  Port: integer
  AllowedIps: string
重要

デフォルトでは、 による Amazon DCV ポート設定 AWS ParallelCluster はすべてのIPv4アドレスに対して開かれています。ただし、Amazon DCVセッションURL用の がある場合にのみ Amazon DCV ポートに接続し、 URL が から返されてから 30 秒以内に Amazon DCVセッションに接続できますpcluster dcv-connect。AllowedIps 設定を使用して、 CIDR形式の IP 範囲を持つ Amazon DCV ポートへのアクセスをさらに制限し、 Port設定を使用して非標準ポートを設定します。

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

Dcv のプロパティ

Enabled (必須)、Boolean)

ヘッドノードで Amazon DCVを有効にするかどうかを指定します。デフォルト値は false です。

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

注記

Amazon は、ヘッドノードで実行されている Amazon DCVクライアントと Amazon DCVサーバー間のトラフィックを保護するために使用される自己署名証明書DCVを自動的に生成します。独自の証明書を設定するには、「Amazon DCVHTTPS証明書」を参照してください。

Port (オプション、Integer)

Amazon のポートを指定しますDCV。デフォルト値は 8443 です。

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

AllowedIps (オプション、推奨)、String)

Amazon への接続の CIDR形式の IP 範囲を指定しますDCV。この設定は、 がセキュリティグループ AWS ParallelCluster を作成する場合にのみ使用されます。デフォルト値は 0.0.0.0/0 で、すべてのインターネットアドレスからのアクセスを許可します。

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

CustomActions

(オプション) ヘッドノードで実行するカスタムスクリプトを指定します。

CustomActions:
  OnNodeStart:
    Sequence:
      - Script: string
        Args:
          - string
    Script: string
    Args:
      - string
  OnNodeConfigured:
    Sequence:
      - Script: string
        Args:
          - string
    Script: string
    Args:
      - string
  OnNodeUpdated:
    Sequence:
      - Script: string
        Args: 
          - string
    Script: string
    Args: 
      - string

CustomActions のプロパティ

OnNodeStart (オプション ）

ノードデプロイのブートストラップアクションが開始される前にヘッドノードで実行する単一のスクリプトまたは一連のスクリプトを指定します。詳細については、「カスタムブートストラップアクション」を参照してください。

Sequence (オプション ）

run. AWS ParallelCluster run するスクリプトのリスト。 は、設定ファイルに記載されているのと同じ順序でスクリプトを実行します。最初の から開始します。

Script (必須)、String)

使用するファイルを指定します。ファイルパスは https:// または s3:// で始まる必要があります。

Args (オプション、[String])

スクリプトに渡す引数のリスト。

Script (必須)、String)

単一のスクリプトに使用するファイルを指定します。ファイルパスは https:// または s3:// で始まる必要があります。

Args (オプション、[String])

単一のスクリプトに渡す引数のリスト。

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

OnNodeConfigured (オプション ）

ノードのブートストラップアクションが完了した後に、ヘッドノードで実行する単一のスクリプトまたは一連のスクリプトを指定します。詳細については、「カスタムブートストラップアクション」を参照してください。

Sequence (オプション ）

実行するスクリプトのリストを指定します。

Script (必須)、String)

使用するファイルを指定します。ファイルパスは https:// または s3:// で始まる必要があります。

Args (オプション、[String])

スクリプトに渡す引数のリスト。

Script (必須)、String)

単一のスクリプトに使用するファイルを指定します。ファイルパスは https:// または s3:// で始まる必要があります。

Args (オプション、[String])

単一のスクリプトに渡す引数のリスト。

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

OnNodeUpdated (オプション ）

ノードの更新アクションが完了した後に、ヘッドノードで実行する単一のスクリプトまたは一連のスクリプトを指定します。詳細については、「カスタムブートストラップアクション」を参照してください。

Sequence (オプション ）

実行するスクリプトのリストを指定します。

Script (必須)、String)

使用するファイルを指定します。ファイルパスは https:// または s3:// で始まる必要があります。

Args (オプション、[String])

スクリプトに渡す引数のリスト。

Script (必須)、String)

単一のスクリプトに使用するファイルを指定します。ファイルパスは https:// または s3:// で始まる必要があります。

Args (オプション、[String])

単一のスクリプトに渡す引数のリスト。

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

注記

OnNodeUpdated は AWS ParallelCluster 3.4.0 以降で追加されました。

Sequence バージョン 3.6.0 AWS ParallelCluster 以降で追加されました。を指定するとSequence、カスタムアクションの複数のスクリプトを一覧表示できます。 は、 を含めずに、1 つのスクリプトでカスタムアクションを設定することを AWS ParallelCluster 引き続きサポートしますSequence。

AWS ParallelCluster は、同じカスタムアクションSequenceに 1 つのスクリプトと の両方を含めることをサポートしていません。

Iam

(オプション) クラスターのデフォルトのインスタンスロールまたはインスタンスプロファイルをオーバーライドするために、ヘッドノードで使用するインスタンスロールまたはインスタンスプロファイルのいずれかを指定します。

Iam:
  InstanceRole: string
  InstanceProfile: string
  S3Access:
    - BucketName: string
      EnableWriteAccess: boolean
      KeyName: string
  AdditionalIamPolicies:
    - Policy: string

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

Iam のプロパティ

InstanceProfile (オプション、String)

デフォルトのヘッドノードのインスタンスプロファイルをオーバーライドするインスタンスプロファイルを指定します。InstanceProfile と InstanceRole の両方を指定することはできません。形式は arn:Partition:iam::Account:instance-profile/InstanceProfileName です。

これを指定すると、S3Access と AdditionalIamPolicies の設定を指定することはできません。

に追加された機能には新しいアクセス許可が必要になる AWS ParallelCluster ことが多いため、 S3Accessと AdditionalIamPoliciesの設定の一方または両方を指定することをお勧めします。

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

InstanceRole (オプション、String)

デフォルトのヘッドノードのインスタンスロールをオーバーライドするインスタンスロールを指定します。InstanceProfile と InstanceRole の両方を指定することはできません。形式は arn:Partition:iam::Account:role/RoleName です。

これを指定すると、S3Access と AdditionalIamPolicies の設定を指定することはできません。

に追加された機能には新しいアクセス許可が必要になる AWS ParallelCluster ことが多いため、 S3Accessと AdditionalIamPoliciesの設定の一方または両方を指定することをお勧めします。

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

S3Access

S3Access (オプション ）

バケットを指定します。これは、指定されたアクセスをバケットに付与するためのポリシーを生成するために使用されます。

これを指定すると、InstanceProfile と InstanceRole の設定を指定することはできません。

に追加された機能には新しいアクセス許可が必要になる AWS ParallelCluster ことが多いため、 S3Accessと AdditionalIamPoliciesの設定の一方または両方を指定することをお勧めします。

S3Access:
  - BucketName: string
    EnableWriteAccess: boolean
    KeyName: string

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

BucketName (必須)、String)

バケットの名前。

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

KeyName (オプション、String)

バケットのキーです。デフォルト値は「*」です。

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

EnableWriteAccess (オプション、Boolean)

バケットに対して書き込みアクセスが可能かどうかを示す。デフォルト値は false です。

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

AdditionalIamPolicies

AdditionalIamPolicies (オプション ）

Amazon のIAMポリシーの Amazon リソースネーム (ARNs) EC2 のリストを指定します。このリストは、 に必要なアクセス許可に加えて、ヘッドノードに使用されるルートロールにアタッチされます AWS ParallelCluster。

IAM ポリシー名とポリシー名ARNは異なります。名前を使用することはできません。

これを指定すると、InstanceProfile と InstanceRole の設定を指定することはできません。

AdditionalIamPolicies が必要なアクセス許可に が追加され、 AWS ParallelCluster に必要なすべてのアクセス許可が に含まれているInstanceRole必要があるAdditionalIamPoliciesため、 を使用することをお勧めします。必要な権限は、機能が追加されるにつれ、リリースごとに変更されることがよくあります。

デフォルト値はありません。

AdditionalIamPolicies:
  - Policy: string

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

Policy (オプション、[String])

IAM ポリシーのリスト。

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

Imds

（オプション） インスタンスメタデータサービス () のプロパティを指定しますIMDS。詳細については、「Amazon EC2ユーザーガイド」の「インスタンスメタデータサービスバージョン 2 の仕組み」を参照してください。

Imds:
    Secured: boolean

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

Imds のプロパティ

Secured (オプション、Boolean)

の場合true、 はヘッドノード IMDS (およびインスタンスプロファイル認証情報) へのアクセスをスーパーユーザーのサブセットに制限します。

の場合false、ヘッドノードのすべてのユーザーはヘッドノードの にアクセスできますIMDS。

次のユーザーは、ヘッドノードの へのアクセスが許可されていますIMDS。

  • ルートユーザー

  • クラスターの管理者ユーザー (デフォルトでは pc-cluster-admin)

  • オペレーティングシステム固有のデフォルトユーザー (ec2-userAmazon Linux 2 および RedHat、Ubuntu 18.04 ubuntuの場合。

デフォルト: true。

default ユーザーは、クラスターが AWS リソースを操作するために必要なアクセス許可を持っていることを確認する責任があります。default ユーザーIMDSアクセスを無効にすると、 はコンピューティングノードを管理 AWS ParallelCluster できず、動作が停止します。default ユーザーIMDSアクセスを無効にしないでください。

ユーザーにヘッドノードの へのアクセスが付与されるとIMDS、ヘッドノードのインスタンスプロファイル に含まれるアクセス許可を使用できます。例えば、これらのアクセス許可を使用して Amazon EC2インスタンスを起動したり、クラスターが認証に使用するように設定された AD ドメインのパスワードを読み取ったりすることができます。

IMDS アクセスを制限するには、 のチェーン AWS ParallelCluster を管理しますiptables。

sudo アクセス権限を持つクラスターユーザーは、 コマンドを実行して、defaultユーザーを含むIMDS他の個々のユーザーのヘッドノードへのアクセスを選択的に有効または無効にできます。

$ sudo /opt/parallelcluster/scripts/imds/imds-access.sh --allow <USERNAME>

このコマンド--denyのオプションを使用して、ユーザーIMDSアクセスを無効にできます。

知らないうちにdefaultユーザーIMDSアクセスを無効にする場合は、 --allowオプションを使用してアクセス許可を復元できます。

注記

iptables または ip6tablesルールのカスタマイズは、ヘッドノードIMDSへのアクセスを制限するために使用されるメカニズムを妨げる可能性があります。

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

Image

(オプション) ヘッドノードのカスタムイメージを定義します。

Image:
     CustomAmi: string

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

Image のプロパティ

CustomAmi (オプション、String)

デフォルトの ではなくAMI、ヘッドノードに使用するカスタムの ID を指定しますAMI。詳細については、「AWS ParallelCluster AMI カスタマイズ」を参照してください。

カスタムが起動に追加のアクセス許可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>"
             ]                                                    
         }
     ]
  }

カスタムAMI検証警告のトラブルシューティングについては、「」を参照してくださいカスタムAMI問題のトラブルシューティング。

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