无服务器插件 Canary 部署

一个无服务器插件,用于执行 Lambda 函数的金丝雀部署,同时使用 交通换乘功能 结合 AWS 代码部署

目录

• 安装
• IAM 权限
• 使用量
• 配置
• 加那利警报
• 如何运作
• 限制
• 许可证

安装

npm i --save-dev @flagsmith/serverless-plugin-canary-deployments

IAM 权限

此插件创建并管理了多个 AWS 资源 。 IAM 用户或角色部署您的无服务器服务需要以下权限:

云阵

cloudformation:CreateStack
cloudformation:UpdateStack
cloudformation:DeleteStack
cloudformation:DescribeStacks
cloudformation:DescribeStackEvents
cloudformation:DescribeStackResource
cloudformation:GetTemplate
cloudformation:ValidateTemplate

代码部署

codedeploy:CreateApplication
codedeploy:DeleteApplication
codedeploy:GetApplication
codedeploy:CreateDeploymentGroup
codedeploy:DeleteDeploymentGroup
codedeploy:UpdateDeploymentGroup
codedeploy:GetDeploymentGroup
codedeploy:CreateDeployment
codedeploy:GetDeployment
codedeploy:StopDeployment

兰布达

lambda:CreateAlias
lambda:DeleteAlias
lambda:UpdateAlias
lambda:GetAlias
lambda:GetFunction
lambda:GetFunctionConfiguration
lambda:PublishVersion
lambda:ListVersionsByFunction
lambda:UpdateFunctionCode
lambda:UpdateFunctionConfiguration
lambda:AddPermission
lambda:RemovePermission

行政会议

iam:CreateRole
iam:DeleteRole
iam:GetRole
iam:PassRole
iam:AttachRolePolicy
iam:DetachRolePolicy
iam:PutRolePolicy
iam:DeleteRolePolicy

云表(用于警报)

cloudwatch:PutMetricAlarm
cloudwatch:DeleteAlarms
cloudwatch:DescribeAlarms
cloudwatch:PutCompositeAlarm

服务特定权限

根据触发您 Lambda 函数的事件源, 您可能需要:

代码调度服务角色

该插件创建了代码部署服务角色,并附有以下管理的政策:

• arn:aws:iam::aws:policy/service-role/AWSCodeDeployRoleForLambdaLimited
• arn:aws:iam::aws:policy/AWSLambda_FullAccess

如果你自己提供 codeDeployRole,确保它拥有同等的权限。 见 例-代码-部署-政策. json 供参考.

Lambda 执行角色

对于前/后交通钩报告部署状态,插件将此权限添加到您的 Lambda 执行角色中 :

codedeploy:PutLifecycleEventHookExecutionStatus

使用量

为了能够逐步部署Lambda函数,您 serverless.yml 应该是这样的:

service: canary-deployments
provider:
  name: aws
  runtime: nodejs6.10
  iamRoleStatements:
    - Effect: Allow
      Action:
        - codedeploy:*
      Resource:
        - "*"

plugins:
  - serverless-plugin-canary-deployments

functions:
  hello:
    handler: handler.hello
    events:
      - http: GET hello
    deploymentSettings:
      type: Linear10PercentEvery1Minute
      alias: Live
      preTrafficHook: preHook
      postTrafficHook: postHook
      alarms:
        - FooAlarm          # When a string is provided, it expects the alarm Logical ID
        - name: BarAlarm    # When an object is provided, it expects the alarm name in the name property

  preHook:
    handler: hooks.pre
  postHook:
    handler: hooks.post

您可以在 示例文件夹。 。 。 .

配置

• type: (需要)定义了Lambda函数版本之间的流量会如何转移. 它必须是以下之一:
  • Canary10Percent5Minutes:在第一次增量时转移10%的流量。 其余90%在五分钟后部署.
  • Canary10Percent10Minutes:在第一次增量时转移10%的流量。 其余90%在十分钟后部署.
  • Canary10Percent15Minutes:在第一次增量时转移10%的流量。 剩下的90%在15分钟后部署.
  • Canary10Percent30Minutes:在第一次增量时转移10%的流量。 其余90%在30分钟后部署.
  • Linear10PercentEvery1Minute:每分每分每分每分每分每分每分每分每分每分每分每分每分每分每分每分每分每分每分.
  • Linear10PercentEvery2Minutes:每两分钟调出10%的交通量,直到所有交通量转移为止.
  • Linear10PercentEvery3Minutes:每3分钟换行10%的交通量,直到所有交通量转移.
  • Linear10PercentEvery10Minutes:每10分钟调出10%的交通量,直到所有交通量转移.
  • AllAtOnce:将所有流量转移到新版本,在只需要执行验证钩时有用.
