本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
[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