使用 CloudFront 持续部署来安全地测试 CDN 配置更改

创建暂存分发和持续部署策略（控制台）

1. 登录 Amazon Web Services Management Console，并通过以下网址打开 CloudFront 控制台：https://console.amazonaws.cn/cloudfront/v3/home。

2. 在导航窗格中，选择 Distributions (分配)。

3. 选择要用作主分发的分发。主分发是当前为生产流量提供服务的分发，您将从中创建暂存分发。

4. 在 Continuous deployment（持续部署）部分中，选择 Create staging distribution（创建暂存分发）。这将打开 Create staging distribution（创建暂存分发）向导。

5. 在 Create staging distribution（创建暂存分发）向导中，执行以下操作：

   1. （可选）键入暂存分发的描述。

   2. 选择 Next（下一步）。

   3. 修改暂存分发的配置。有关您可以更新的设置的更多信息，请参阅更新主分发和暂存分发。

      修改完暂存分发的配置后，选择 Next（下一步）。

   4. 使用控制台指定 Traffic configuration（流量配置）。这将决定 CloudFront 如何将流量路由到暂存分发。（CloudFront 将流量配置存储在持续部署策略中。）

      有关 Traffic configuration（流量配置）中的选项的更多信息，请参阅将请求路由到暂存分发。

      完成 Traffic configuration（流量配置）后，选择 Next（下一步）。

   5. 查看暂存分发的配置，包括流量配置，然后选择 Create staging distribution（创建暂存分发）。

更新暂存分发（控制台）

1. 通过 https://console.amazonaws.cn/cloudfront/v3/home 打开 CloudFront 控制台

2. 在导航窗格中，选择 Distributions (分配)。

3. 选择主分发。这是当前为生产流量提供服务的分发，您将从中创建暂存分发。

4. 选择 View staging distribution（查看暂存分发）。

5. 使用控制台修改暂存分发的配置。有关您可以更新的设置的更多信息，请参阅更新主分发和暂存分发。

更新持续部署策略（控制台）

1. 通过 https://console.amazonaws.cn/cloudfront/v3/home 打开 CloudFront 控制台

2. 在导航窗格中，选择 Distributions (分配)。

3. 选择主分发。这是当前为生产流量提供服务的分发，您将从中创建暂存分发。

4. 在 Continuous deployment（持续部署）部分中，选择 Edit policy（编辑策略）。

5. 修改持续部署策略中的流量配置。在完成后，选择保存更改。

提升暂存分发的配置（控制台）

1. 通过 https://console.amazonaws.cn/cloudfront/v3/home 打开 CloudFront 控制台

2. 在导航窗格中，选择 Distributions (分配)。

3. 选择主分发。这是当前为生产流量提供服务的分发，您将从中创建暂存分发。

4. 在 Continuous deployment（持续部署）部分中，选择 Promote（提升）。

5. 键入 confirm，然后选择 Promote（提升）。

创建暂存分发（CLI）

1. 将 aws cloudfront get-distribution 和 grep 命令结合使用以获取要用作主分发分发的 ETag 值。主分发是当前为生产流量提供服务的分发，将从中创建暂存分发。

   以下命令是一个示例。在以下示例中，将 primary_distribution_ID 替换为主分发的 ID。

   
   aws cloudfront get-distribution --id primary_distribution_ID | grep 'ETag'

   复制 ETag 值，因为您需要它来执行下一个步骤。

2. 使用 aws cloudfront copy-distribution 命令创建暂存分发。以下示例命令使用转义字符（\）和换行符来提高可读性，但您应在该命令中省略这些字符。在以下示例命令中：

   • 将 primary_distribution_ID 替换为主分发的 ID。

   • 将 primary_distribution_ETag 替换为主分发的 ETag 值（您已在上一步中获得）。

   • （可选）将 CLI_example 替换为所需的调用方参考 ID。

   
   aws cloudfront copy-distribution --primary-distribution-id primary_distribution_ID \
                                    --if-match primary_distribution_ETag \
                                    --staging \
                                    --caller-reference 'CLI_example'

   该命令的输出显示了有关暂存分发及其配置的信息。复制暂存分发的 CloudFront 域名，因为您在下一步中需要使用它。

创建持续部署策略（带输入文件的 CLI）

1. 使用以下命令创建名为 continuous-deployment-policy.yaml 的文件，其中包含 create-continuous-deployment-policy 命令的所有输入参数。以下命令使用转义字符（\）和换行符来提高可读性，但您应在该命令中省略这些字符。

   
   aws cloudfront create-continuous-deployment-policy --generate-cli-skeleton yaml-input \
                                                      > continuous-deployment-policy.yaml

