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 執行個體類型。執行個體類型的架構必須與用於 InstanceType或 AWS Batch SlurmInstanceType設定的架構相同。

注意

AWS ParallelCluster 不支援下列執行個體類型的HeadNode設定。

  • hpc6id

如果您定義具有多個網路介面或網路介面卡的 p4d 執行個體類型或其他執行個體類型，您必須ElasticIp將 設定為 true以提供公有存取。 AWS 公有 IPs 只能指派給使用單一網路介面啟動的執行個體。在此情況下，我們建議您使用 NAT 閘道來提供叢集運算節點的公有存取權。如需詳細資訊，請參閱《Amazon EC2 Linux 執行個體使用者指南》中的在執行個體啟動期間指派公有 IPv4 地址。

更新政策：如果變更此設定，則不允許更新。

DisableSimultaneousMultithreading (選用，Boolean)

如果為 true， 會在前端節點上停用超執行緒。預設值為 false。

並非所有執行個體類型都可以停用超執行緒。如需支援停用超執行緒的執行個體類型清單，請參閱《Amazon EC2 使用者指南》中的每個執行個體類型的 CPU 核心和每個 CPU 核心的執行緒。

更新政策：如果變更此設定，則不允許更新。

SharedStorageType (選用，String)

指定用於內部共用資料的儲存體類型。內部共用資料包括 AWS ParallelCluster 用來管理叢集的資料，以及若未在 中指定SharedStorage 區段為掛載目錄以掛載共用檔案系統磁碟區/home時的預設共用資料。如需內部共用資料的詳細資訊，請參閱 AWS ParallelCluster 內部目錄。

如果 Ebs是預設儲存類型，則前端節點會將其根磁碟區的一部分匯出為運算節點和使用 NFS 登入節點的共用目錄。

如果為 Efs，則 ParallelCluster 會建立 EFS 檔案系統，以用於共用的內部資料和 /home。

更新政策：如果變更此設定，則不允許更新。

注意

當叢集向外擴展時，EBS 儲存類型可能會遇到效能瓶頸，因為前端節點會使用 NFS 匯出與運算節點共用根磁碟區中的資料。使用 EFS，您可以避免在叢集橫向擴展時匯出 NFS，並避免與其相關聯的效能瓶頸。建議為小型檔案和安裝程序的最大讀取/寫入潛力選擇 EBS。選擇 EFS 進行擴展。

Networking

（必要） 定義前端節點的聯網組態。

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

更新政策：如果變更此設定，則不允許更新。

Networking 屬性

SubnetId (必要，String)

指定要在其中佈建前端節點之現有子網路的 ID。

更新政策：如果變更此設定，則不允許更新。

ElasticIp (選用，String)

建立或指派彈性 IP 地址給前端節點。支援的值為 true、 false或現有彈性 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)

為現有的 Amazon EC2 金鑰對命名，以啟用對前端節點的 SSH 存取。

更新政策：如果變更此設定，則不允許更新。

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)

以 GB (GiB) 為單位指定前端節點根磁碟區大小。預設大小來自 AMI。使用不同的大小需要 AMI 支援 growroot。

更新政策：如果變更此設定，則不允許更新。

Encrypted (選用，Boolean)

指定根磁碟區是否已加密。預設值為 true。

更新政策：如果變更此設定，則不允許更新。

VolumeType (選用，String)

指定 Amazon EBS 磁碟區類型。支援的值為 gp2、gp3、io1、io2、st1、 sc1和 standard。預設值為 gp3。

如需詳細資訊，請參閱《Amazon EC2 使用者指南》中的 Amazon EBS 磁碟區類型。

更新政策：如果變更此設定，則不允許更新。

Iops (選用，Integer)

定義 io1、 io2和gp3類型磁碟區的 IOPS 數目。

預設值、支援的值和volume_iopsvolume_size比率會因 VolumeType和 而有所不同Size。

更新政策：如果變更此設定，則不允許更新。

VolumeType = io1

預設值 Iops = 100

支援的值 Iops = 100–64000 †

最大IopsSize比率 = 每 GiB 50 IOPS。5000 IOPS 需要至少 100 GiB Size的 。

VolumeType = io2

預設值 Iops = 100

支援的值 Iops = 100–64000 (io2區塊快速磁碟區為 256000) †

最大IopsSize比率 = 每 GiB 500 IOPS。5000 IOPS 需要至少 10 GiB Size的 。

VolumeType = gp3

預設 Iops = 3000

支援的值 Iops = 3000–16000

最大IopsSize比率 = 每 GiB 500 IOPS。5000 IOPS 需要至少 10 GiB Size的 。

† 只有在佈建超過 32，000 IOPS 的 Nitro 系統上建置的執行個體上，才能保證 IOPS 上限。其他執行個體保證高達 32，000 IOPS。除非您修改io1磁碟區，否則較舊的磁碟區可能無法達到完整效能。 https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html io2Block Express 磁碟區在R5b執行個體類型上最多支援 256000 個Iops值。如需詳細資訊，請參閱《Amazon EC2 使用者指南》中的 io2 Block Express 磁碟區。

