DeploymentPreference

점진적 Lambda 배포를 지원하는 구성을 지정합니다. 점진적 Lambda 배포 구성에 대한 자세한 내용은 서버리스 애플리케이션의 점진적 배포을 참조하세요.

참고

AutoPublishAlias 객체를 사용하려면 AWS::Serverless::Function에서 DeploymentPreference을 지정해야 합니다. 그렇지 않으면 오류가 발생합니다.

구문

AWS Serverless Application Model (AWS SAM) 템플릿에서 이 엔티티를 선언하려면 다음 구문을 사용하십시오.

YAML

  Alarms: List
  Enabled: Boolean
  Hooks: Hooks
  PassthroughCondition: Boolean
  Role: String
  TriggerConfigurations: List
  Type: String

속성

Alarms

배포로 인해 발생한 오류로 인해 트리거되기를 원하는 CloudWatch 알람 목록입니다.

이 속성은 Fn::If 내장 함수를 받아들입니다. Fn::If를 사용하는 예제 템플릿은 이 항목 하단의 예제 섹션을 참조하세요.

유형: 목록

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

Enabled

이 배포 환경 설정이 활성화되어 있는지 여부입니다.

유형: 부울

필수 항목 여부: 아니요

기본값: True

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

Hooks

트래픽 이동 전후에 실행되는 Lambda 함수를 검증합니다.

유형: Hooks

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

PassthroughCondition

True인 경우 이 배포 기본 설정이 활성화된 경우 함수의 조건이 생성된 CodeDeploy 리소스로 전달됩니다. 일반적으로 이 값을 True로 설정해야 합니다. 그렇지 않으면 함수의 Condition이 False로 확인되더라도 CodeDeploy 리소스가 생성됩니다.

유형: 부울

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

Role

트래픽 이동에 사용할 IAM 역할 CodeDeploy ARN입니다. 이것이 제공되면 IAM 역할이 생성되지 않습니다.

타입: 문자열

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 이에 상응하는 속성이 없습니다. AWS CloudFormation

TriggerConfigurations

배포 그룹에 연결하고자 하는 트리거 구성의 목록입니다. 라이프사이클 이벤트에 관한 SNS 주제를 알리는 데 사용됩니다.

유형: 목록

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::CodeDeploy::DeploymentGroup 리소스의 TriggerConfigurations 속성으로 직접 전달됩니다.

Type

현재 배포 유형에는 Linear와 Canary라는 두 가지 카테고리가 있습니다. 사용할 수 있는 배포 유형에 대한 자세한 내용은 서버리스 애플리케이션의 점진적 배포섹션을 참조하세요.

타입: 문자열

필수 항목 여부: 예

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

예

DeploymentPreference 사전 및 사후 트래픽 후크가 있습니다.

트래픽 전후 훅이 포함된 배포 환경 설정 예입니다.

YAML

DeploymentPreference:
  Enabled: true
  Type: Canary10Percent10Minutes 
  Alarms:
    - Ref: AliasErrorMetricGreaterThanZeroAlarm
    - Ref: LatestVersionErrorMetricGreaterThanZeroAlarm
  Hooks:
    PreTraffic:
      Ref: PreTrafficLambdaFunction
    PostTraffic:
      Ref: PostTrafficLambdaFunction

DeploymentPreference Fn: :If 내장 함수 사용

알람 구성에 Fn::If를 사용하는 배포 환경 설정의 예입니다. 이 예제에서는 Alarm1가 MyCondition인 경우 true이 구성되고, Alarm2이 Alarm5이면 MyCondition 및 false가 구성될 것입니다.

YAML

DeploymentPreference:
  Enabled: true
  Type: Canary10Percent10Minutes 
  Alarms:
    Fn::If:
      - MyCondition
      - - Alarm1
      - - Alarm2
        - Alarm5