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

# 安裝 PCUI
<a name="install-pcui-v3"></a>

UI AWS ParallelCluster (PCUI) 是以 Web 為基礎的使用者介面，可鏡射 AWS ParallelCluster `pcluster`CLI，同時提供類似主控台的體驗。您可以在 中安裝和存取 PCUI AWS 帳戶。當您執行它時，PCUI 會存取 中 Amazon AWS ParallelCluster API Gateway 上託管的 API 執行個體 AWS 帳戶。 Amazon API Gateway 如需 PCUI 的詳細資訊，請參閱 [AWS ParallelCluster UI](pcui-using-v3.md)。

**事前準備：**
+ 您必須擁有 AWS 帳戶
+ 您必須能夠存取 AWS 管理主控台

如需詳細資訊，請參閱[設定 AWS 帳戶](install-v3.md#setting-up)。

**Topics**
+ [安裝 PCUI](#install-pcui-steps-v3)
+ [堆疊參數](#install-pcui-steps-v3-stack-params)
+ [設定自訂網域](tutorials_08_custom_domain-v3.md)
+ [Amazon Cognito 使用者集區選項](install-pcui-cognito-v3.md)
+ [識別 AWS ParallelCluster 和 PCUI 版本](install-pcui-version-v3.md)
+ [PCUI 成本](install-pcui-costs-v3.md)

## 安裝 PCUI
<a name="install-pcui-steps-v3"></a>

若要安裝 UI AWS ParallelCluster (PCUI) 的執行個體，請為您建立叢集 AWS 區域 的 選擇一個 CloudFormation 快速建立連結。快速建立 URL 會帶您前往**建立堆疊精靈**，您可以在其中提供快速建立堆疊範本輸入並部署堆疊。如需 CloudFormation 快速建立堆疊的詳細資訊，請參閱*AWS CloudFormation 《 使用者指南*》中的[為堆疊建立快速建立連結](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stacks-quick-create-links.html)。

**注意**  
您只能使用安裝 PCUI 所用的相同 AWS ParallelCluster 版本來建立和編輯叢集或建置映像。

**使用 AWS CloudFormation 快速建立連結來部署具有巢狀 Amazon Cognito、API Gateway 和 Amazon EC2 Systems Manager 堆疊的 PCUI 堆疊。**

1. 登入 AWS 管理主控台。

1. 從此處清單中選擇 AWS 區域 快速建立連結來部署 PCUI。這將帶您前往 主控台中的 CloudFormation **Create Stack Wizard**。
   + [us-east-1](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [us-east-2](https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [us-west-1](https://us-west-1.console.aws.amazon.com/cloudformation/home?region=us-west-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [us-west-2](https://us-west-2.console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [eu-west-1](https://eu-west-1.console.aws.amazon.com/cloudformation/home?region=eu-west-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [eu-west-2](https://eu-west-2.console.aws.amazon.com/cloudformation/home?region=eu-west-2#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [eu-west-3](https://eu-west-3.console.aws.amazon.com/cloudformation/home?region=eu-west-3#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [eu-central-1](https://eu-central-1.console.aws.amazon.com/cloudformation/home?region=eu-central-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [eu-north-1](https://eu-north-1.console.aws.amazon.com/cloudformation/home?region=eu-north-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [me-south-1](https://me-south-1.console.aws.amazon.com/cloudformation/home?region=me-south-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [sa-east-1](https://sa-east-1.console.aws.amazon.com/cloudformation/home?region=sa-east-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [ca-central-1](https://ca-central-1.console.aws.amazon.com/cloudformation/home?region=ca-central-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [ap-northeast-1](https://ap-northeast-1.console.aws.amazon.com/cloudformation/home?region=ap-northeast-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [ap-northeast-2](https://ap-northeast-2.console.aws.amazon.com/cloudformation/home?region=ap-northeast-2#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [ap-south-1](https://ap-south-1.console.aws.amazon.com/cloudformation/home?region=ap-south-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [ap-southeast-1](https://ap-southeast-1.console.aws.amazon.com/cloudformation/home?region=ap-southeast-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [ap-southeast-2](https://ap-southeast-2.console.aws.amazon.com/cloudformation/home?region=ap-southeast-2#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)
   + [us-gov-west-1](https://console.amazonaws-us-gov.com/cloudformation/home?region=us-gov-west-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)

1. 輸入**管理員**電子郵件的有效電子郵件地址和 **ParallelCluster 版本**。

   部署成功完成後，PCUI 會將臨時密碼傳送至此電子郵件地址，供您用來存取 PCUI。如果您在儲存或使用臨時密碼之前刪除電子郵件，則必須刪除堆疊並重新安裝 PCUI。

1. 將表單的其餘部分保留空白，或輸入 （選用） 參數的值來自訂 PCUI 建置。

1. 請注意用於後續步驟的堆疊名稱。

1. 導覽至 **功能**。同意 CloudFormation 功能。

1. 選擇**建立**。完成 AWS ParallelCluster API 和 PCUI 部署大約需要 15 分鐘。

1. 在建立堆疊時檢視堆疊詳細資訊。

1. 部署完成後，開啟傳送至您輸入之地址且包含臨時密碼的管理員電子郵件。使用 存取 PCUI。（請記住，如果您在登入 PCUI 之前永久刪除電子郵件，則必須刪除您建立的 PCUI 堆疊，然後重新安裝 PCUI。

1. 在堆疊的 CloudFormation 主控台清單中，選擇您在上一個步驟中記下的堆疊名稱連結。

1. 在**堆疊詳細資訊**中，選擇**輸出**，然後選取名為 **{{Stackname}} URL **的金鑰連結以開啟 PCUI （其中 **{{Stackname}}** 是您在上一個步驟中記下的名稱）。

1. 輸入臨時密碼。依照步驟建立您自己的密碼並再次登入。

1. 您現在位於 AWS 區域 所選 中 PCUI 的首頁。

1. 若要開始使用 PCUI，請參閱 [使用 PCUI 設定和建立叢集](configure-create-pcui-v3.md)。

**注意**  
 PCUI 工作階段的預設持續時間為 5 分鐘，這是 Cognito 自 PCUI 2023.12.0 起提供的最小值。因此，預期從 Cognito 使用者集區移除的使用者仍然可以存取系統，直到工作階段過期為止。

## 堆疊參數
<a name="install-pcui-steps-v3-stack-params"></a>

**AdditionalPoliciesPCAPI：**  
描述：（選用） 附加至 ParallelCluster Lambda 函數預設執行角色之其他 IAM 政策的 ARN。只能指定一個政策。  
類型：字串  
預設：''  
AllowedPattern： "^(arn：.\*：iam：：.\*：policy\\\\/(【a-zA-Z0-9\_-】＋)))\|()$"

**AdminUserEmail：**  
描述：預設要設定之管理使用者的電子郵件地址 （僅適用於新的 Cognito 執行個體）。  
類型：字串  
預設：''

**CognitoCustomDomain：**  
描述：（選用） Cognito 的自訂網域名稱。如果省略，將使用預設的 Cognito 網域名稱。  
類型：字串  
預設：''

**CognitoCustomDomainCertificateArn：**  
描述：（選用） 為 Cognito 自訂網域發行之 ACM 憑證的 ARN。只有在指定 時`CognitoCustomDomain`，才需要此項目。  
類型：字串  
預設：''

**CustomDomain：**  
描述：（選用） 自訂網域名稱。如果省略，將使用預設網域名稱。  
類型：字串  
預設：''

**CustomDomainCertificateArn：**  
描述：（選用） 針對自訂網域發行之 ACM 憑證的 ARN。只有在指定 時`CustomDomain`，才需要此項目。  
類型：字串  
預設：''

**IAMRoleAndPolicyPrefix：**  
描述：套用至每個 IAM 角色和政策名稱的字首 （長度上限：10)。【ParallelCluster >= 3.8.0】  
類型：字串  
預設：''  
MaxLength：10

**ImageBuilderSubnetId：**  
描述：（選用） 選取要用於建置容器映像的子網路。子網路必須是公有和自動指派IPs。如果未選取，則會使用預設子網路。  
類型：字串  
預設：''

**ImageBuilderVpcId：**  
描述：（選用） 選取要用於建置容器映像的 VPC。如果未選取，則會使用預設 VPC。  
類型：字串  
預設：''

**InfrastructureBucket：**  
描述：（選用） 存放 CloudFormation 檔案的 S3 儲存貯體。只有在測試對基礎設施本身所做的變更時，才變更此參數。  
類型：字串  
預設：''

**LambdaSecurityGroupIds：**  
描述：要與 PCUI Lambda 函數建立關聯的安全群組逗號分隔清單。  
類型：CommaDelimitedList  
預設：''

**LambdaSubnetIds：**  
描述：要與 PCUI Lambda 函數建立關聯的以逗號分隔的子網路 IDs 清單。這些子網路應為私有，並與您的 VPC 端點相關聯。  
類型：CommaDelimitedList  
預設：''

**PermissionsBoundaryPolicy：**  
描述：用於 ParallelCluster UI 基礎設施所建立之每個 IAM 角色的許可界限的 IAM 政策 ARN。  
類型：字串  
預設：''  
AllowedPattern： "^(arn：.\*：iam：：.\*：policy\\\\/(【a-zA-Z0-9\_-】＋)))\|()$"

**PermissionsBoundaryPolicyPCAPI：**  
描述：IAM 政策的 ARN，用於 ParallelCluster API 基礎設施建立的每個 IAM 角色的許可界限。【ParallelCluster >= 3.8.0】  
類型：字串  
預設：''  
AllowedPattern： "^(arn：.\*：iam：：.\*：policy\\\\/(【a-zA-Z0-9\_-】＋)))\|()$"

**PublicEcrImageUri：**  
描述：指定時，ParallelCluster UI 容器 Lambda 的 Docker 映像 URI。  
類型：字串  
預設：public.ecr.aws/pcm/parallelcluster-ui：2024.11.0

**SNSRole：**  
描述：先前部署之 PCUI Cognito Stack 的 SNSRole ARN。保留空白以建立新的。  
類型：字串  
預設：''

**UserPoolAuthDomain：**  
描述：先前部署之 PCUI Cognito 使用者集區的 UserPoolAuthDomain。保留空白以建立新的。  
類型：字串  
預設：''

**UserPoolId：**  
描述：先前部署之 PCUI Cognito 使用者集區的 UserPoolId。保留空白以建立新的。  
類型：字串  
預設：''

**版本：**  
描述：要部署的 AWS ParallelCluster 版本。  
類型：字串  
預設：3.11.1

**VpcEndpointId：**  
描述：輸入 VPC 端點，其類型界面適用於 execute-api 服務，以啟用私有 PCUI 實作。啟用時，API 只會接受來自指定 VPC 內的請求。  
類型：字串  
預設：''