[efs] 區段 - AWS ParallelCluster

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

[efs] 區段

定義掛接在主節點和運算節點上之 Amazon EFS 的組態設定。如需詳細資訊,請參閱CreateFileSystem馬遜 EFS API 參考中的。

若要了解如何在叢集定義中包含 Amazon EFS 檔案系統,請參閱[cluster] 區段/efs_settings

若要將現有的 Amazon EFS 檔案系統用於獨立於叢集生命週期的長期永久儲存,請指定efs_fs_id

如果未指定efs_fs_id,請在AWS ParallelCluster建立叢集時從[efs]設定建立 Amazon EFS 檔案系統,並在刪除叢集時刪除檔案系統和資料。

如需詳細資訊,請參閱最佳做法:將叢集移至新叢集 AWS ParallelCluster 次要或修補程式版本

格式為[efs efs-name]efs-name 必須以字母開頭,不得超過 30 個字元,且只能包含字母、數字、連字號 (-) 和底線 (_)。

[efs customfs] shared_dir = efs encrypted = false performance_mode = generalPurpose

efs_fs_id

(選擇性) 定義現有檔案系統的 Amazon EFS 檔案系統 ID。

指定此選項會使除以外的shared_dir所有其他 Amazon EFS 選項失效。

如果您設定此選項,它只支援下列類型的檔案系統:

  • 堆疊的可用區域中沒有掛載目標的檔案系統。

  • 在堆疊的可用區域中具有現有掛載目標且允許輸入和輸出 NFS 流量的檔案系統0.0.0.0/0

驗證 efs_fs_id 的例行性檢查,需要 IAM 角色才能擁有以下許可:

  • elasticfilesystem:DescribeMountTargets

  • elasticfilesystem:DescribeMountTargetSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeSecurityGroups

  • ec2:DescribeNetworkInterfaceAttribute

若要避免錯誤,您必須將這些許可新增至 IAM 角色,或設定 sanity_check = false

重要

當您設定允許輸入和輸出 NFS 流量的掛載目標時0.0.0.0/0,它會將檔案系統公開給掛載目標可用區域中任何位置的 NFS 掛載要求。 AWS不建議在堆疊的可用區域中建立掛載目標。相反,讓我們AWS處理這一步。如果您想要在堆疊的可用區域中有掛載目標,請考慮使用自訂安全性群組,方法是在區[vpc]段下方提供vpc_security_group_id選項。然後,將該安全性群組新增至裝載目標,並關閉sanity_check以建立叢集。

沒有預設值。

efs_fs_id = fs-12345

更新政策:如果變更此設定,則不允許更新。

efs_kms_key_id

(選擇性) 識別要用來保護加密檔案系統的 AWS Key Management Service (AWS KMS) 客戶管理金鑰。如果設定此選項,則必須將 encrypted 設定設為 true。這對應於亞馬遜 EFS API KmsKeyId參考中的參數。

沒有預設值。

efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab

更新政策:如果變更此設定,則不允許更新。

encrypted

(選擇性) 指出檔案系統是否已加密。這對應於 Amazon EFS API 參考資料中的加密參數。

預設值為 false

encrypted = true

更新政策:如果變更此設定,則不允許更新。

performance_mode

(選擇性) 定義檔案系統的效能模式。這對應於亞馬遜 EFS API PerformanceMode參考中的參數。

有效的選項為下列值:

  • generalPurpose

  • maxIO

這兩個值都區分大小寫。

我們建議對大部分檔案系統使用 generalPurpose 效能模式。

使用 maxIO 效能模式的檔案系統可擴展到更高階的彙總輸出量和每秒操作數。但是,對於大多數文件操作來說,延遲時間會稍高一些。

建立檔案系統之後,就無法變更此參數。

預設值為 generalPurpose

performance_mode = generalPurpose

更新政策:如果變更此設定,則不允許更新。

provisioned_throughput

(選擇性) 定義檔案系統的佈建輸送量,以 Mb/s 為單位。這對應於亞馬遜 EFS API ProvisionedThroughputInMibps參考中的參數。

如果使用此參數,則必須將 throughput_mode 設為 provisioned

輸送量的配額為 1024 Mb/s。若要要求增加配額,請聯絡 AWS Support。

最小值為 0.0 MiB/s。

provisioned_throughput = 1024

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

shared_dir

(必要) 定義主節點和運算節點上的 Amazon EFS 掛載點。

此為必要參數。只有在已指定的情況下,才會使用 Amazon EFS 區段。shared_dir

請勿使用NONE/NONE作為共用目錄。

下列範例會將亞馬遜 EFS 裝載於/efs

shared_dir = efs

更新政策:如果變更此設定,則不允許更新。

throughput_mode

(選擇性) 定義檔案系統的輸送量模式。這對應於亞馬遜 EFS API ThroughputMode參考中的參數。

有效的選項為下列值:

  • bursting

  • provisioned

預設值為 bursting

throughput_mode = provisioned

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