DeploymentPreference - AWS Serverless Application Model
명령문속성예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DeploymentPreference

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

참고

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로 설정해야 합니다. 그렇지 않으면 함수의 조건이 False로 확인되더라도 CodeDeploy 리소스가 생성됩니다.

유형: 부울

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

Role

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

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

TriggerConfigurations

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

유형: 목록

필수 항목 여부: 아니요

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

Type

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

유형: 문자열

필수 항목 여부: 예

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

Fn: :If 내장 함수를 사용한 DeploymentPreference

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

YAML

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