本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置自定义域
<a name="tutorials_08_custom_domain-v3"></a>

了解如何为 AWS ParallelCluster 用户界面 (PCUI) 配置自定义网域。UI 托管在您的 AWS 账户中的 Amazon API Gateway 上。您可以在 API Gateway 控制台中配置自定义域。

**先决条件：**
+ 你有一个 AWS 账户.
+ 您拥有域。
+ 域根目录是可解析的。例如，如果您想`xyz.example.com`用作自定义域，则根域`example.com`必须是可解析的。这意味着您必须至少有 A 记录才能`example.com`指向 IP。如果你没有这样的记录，请添加一个指向 0.0.0.0 的虚拟记录。
+ 您已在 us-east-1 中为 Cognito 创建自定义域名证书或将其导入到 AWS Certificate Manager (ACM) 中。
+ 您拥有更改域名系统（DNS）设置的必要权限。

**Topics**
+ [

# 部署 PCUI
](tutorials_08_custom_domain-v3-deploy-pcui.md)
+ [

# 配置 DNS
](tutorials_08_custom_domain-v3-config-dns.md)

# 部署 PCUI
<a name="tutorials_08_custom_domain-v3-deploy-pcui"></a>

完成以下步骤以创建或更新您的 AWS ParallelCluster UI (PCUI) 部署，使其使用您的自定义域。

在此示例中，我们假设您要使用自定义域 `xyz.example.com` 部署 PCUI，并使用自定义域 `auth-xyz.example.com` 部署 Amazon Cognito 接口。

**注意**  
请注意，自定义 Amazon Cognito 域不是必需的，可以保留默认值。为了完整起见，我们将此自定义设置包括在内。

**注意**  
 AWS GovCloud (US) Regions不支持 Amazon Cognito 的自定义域。

为此，请使用以下参数部署 PCUI 堆栈：
+ **CustomDomain:** *xyz.example.com*.
+ **CustomDomainCertificateArn：**亚马逊资源名称 (ARN) 的 ACM 证书。*xyz.example.com*
+ **CognitoCustomDomain:** *auth-xyz.example.com*.
+ **CognitoCustomDomainCertificateArn**到 ACM 证书的 Amazon 资源名称 (ARN)。*xyz.example.com*

# 配置 DNS
<a name="tutorials_08_custom_domain-v3-config-dns"></a>

完成以下步骤来配置您的域名服务 (DNS)，以便 AWS ParallelCluster 用户界面 (PCUI) 和 Amazon Cognito 对所需的自定义域名做出响应。

此示例假设您要使用自定义域 `xyz.example.com` 部署 PCUI，并使用自定义域 `auth-xyz.example.com` 部署 Amazon Cognito 接口。

1. 使用以下参数部署 PCUI 堆栈：
   + **CustomDomainEndpoint：**在您的 DNS 中创建 A 记录*xyz.example.com*，该记录指向输出中指定的别名。
   + **CognitoCustomDomainEndpoint：**在您的 DNS 中创建 A 记录*auth-xyz.example.com*，该记录指向输出中指定的别名。

1. 等待约 10 分钟，以便可以分发 DNS 更改。

1. 分发 DNS 更改后，PCUI 对 *xyz.example.com/pcui* 进行响应，Amazon Cognito 身份验证页面对 *auth-xyz.example.com* 进行响应。