Azure 容器应用中的自定义域名和自带证书

1. 在 Azure 门户中访问你的容器应用。

2. 通过在左窗格中的“网络”部分选择“入口”来验证应用是否已启用入口。 如果未启用入口，请通过完成以下步骤来启用它：

   1. 将 HTTP 入口设置为“已启用”。
   2. 选择所需的 入口流量 设置。
   3. 将 入口类型 设置为 HTTP。
   4. 输入目标端口。
   5. 选择“保存” 。

3. 在“ 网络 ”部分中，选择“ 自定义域”。

4. 选择“添加自定义域”。

5. 在 “添加自定义域和证书 ”窗格中的 TLS/SSL 证书下，选择“ 自带证书”。

6. 在 “域 ”框中，输入要添加的域。

7. 选择“添加证书”。

8. 在 “添加证书 ”窗格中的 “源 ”框中，选择“ 上传证书”（.pfx）， 然后浏览要上传的证书文件。

9. 选择“验证”。

10. 验证成功后，选择“ 添加”。

11. 在 “添加自定义域和证书 ”窗格中的 “证书”中，选择刚刚添加的证书。

12. 根据域 的类型选择主机名记录类型：

    域类型	记录类型	说明
    Apex 域	A 记录	顶级域是域根级别的域。 例如，如果 DNS 区域是 contoso.com，则 contoso.com 为顶点域。
    子域	CNAME	子域是属于另一个域的域。 例如，如果 DNS 区域为 contoso.com，则 www.contoso.com 是可在该区域中配置的子域的示例。

13. 使用托管域的 DNS 提供程序，使用“域验证”部分中显示的值根据所选的主机名记录类型创建 DNS 记录。 记录将域指向容器应用，并验证你是否拥有它。 设置取决于你是否在使用专用终结点功能时使用自定义域：

    • 常规
    • 专用终结点

    • 如果选择“A 记录”，请创建以下 DNS 记录：

      记录类型	主机	值
      A	@	容器应用环境的 IP 地址。
      TXT	asuid	域验证码。

    • 如果选择“CNAME”，请创建以下 DNS 记录：

      记录类型	主机	值
      CNAME	子域（例如，www）	你的容器应用所生成的域。
      TXT	asuid. 后跟子域（例如，asuid.www）	域验证码。

14. 选择“验证”。

15. 验证成功后，选择“ 添加”。

16. 作完成后，将在状态为 “安全”的自定义域列表中看到域名。 转到你的域以验证它是否可访问。

容器应用支持顶点域和子域。 每个域类型都需要不同的 DNS 记录类型和验证方法：

1. 使用 Azure CLI 登录到 Azure：

   az login
   

2. 安装 CLI 的 Azure 容器应用扩展：

   az extension add --name containerapp --upgrade
   

3. 设置以下环境变量。 将 <PLACEHOLDERS> 替换为你的值。

   RESOURCE_GROUP = "<RESOURCE_GROUP>"
   CONTAINER_APP = "<CONTAINER_APP>"
   ENVIRONMENT = "<ENVIRONMENT>"
   TARGET_PORT = "<TARGET_PORT>"
   DOMAIN_NAME = "<DOMAIN_NAME>"
   CERTIFICATE_LOWERCASE_NAME = "<CERTIFICATE_LOWERCASE_NAME>"
   CERTIFICATE_LOCAL_PATH = "<CERTIFICATE_LOCAL_PATH>"
   CERTIFICATE_PASSWORD = "<CERTIFICATE_PASSWORD>"
   

   • 将 <CERTIFICATE_LOCAL_PATH> 替换为你的证书文件的本地路径。
   • 用环境中唯一的小写证书名称替换 <CERTIFICATE_LOWERCASE_NAME>。
   • 将 <TARGET_PORT> 替换为你的容器应用正在侦听的端口。

4. 验证容器应用是否已启用 HTTP 入口：

   az containerapp ingress show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP
   

   如果未启用入口，请启用它：

   az containerapp ingress enable \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       --type external \
       --target-port $TARGET_PORT \
       --transport auto
   

5. 如果要配置顶点域，请获取容器应用环境的 IP 地址：

   az containerapp env show \
       -n $ENVIRONMENT \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.staticIp"
   

6. 如果要配置子域，请获取容器应用的自动生成域：

   az containerapp show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.configuration.ingress.fqdn"
   

7. 获取域验证码：

   az containerapp show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.customDomainVerificationId"
   

8. 使用托管域的 DNS 提供程序，使用 “域验证 ”部分中显示的值根据所选记录类型创建 DNS 记录。 记录将域指向容器应用，并验证你是否拥有它。 设置取决于你是否在使用专用终结点功能时使用自定义域：

   • 常规
   • 专用终结点

   • 如果选择“A 记录”，请创建以下 DNS 记录：

     记录类型	主机	值
     A	@	容器应用环境的 IP 地址。
     TXT	asuid	域验证码。

   • 如果选择“CNAME”，请创建以下 DNS 记录：

     记录类型	主机	值
     CNAME	子域（例如，www）	你的容器应用所生成的域。
     TXT	asuid. 后跟子域（例如，asuid.www）	域验证码。

9. 将证书上传到环境：

   az containerapp env certificate upload \
       -g $RESOURCE_GROUP \
       --name $ENVIRONMENT \
       --certificate-file $CERTIFICATE_LOCAL_PATH \
       --password $CERTIFICATE_PASSWORD \
       --certificate-name $CERTIFICATE_LOWERCASE_NAME
   

10. 将证书和域绑定到容器应用：

    az containerapp hostname bind \
        --hostname $DOMAIN_NAME \
        -g $RESOURCE_GROUP \
        -n $CONTAINER_APP \
        --environment $ENVIRONMENT \
        --certificate $CERTIFICATE_LOWERCASE_NAME \
        --validation-method <VALIDATION_METHOD>
    

    • 如果要配置 A 记录，请将 <VALIDATION_METHOD> 替换为 HTTP。

    • 如果要配置 CNAME，请将 <VALIDATION_METHOD> 替换为 CNAME。

    颁发证书并将域添加到你的容器应用可能需要几分钟时间。

11. 在操作完成后，转到您的域以检查它是否可访问。