更新政策：此設定可以在更新期間變更。

Throughput (選用，Integer)

定義gp3磁碟區類型的輸送量，以 MiB/s 為單位。此設定僅在 VolumeType為 時有效gp3。預設值為 125。支援的值：125–1000 MiB/s

Throughput 與 的比率Iops不可超過 0.25。1000 MiB/s 的最大輸送量要求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 並在從 傳回 URL 的 30 秒內連線至 Amazon DCV 工作階段時，才能連線至 Amazon DCV 連接埠pcluster dcv-connect。使用 AllowedIps設定進一步限制存取具有 CIDR 格式 IP 範圍的 Amazon DCV 連接埠，並使用 Port設定來設定非標準連接埠。

更新政策：如果變更此設定，則不允許更新。

Dcv 屬性

Enabled (必要，Boolean)

指定是否在前端節點上啟用 Amazon DCV。預設值為 false。

更新政策：如果變更此設定，則不允許更新。

注意

Amazon DCV 會自動產生自我簽署憑證，用於保護在前端節點上執行的 Amazon DCV 用戶端與 Amazon DCV 伺服器之間的流量。若要設定您自己的憑證，請參閱Amazon DCV HTTPS 憑證。

Port (選用，Integer)

指定 Amazon DCV 的連接埠。預設值為 8443。

更新政策：如果變更此設定，則不允許更新。

AllowedIps (選用、建議、String)

指定 Amazon DCV 連線的 CIDR 格式 IP 範圍。只有在 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 (選用)

要執行的指令碼清單。 會以與組態檔案中列出的相同順序 AWS ParallelCluster 執行指令碼，從第一個開始。

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，您可以列出自訂動作的多個指令碼。 AWS ParallelCluster 繼續支援使用單一指令碼設定自訂動作，而不包含 Sequence。

AWS ParallelCluster 不支援同時包含單一指令碼和Sequence相同的自訂動作。

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設定。

我們建議您指定一個或兩個 S3Access和 AdditionalIamPolicies設定，因為新增至 的功能 AWS ParallelCluster 通常需要新的許可。

更新政策：如果變更此設定，則不允許更新。

InstanceRole (選用，String)

指定執行個體角色以覆寫預設前端節點執行個體角色。您不能同時指定 InstanceProfile 和 InstanceRole。格式是 arn:Partition:iam::Account:role/RoleName。

如果指定此選項，則無法指定 S3Access和 AdditionalIamPolicies設定。

我們建議您指定一個或兩個 S3Access和 AdditionalIamPolicies設定，因為新增至 AWS ParallelCluster 的功能通常需要新的許可。

更新政策：此設定可以在更新期間變更。

S3Access

S3Access (選用)

指定儲存貯體。這用於產生政策，以授予儲存貯體的指定存取權。

如果指定此選項，則無法指定 InstanceProfile和 InstanceRole設定。

我們建議您指定一個或兩個 S3Access和 AdditionalIamPolicies設定，因為新增至 的功能 AWS ParallelCluster 通常需要新的許可。

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

更新政策：此設定可以在更新期間變更。

BucketName (必要，String)

儲存貯體的名稱。

更新政策：此設定可以在更新期間變更。

KeyName (選用，String)

儲存貯體的金鑰。預設值為 *。

更新政策：此設定可以在更新期間變更。

EnableWriteAccess (選用，Boolean)

指出是否已啟用儲存貯體的寫入存取。預設值為 false。

更新政策：此設定可以在更新期間變更。

AdditionalIamPolicies

AdditionalIamPolicies (選用)

指定 Amazon EC2 IAM 政策的 Amazon Resource Name (ARNs) 清單。除了 所需的許可之外，此清單還會連接到用於前端節點的根角色 AWS ParallelCluster。

IAM 政策名稱及其 ARN 不同。無法使用名稱。

如果指定此選項，則無法指定 InstanceProfile和 InstanceRole設定。

我們建議您使用 ，AdditionalIamPolicies因為 AdditionalIamPolicies 已新增至 AWS ParallelCluster 所需的許可，而且 InstanceRole 必須包含所有必要的許可。所需的許可經常隨發行版本新增功能而變更。

沒有預設值。

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-user在 Amazon 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存取權的叢集使用者可以執行 命令，選擇性地啟用或停用其他個別使用者的前端節點 IMDS 存取權，包括default使用者：

$ 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 的自訂 AMI ID。如需詳細資訊，請參閱AWS ParallelCluster AMI 自訂。

如果自訂 AMI 需要其他許可才能啟動，則必須將這些許可同時新增至使用者和前端節點政策。

例如，如果自訂 AMI 具有與其相關聯的加密快照，則使用者和前端節點政策都需要下列其他政策：

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:DescribeKey",
                "kms:ReEncrypt*",
                "kms:CreateGrant",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/<AWS_KMS_KEY_ID>"
            ]
        }
    ]
}

若要對自訂 AMI 驗證警告進行疑難排解，請參閱 對自訂 AMI 問題進行故障診斷。

更新政策：如果變更此設定，則不允許更新。