Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

执行安全金丝雀更新

CloudWatch Synthetics 安全金丝雀更新功能允许在应用更改之前，在先对现有金丝雀的更新进行测试。此功能可帮助验证金丝雀与新运行时和其他配置更改（例如代码或内存更改）的兼容性。这将有助于最大限度地减少错误更新造成的潜在监控中断。

通过对运行时版本更新、配置更改和代码脚本修改使用金丝雀安全更新，您可以降低风险、保持不间断的监控、在提交和更新之前验证更改并减少停机时间。

先决条件

确保已满足先决条件。

最佳实践

下面是在执行金丝雀时可遵循的一些最佳实践。

使用试运行测试金丝雀

您可使用以下选项测试金丝雀更新：

使用 Amazon Web Services Management Console的“编辑”工作流程

使用 Amazon Web Services Management Console批量更新金丝雀

使用 Amazon CLI 或 SDK

API 开始对提供的金丝雀名称 MyCanary 进行试运行，并将运行时版本更新为 syn-nodejs-puppeteer-10.0。

aws synthetics start-canary-dry-run \
    --name MyCanary \
    --runtime-version syn-nodejs-puppeteer-10.0
      
      // Or if you wanted to update other configurations:

aws synthetics start-canary-dry-run \
    --name MyCanary \
    --execution-role-arn arn:aws:iam::123456789012:role/NewRole

API 将返回 DryRunConfigOutput 内的 DryRunId。

通过提供的 DryRunId 调用 GetCanary，获取金丝雀的试运行配置以及包含列为 LastDryRunExecutionStatus 的试运行状态的附加字段 DryRunConfig。

aws synthetics get-canary \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

有关更多详细信息，请将 GetCanaryRuns 与提供的 DryRunId 一起使用来检索运行和其他信息。

aws synthetics get-canary-runs \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

成功试运行后，即可将 UpdateCanary 与提供的 DryRunId 一起使用来提交更改。

aws synthetics update-canary \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

如果因任何原因失败（GetCanaryRuns 返回的结果会包含详细信息），GetCanaryRuns 的返回结果会有一个包含要调试的日志的构件位置。如果没有日志，则无法创建试运行。您可以使用 GetCanary 进行验证。

aws synthetics get-canary \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

State、StateReason 和 StateReasonCode 会显示试运行的状态。

使用 Amazon CloudFormation

在 Synthetics 金丝雀模板中，提供接受布尔值 true 或 false 的字段 DryRunAndUpdate。

当值为 true 时，每次更新都会执行试运行来验证更改，然后自动更新金丝雀。如果试运行失败，金丝雀不会更新，而且部署和 Amazon CloudFormation 部署会因有效原因失败。要调试此问题，请使用 Amazon Synthetics 控制台；如果使用 API 调试，请使用 GetCanaryRuns API 获取 ArtifactS3Location，然后下载 *-log.txt 文件，查看金丝雀日志执行中是否存在错误。验证后，修改 Amazon CloudFormation 模板并重试部署或使用上述 API 进行验证。

当值为 false 时，Synthetics 不会执行试运行来验证更改，而是直接提交您的更新。

有关对失败金丝雀进行问题排查的信息，请参阅排查失败金丝雀的问题。

示例模板：

SyntheticsCanary:
    Type: 'AWS::Synthetics::Canary'
    Properties:
      Name: MyCanary
      RuntimeVersion: syn-nodejs-puppeteer-10.0
      Schedule: {Expression: 'rate(5 minutes)', DurationInSeconds: 3600}
      ...
      DryRunAndUpdate: true

限制