部署自行管理的全球证书

---

本教程介绍如何使用 Certificate Manager 部署自行管理的全球证书。

以下负载平衡器支持自行管理的全球证书：

• 全球外部应用负载均衡器
• 传统应用负载均衡器
• 全局外部代理网络负载均衡器
• 跨区域内部应用负载均衡器

如需将自行管理的证书部署到区域级外部应用负载平衡器或区域级内部应用负载平衡器，请参阅部署自行管理的区域级证书。

目标

本教程介绍如何完成以下任务：

• 将自行管理的证书上传到证书管理器。
• 使用目标 HTTPS 代理将证书部署到受支持的负载均衡器。

如需详细了解证书部署流程，请参阅部署概览。

准备工作

1. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

2. 请确保您拥有以下角色以完成本教程中的任务：

   • Certificate Manager Owner：创建和管理证书管理器资源所需的权限。
   • Compute Load Balancer Admin 或 Compute Network Admin：创建和管理 HTTPS 目标代理所需的权限。

   详情请参阅以下内容：

   • Certificate Manager 的角色和权限
   • 适用于 Compute Engine 的 Compute Engine IAM 角色和权限
   注意 ：如果您未获得这些权限或角色，请与拥有 Project IAM Admin 角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理员联系，请其为您授予缺少的角色。

创建负载均衡器

创建要在其中部署证书的负载均衡器。

• 如需创建全局外部应用负载平衡器，请参阅设置具有虚拟机实例组后端的全局外部应用负载平衡器。

• 如需创建传统应用负载平衡器，请参阅使用代管式实例组后端设置传统应用负载平衡器。

• 如需创建全局外部代理网络负载平衡器 (SSL 代理)，请参阅设置具有虚拟机实例组后端的全球外部代理网络负载平衡器 (SSL 代理)。

• 如需创建全局外部代理网络负载平衡器 (TCP 代理)，请参阅使用虚拟机实例组后端设置全球外部代理网络负载平衡器 (TCP 代理)。

• 如需创建跨区域内部应用负载平衡器，请参阅使用虚拟机实例组后端设置跨区域内部应用负载平衡器。

本教程的其余部分假定您已配置负载均衡器的后端、健康检查、后端服务和网址映射。请记下网址映射的名称，因为在本教程后面部分，您需要用到它。

创建私钥和证书

如需创建私钥和证书，请执行以下操作：

1. 使用受信任的第三方证书授权机构 (CA) 颁发证书及其关联密钥。

2. 验证证书是否已正确链接且可信。

3. 准备以下 PEM 编码的文件：

   • 证书文件 (CRT)
   • 相应的私钥文件 (KEY)

如需了解如何请求和验证证书，请参阅创建私钥和证书。

将自行管理的证书上传到证书管理器

如需将证书上传到证书管理器，请执行以下操作：

对于全球外部应用负载平衡器、传统应用负载平衡器或全球外部代理网络负载平衡器：

运行以下命令：

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --certificate-file="CERTIFICATE_FILE" \
    --private-key-file="PRIVATE_KEY_FILE"

替换以下内容：

• CERTIFICATE_NAME：证书的唯一名称
• CERTIFICATE_FILE：CRT 证书文件的路径和文件名
• PRIVATE_KEY_FILE：KEY 私钥文件的路径和文件名

对于跨区域内部应用负载平衡器：

运行以下命令：

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --certificate-file="CERTIFICATE_FILE" \
    --private-key-file="PRIVATE_KEY_FILE" \
    --scope=all-regions

替换以下内容：

• CERTIFICATE_NAME：证书的唯一名称
• CERTIFICATE_FILE：CRT 证书文件的路径和文件名
• PRIVATE_KEY_FILE：KEY 私钥文件的路径和文件名

将自行管理的证书部署到负载均衡器

以下部分介绍了如何将您上传到证书管理器的自行管理的证书部署到负载均衡器。

根据负载均衡器类型，您可以按如下方式部署证书：

• 对于以下负载平衡器，请使用证书映射部署证书：
  • 全球外部应用负载均衡器
  • 全局外部代理网络负载均衡器
  • 传统应用负载均衡器
• 对于跨区域内部应用负载平衡器，通过将证书直接附加到目标代理来部署证书。

使用证书映射部署证书

