CreationPolicy 屬性

將 CreationPolicy 屬性與 資源建立關聯，以防止其狀態達到建立完成，直到 AWS CloudFormation 收到指定數量的成功訊號或超過逾時期間為止。若要傳送訊號至資源，您可以使用 cfn-signal 協助程式指令碼或 SignalResource API。CloudFormation 會發佈有效的訊號至堆疊事件，讓您可以追蹤傳送的訊號數目。

建立政策只有在 CloudFormation 建立關聯資源時才會呼叫。目前，支援建立政策的 CloudFormation 資源只有：

當您希望在繼續建立堆疊前等待資源組態動作時，請使用 CreationPolicy 屬性。例如，若您在 EC2 執行個體上安裝和設定軟體應用程式，您可能會希望在繼續前執行那些應用程式。在這種案例下，您可以新增 CreationPolicy 屬性至執行個體，然後在安裝和設定應用程式之後傳送成功訊號至執行個體。如需詳細的 Amazon EC2 範例，請參閱 在 Amazon EC2 上部署應用程式。

AppStream 2.0 建立政策

建立政策的 Amazon AppStream 組態。

語法

{
    "CreationPolicy": {
        "StartFleet": {
            "Type": "Boolean"
        }
    }
}

CreationPolicy:
  StartFleet:
    Type: Boolean

Amazon EC2 Auto Scaling 建立屬性

建立政策的 Amazon EC2 Auto Scaling 組態。

語法

"CreationPolicy" : {
  "AutoScalingCreationPolicy" : {
    "MinSuccessfulInstancesPercent" : Integer
  },
  "ResourceSignal" : {    
    "Count" : Integer,
    "Timeout" : String
  }
}

CreationPolicy:
  AutoScalingCreationPolicy:
    MinSuccessfulInstancesPercent: Integer
  ResourceSignal:    
    Count: Integer
    Timeout: String

Amazon EC2 Auto Scaling 建立屬性

建立政策的 Amazon EC2 Auto Scaling 組態。

範例

Auto Scaling 群組

以下範例說明如何將建立政策新增至 Amazon EC2 Auto Scaling 群組。建立政策需要三個成功訊號，並會在 15 分鐘之後逾時。使用 cfn-signal 協助程式指令碼，在執行個體建立程序成功完成時發出訊號。

若要讓執行個體在 Elastic Load Balancing 運作狀態檢查傳送成功訊號前等待，請使用 cfn-init 協助程式指令碼新增運作狀態檢查驗證。如需範例，請參閱 GitHub 儲存庫中 Amazon EC2 Auto Scaling 滾動更新的範本中的 verify_instance_health命令。

"AutoScalingGroup": {
  "Type": "AWS::AutoScaling::AutoScalingGroup",
  "Properties": {
    "VPCZoneIdentifier":[ "subnetIdAz1", "subnetIdAz2", "subnetIdAz3" ],
    "LaunchTemplate":{
      "LaunchTemplateId":{
        "Ref":"logicalName"
      },
      "Version":{
        "Fn::GetAtt":[
          "logicalName",
          "LatestVersionNumber"
        ]
      }
    },
    "MinSize": "1",
    "MaxSize": "4"
  },
  "CreationPolicy": {
    "ResourceSignal": {
      "Count": "3",
      "Timeout": "PT15M"
    }
  }
}

AutoScalingGroup:
  Type: AWS::AutoScaling::AutoScalingGroup
  Properties:
    VPCZoneIdentifier:
      - subnetIdAz1
      - subnetIdAz2
      - subnetIdAz3
    LaunchTemplate:
      LaunchTemplateId: !Ref logicalName
      Version: !GetAtt logicalName.LatestVersionNumber
    MinSize: '1'
    MaxSize: '4'
  CreationPolicy:
    ResourceSignal:
      Count: '3'
      Timeout: PT15M

WaitCondition

下列範例示範如何將建立政策新增至 Amazon EC2 以外 CloudFormation 資源的等待條件。

若要發出WaitCondition資源訊號，請使用 SignalResource API。此 API 旨在使用您使用 設定WaitCondition的資源CreationPolicy。

"WaitCondition" : {
    "Type" : "AWS::CloudFormation::WaitCondition",
    "CreationPolicy" : {
        "ResourceSignal" : {
            "Timeout" : "PT15M",
            "Count" : "5"
        }
    }
}

WaitCondition:
  Type: AWS::CloudFormation::WaitCondition
  CreationPolicy:
    ResourceSignal:
      Timeout: PT15M
      Count: 5