• alias: (需要)用于创建 Lambda 函数别名的名称.
• preTrafficHook: (可选)在交通转移前运行的Lambda函数. 它必须使用代码部署 SDK来通知这一步骤的成败(更多信息) 这里) (中文(简体) ).
• postTrafficHook: (可选)在交通转移后运行的Lambda功能验证. 它必须使用代码部署 SDK来通知这一步骤的成败(更多信息) 这里(中文(简体) )
• alarms: (可选)云表警报列表. 如果在部署过程中触发了其中任何一个,相关的Lambda函数会自动回滚到上个版本.
• triggerConfigurations: (可选) 代码部署触发器列表 。 详见 代码配置 :,或 本代码部署通知指南 例如,使用

默认配置

您可以在自定义配置的顶层区域设置所有函数的默认值。 例如:

custom:
  deploymentSettings:
    codeDeployRole: some_arn_value
    codeDeployRolePermissionsBoundary: some_arn_value
    stages:
      - dev
      - prod

functions:
  ...

一些值只能作为顶级配置提供. 它们是:

• codeDeployRole: (可选)一个 ARN 为 CodeDepload 指定一个现有的 IAM 角色. 如果缺席,将为您创造一个。 见 代码部署政策 以实例说明需要什么.
• codeDeployRolePermissionsBoundary: (可选) 指定一个已有的 IAM 权限边界的 ARN, 此权限边界设置在代码Deplerole 未定义时正在创建的代码部署上 .
• stages: (可选)您想要逐步部署功能的阶段列表。 如果不在场,它就假定这些就是全部.

加那利警报

加那利警报是特定版本的 Cloud Watch警报,只监视 新兰布达版本 在部署期间。 这解决了"先前存在的提醒"问题,因为之前版本的错误在ALARM状态中保留了提醒,所以部署失败了.

canaryAlarms 创建云表提醒 ExecutedVersion 维度,它只从正在部署的特定Lambda版本监测度量.

functions:
  hello:
    handler: handler.hello
    deploymentSettings:
      type: Canary10Percent5Minutes
      alias: Live
      canaryAlarms:
        - preset: errors    # Use preset configuration

配置

• canaryAlarms: (可选) 特定版本的 Cloud Watch 提醒列表要创建 。 每个警报可以是:

使用预设 :

canaryAlarms:
  - preset: errors            # Use 'errors' preset
  - preset: errors            # Override preset values
    threshold: 5

使用自定义配置 :

canaryAlarms:
  - metric: Duration
    threshold: 5000
    comparisonOperator: GreaterThanThreshold
    statistic: Average

预设 : errors

这个 errors 预设会用这些默认设置创建提醒 :

提醒属性

每个提醒在 canaryAlarms 必须使用 无论是 预设或自定义参数配置:

基于预设的提醒 (所需经费) preset:

下面的任何其他属性都可以被指定来推翻预设的默认.

自定义度量提醒 (所需经费) metric 财务报告和审定财务报表 threshold:

计算数学提醒 (所需经费) metrics, (中文(简体) ), expression,以及 threshold:

使用 云表量子数学 将多个度量衡合并到单个提醒中——例如,对错误率而不是绝对错误计数进行提醒:

canaryAlarms:
  - name: errorrate
    metrics:
      - id: errors
        metric: Errors
        statistic: Sum
      - id: invocations
        metric: Invocations
        statistic: Sum
    expression: "errors / invocations"
    threshold: 0.05
    comparisonOperator: GreaterThanThreshold

每个条目 metrics 拥有:

生成资源

当配置时 canaryAlarms,插件生成:

1. 每个功能的金丝雀警报器 与 ExecutedVersion 维度
2. 堆栈复合提醒 如果任何功能的金丝雀警报起火

复合提醒使用可预测的名称: ${service}-${stage}-canary-composite

使用标准提醒

你可以用两个 alarms 财务报告和审定财务报表 canaryAlarms 组合:

functions:
  hello:
    deploymentSettings:
      type: Canary10Percent5Minutes
      alias: Live
      alarms:
        - name: my-existing-alarm
      canaryAlarms:
        - preset: errors                      # Version-specific alarm

如何运作

该插件依赖于 AWS Lambda 交通换乘功能 以平衡各版本和 AWS 代码部署 自动更新其重量。 它修改了 CloudFormation 模板生成于 无服务器,以便:

1. 它为每个有部署设置的功能创建了 Lambda 函数 Alians.

• 对于由于提供货币或SnapStart配置而已经具有目标别名的函数,对其应用了"代码部署"相关设置.

2. 它创建了代码部署应用程序并增加了一个 代码部署组 根据指定的设置,每个Lambda函数.
3. 它修改了触发Lambda函数的事件,从而可以引用新创建的别名.

限制

目前, 插件只与 Lambda 函数工作

• API 网关
• 基于流(如由Kinesis, DynamoDB流或SQS所触发)
• 基于SNS的活动
• S3事件
• 云表监视排定的事件
• 云表日志
• IOT 规则
• AppSync 数据源
• 弹性LoadBalanceV2 目标组

更多活动 将很快增加.

许可证

公务员制度委员会 戴维·加西亚