2. 打开刚创建的名为 continuous-deployment-policy.yaml 的文件。编辑该文件以指定所需的持续部署策略设置，然后保存该文件。当您编辑该文件时：

   • 在 StagingDistributionDnsNames 部分中：

     • 将 Quantity 的值更改为 1。

     • 对于 Items，粘贴暂存分发的 CloudFront 域名（您已在上一步中保存）。

   • 在 TrafficConfig 部分中：

     • 选择 Type（SingleWeight 或 SingleHeader）。

     • 删除其他类型的设置。例如，如果您需要基于权重的流量配置，请将 Type 设置为 SingleWeight，然后删除 SingleHeaderConfig 设置。

     • 要使用基于权重的流量配置，请将 Weight 的值设置为介于 .01（百分之一）和 .15（百分之十五）之间的十进制数。

     有关 TrafficConfig 中的选项的更多信息，请参阅将请求路由到暂存分发和基于权重的配置的会话粘性。

3. 使用以下命令通过 continuous-deployment-policy.yaml 文件中的输入参数创建持续部署策略。

   
   aws cloudfront create-continuous-deployment-policy --cli-input-yaml file://continuous-deployment-policy.yaml

   复制命令输出中的 Id 值。这是持续部署策略 ID，您在下一步中需要它。

将持续部署策略附加到主分发（带输入文件的 CLI）

1. 使用以下命令将主分发的配置保存到一个名为 primary-distribution.yaml 的文件中。将 primary_distribution_ID 替换为主分发的 ID。

   
   aws cloudfront get-distribution-config --id primary_distribution_ID --output yaml > primary-distribution.yaml

2. 打开刚创建的名为 primary-distribution.yaml 的文件。编辑文件，进行以下更改：

   • 将持续部署策略 ID（从上一步中复制的）粘贴到 ContinuousDeploymentPolicyId 字段中。

   • 将 ETag 字段重命名为 IfMatch，但不更改字段的值。

   完成后保存该文件。

3. 使用以下命令更新主分发以使用持续部署策略。将 primary_distribution_ID 替换为主分发的 ID。

   
   aws cloudfront update-distribution --id primary_distribution_ID --cli-input-yaml file://primary-distribution.yaml

更新暂存分发（带输入文件的 CLI）

1. 使用以下命令将暂存分发的配置保存到一个名为 staging-distribution.yaml 的文件中。将 staging_distribution_ID 替换为暂存分发的 ID。

   
   aws cloudfront get-distribution-config --id staging_distribution_ID --output yaml > staging-distribution.yaml

2. 打开刚创建的名为 staging-distribution.yaml 的文件。编辑文件，进行以下更改：

   • 修改暂存分发的配置。有关您可以更新的设置的更多信息，请参阅更新主分发和暂存分发。

   • 将 ETag 字段重命名为 IfMatch，但不更改字段的值。

   完成后保存该文件。

3. 使用以下命令更新暂存分发的配置。将 staging_distribution_ID 替换为暂存分发的 ID。

   
   aws cloudfront update-distribution --id staging_distribution_ID --cli-input-yaml file://staging-distribution.yaml

更新持续部署策略（带输入文件的 CLI）

1. 使用以下命令将持续部署策略的配置保存到一个名为 continuous-deployment-policy.yaml 的文件中。将 continuous_deployment_policy_ID 替换为持续部署策略的 ID。以下命令使用转义字符（\）和换行符来提高可读性，但您应在该命令中省略这些字符。

   
   aws cloudfront get-continuous-deployment-policy-config --id continuous_deployment_policy_ID \
                                                          --output yaml > continuous-deployment-policy.yaml

2. 打开刚创建的名为 continuous-deployment-policy.yaml 的文件。编辑文件，进行以下更改：

   • 根据需要修改持续部署策略的配置。例如，您可以从使用基于标头的流量配置更改为使用基于权重的流量配置，也可以更改基于权重的配置的流量百分比（权重）。有关更多信息，请参阅 将请求路由到暂存分发 和 基于权重的配置的会话粘性：

   • 将 ETag 字段重命名为 IfMatch，但不更改字段的值。

   完成后保存该文件。

3. 使用以下命令更新持续部署策略。将 continuous_deployment_policy_ID 替换为持续部署策略的 ID。以下命令使用转义字符（\）和换行符来提高可读性，但您应在该命令中省略这些字符。

   
   aws cloudfront update-continuous-deployment-policy --id continuous_deployment_policy_ID \
                                                      --cli-input-yaml file://continuous-deployment-policy.yaml

提升暂存分发的配置（CLI）

• 使用 aws cloudfront update-distribution-with-staging-config 命令将暂存分发的配置提升为主分发。以下示例命令使用转义字符（\）和换行符来提高可读性，但您应在该命令中省略这些字符。在以下示例命令中：

  • 将 primary_distribution_ID 替换为主分发的 ID。

  • 将 staging_distribution_ID 替换为暂存分发的 ID。

  • 将 primary_distribution_ETag 和 staging_distribution_ETag 分别替换为主分发和暂存分发的 ETag 值。确保主分发的值是第一个，如示例所示。

  
  aws cloudfront update-distribution-with-staging-config --id primary_distribution_ID \
                                                         --staging-distribution-id staging_distribution_ID \
                                                         --if-match 'primary_distribution_ETag,staging_distribution_ETag'