本部分介绍了使用证书映射部署证书的步骤。

创建证书映射

创建一个证书映射，并引用与您的证书相关联的证书映射条目：

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

将 CERTIFICATE_MAP_NAME 替换为目标证书映射的名称。

创建证书映射条目

创建证书映射条目，并将其与您的自行管理的证书和证书映射相关联：

gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAME" \
    --hostname="HOSTNAME"

替换以下内容：

• CERTIFICATE_MAP_ENTRY_NAME：证书映射条目的唯一名称
• CERTIFICATE_MAP_NAME：证书映射条目附加到的证书映射名称
• CERTIFICATE_NAME：您要与证书映射条目关联的证书名称
• HOSTNAME：您要与证书映射条目关联的主机名

验证证书映射条目是否处于活动状态

在将证书映射附加到目标代理之前，请运行以下命令以验证证书映射条目是否处于活动状态：

gcloud certificate-manager maps entries describe CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME"

替换以下内容：

• CERTIFICATE_MAP_ENTRY_NAME：证书映射条目的唯一名称
• CERTIFICATE_MAP_NAME：证书映射条目附加到的证书映射名称

如果证书映射条目处于活跃状态，Google Cloud CLI 会返回类似于以下内容的输出：

createTime: '2021-09-06T10:01:56.229472109Z'
name: projects/my-project/locations/global/certificateMaps/myCertMap/certificateMapEntries/myCertMapEntry
state: ACTIVE
updateTime: '2021-09-06T10:01:58.277031787Z'

创建 HTTPS 目标代理

如需创建 HTTPS 目标代理，请参阅创建目标代理。

将证书映射附加到目标代理

如需将已配置的证书映射附加到目标代理，请按以下步骤操作：

1. 在 Google Cloud 控制台中，转到目标代理页面。

   打开“目标代理”

2. 记下目标代理的名称。

3. 如需将证书映射附加到目标代理，请运行以下命令：

   gcloud compute target-https-proxies update PROXY_NAME \
      --certificate-map="CERTIFICATE_MAP_NAME"
   

   替换以下内容：

   • PROXY_NAME：目标代理的名称
   • CERTIFICATE_MAP_NAME：引用您的证书映射条目及其关联证书的证书映射的名称

如果任何 TLS (SSL) 证书直接附加到代理，则代理会优先考虑证书映射引用的证书，而非直接附加的证书。

创建转发规则

设置转发规则并完成负载均衡器设置。如需了解详情，请参阅使用转发规则。

将证书直接附加到目标代理

如需将证书直接附加到代理，请运行以下命令：

gcloud compute target-https-proxies update PROXY_NAME \
    --url-map=URL_MAP \
    --global \
    --certificate-manager-certificates=CERTIFICATE_NAME

替换以下内容：

• PROXY_NAME：代理的唯一名称。
• URL_MAP：网址映射的名称。您在创建负载均衡器时创建了网址映射。
• CERTIFICATE_NAME：证书的名称。

清理

要还原您在本教程中所做的更改，请完成以下步骤：

1. 从代理分离证书映射：

   gcloud compute target-https-proxies update PROXY_NAME \
      --clear-certificate-map
   

   将 PROXY_NAME 替换为目标代理的名称。

   在从代理分离证书映射之前，请注意以下事项：

   • 请确保代理直接附加了至少一个 TLS (SSL) 证书。如果代理未附加任何证书，您将无法分离证书映射。
   • 将证书映射与代理分离后，代理可以继续使用直接附加到代理的 TLS (SSL) 证书。

2. 从证书映射中删除证书映射条目：

   gcloud certificate-manager maps entries delete CERTIFICATE_MAP_ENTRY_NAME \
      --map="CERTIFICATE_MAP_NAME"
   

   替换以下内容：

   • CERTIFICATE_MAP_ENTRY_NAME：目标证书映射条目的名称
   • CERTIFICATE_MAP_NAME：目标证书映射的名称

3. 删除证书映射：

   gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME
   

   将 CERTIFICATE_MAP_NAME 替换为目标证书映射的名称。

4. 删除上传的证书：

   gcloud certificate-manager certificates delete CERTIFICATE_NAME
   

   将 CERTIFICATE_NAME 替换为目标证书的名称。

后续步骤

• 管理证书
• 管理证书映射
• 管理证书映射条目