UpdatePolicy 屬性

使用UpdatePolicy屬性來指定如何 AWS CloudFormation 在堆疊更新作業期間處理特定資源的更新。

概觀

透過使用UpdatePolicy屬性，您可以控制下列資源的更新方式，如下所述：

以下各節說明每個資源類型支援之UpdatePolicy屬性的語法和特性。

AppStream 2.0 更新政策

若要在更新之前停止 AppStream 2.0 叢集並在更新後重新啟動，請使用 AppStream 2.0 更新原則。

語法

{
    "UpdatePolicy": {
        "StopBeforeUpdate": {
            "Type": "Boolean"
        },
        "StartAfterUpdate": {
            "Type": "Boolean"
        }
    }
}

UpdatePolicy:
  StopBeforeUpdate:
    Type: Boolean
  StartAfterUpdate:
    Type: Boolean

AutoScalingReplacingUpdate政策

若要取代 Auto Scaling 群組及其包含的執行個體，請使用AutoScalingReplacingUpdate原則。

在嘗試更新之前，請確保您有足夠的 Amazon EC2 容量供舊的和新的 Auto Scaling 群組使用。

語法

"UpdatePolicy" : {
  "AutoScalingReplacingUpdate" : {
    "WillReplace" : Boolean
  }
}

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: Boolean

屬性

AutoScalingRollingUpdate政策

若要對 Auto Scaling 群組中的執行個體執行滾動式更新，而不是等待擴展活動逐漸以較新的執行個體取代較舊的執行個體，請使用AutoScalingRollingUpdate政策。此原則可讓您彈性指定是批次 CloudFormation 取代 Auto Scaling 群組中的執行個體，還是一次取代全部執行個體，而不取代整個資源。

使用AutoScalingRollingUpdate政策時要考慮的事項：

語法

"UpdatePolicy" : {
  "AutoScalingRollingUpdate" : {
    "MaxBatchSize" : Integer,
    "MinActiveInstancesPercent" : Integer,
    "MinInstancesInService" : Integer,
    "MinSuccessfulInstancesPercent" : Integer,
    "PauseTime" : String,
    "SuspendProcesses" : [ List of processes ],
    "WaitOnResourceSignals" : Boolean
  }
}

UpdatePolicy:
  AutoScalingRollingUpdate:
    MaxBatchSize: Integer
    MinActiveInstancesPercent: Integer
    MinInstancesInService: Integer
    MinSuccessfulInstancesPercent: Integer
    PauseTime: String
    SuspendProcesses:
      - List of processes
    WaitOnResourceSignals: Boolean

屬性

AutoScalingScheduledAction政策

若要指定當AWS::AutoScaling::AutoScalingGroup資源具有關聯的排程動作時 MinSizeMaxSize，如何 CloudFormation 處理、和DesiredCapacity內容的更新，請使用AutoScalingScheduledAction策略。

透過排程動作，可隨時改變 Auto Scaling 群組的群組大小屬性。當您使用 Auto Scaling 群組和排程動作更新堆疊時，一 CloudFormation 律會將 Auto Scaling 群組的群組大小屬性值設定為範本AWS::AutoScaling::AutoScalingGroup資源中定義的值，即使排程動作生效也一樣。

如果您不 CloudFormation 想在排程動作生效時變更任何群組大小內容值，請使用AutoScalingScheduledAction更新原則並IgnoreUnmodifiedGroupSizeProperties將設定為true以防 CloudFormation 止變更MinSize、或DesiredCapacity屬性MaxSize，除非您已在範本中修改這些值。

語法

"UpdatePolicy" : {
  "AutoScalingScheduledAction" : {
    "IgnoreUnmodifiedGroupSizeProperties" : Boolean
  }
}

UpdatePolicy:
  AutoScalingScheduledAction:
    IgnoreUnmodifiedGroupSizeProperties: Boolean

屬性

UseOnlineResharding政策

若要透過新增或移除碎片來修改複寫群組的碎片，而不是取代整個AWS::ElastiCache: ReplicationGroup 資源，請使用UseOnlineResharding更新原則。

如果設定UseOnlineResharding為true，您可以更新AWS::ElastiCache::ReplicationGroup資源的NumNodeGroups和NodeGroupConfiguration屬性，並且不 CloudFormation 會中斷地更新這些屬性。當UseOnlineResharding設定為false或未指定時，更新NumNodeGroups和NodeGroupConfiguration屬性會 CloudFormation 取代整個AWS::ElastiCache::ReplicationGroup資源。

UseOnlineResharding 更新政策沒有屬性。

將 UseOnlineResharding 更新政策設定為 true 時的一些考量事項：

如需修改複寫群組的詳細資訊，請參閱 Amazon ElastiCache API 參考ModifyReplicationGroupShardConfiguration中的。

語法

"UpdatePolicy" : {
  "UseOnlineResharding" : Boolean
}

UpdatePolicy:
  UseOnlineResharding: Boolean

EnableVersionUpgrade政策

若要將 OpenSearch 服務網域升級為新版本的 OpenSearch 或 Elasticsearch，而不是取代整個::: 網域或AWS:OpenSearchService: 彈性搜尋:AWS: 網域資源，請使用更新原則。EnableVersionUpgrade

如果設定EnableVersionUpgrade為true，您可以更新AWS::OpenSearchService::Domain資源的EngineVersion屬性 (或舊資AWS::Elasticsearch::Domain源的ElasticsearchVersion屬性)，並且不 CloudFormation 會中斷地更新該內容。當EnableVersionUpgrade設定為false或未指定時，更新EngineVersion或內ElasticsearchVersion容會導致 CloudFormation 取代整個AWS::OpenSearchService::Domain/AWS::Elasticsearch::Domain資源。

EnableVersionUpgrade 更新政策沒有屬性。

如需升級 OpenSearch 服務網域的詳細資訊，請參閱 Amazon OpenSearch 服務開發人員指南UpgradeDomain中的。

語法

"UpdatePolicy" : {
  "EnableVersionUpgrade" : Boolean
}

UpdatePolicy:
  EnableVersionUpgrade: Boolean

CodeDeployLambdaAliasUpdate 政策

若要在AWS::Lambda::Alias資源上的版本變更時執行 CodeDeploy 部署，請使用CodeDeployLambdaAliasUpdate更新原則。

語法

"UpdatePolicy" : {
  "CodeDeployLambdaAliasUpdate" : {
    "AfterAllowTrafficHook" : String,
    "ApplicationName" : String,
    "BeforeAllowTrafficHook" : String,
    "DeploymentGroupName" : String
  }
}

UpdatePolicy:
  CodeDeployLambdaAliasUpdate:
    AfterAllowTrafficHook: String
    ApplicationName: String
    BeforeAllowTrafficHook: String
    DeploymentGroupName: String

屬性

如需為 AWS::Lambda::Alias 資源指定 UpdatePolicy 屬性的範例，請參閱 Lambda 別名更新政策。

範例

以下範例說明如何將更新政策新增至 Auto Scaling 群組，以及如何在更新中繼資料時保持可用性。

將 UpdatePolicy 新增至 Auto Scaling 群組

以下範例說明如何新增更新政策。在更新期間，Auto Scaling 群組將以兩個為一批更新執行個體，並至少保持一個服務中的執行個體。由於已設定 WaitOnResourceSignals 旗標，Auto Scaling 群組將等待在群組中新增的新執行個體。新執行個體必須發出訊號至 Auto Scaling 群組，才能更新下一個批次的執行個體。

"ASG" : {
  "Type":"AWS::AutoScaling::AutoScalingGroup",
  "Properties":{
    "VPCZoneIdentifier":[ "subnetIdAz1", "subnetIdAz2", "subnetIdAz3" ],
    "LaunchTemplate":{
      "LaunchTemplateId":{
        "Ref":"logicalName"
      },
      "Version":{
        "Fn::GetAtt":[
          "logicalName",
          "LatestVersionNumber"
        ]
      }
    },
    "MaxSize":"4",
    "MinSize":"1"
  },
  "UpdatePolicy":{
    "AutoScalingScheduledAction":{
      "IgnoreUnmodifiedGroupSizeProperties":"true"
    },
    "AutoScalingRollingUpdate":{
      "MinInstancesInService":"1",
      "MaxBatchSize":"2",
      "WaitOnResourceSignals":"true",
      "PauseTime":"PT10M",
      "SuspendProcesses":[
        "HealthCheck",
        "ReplaceUnhealthy",
        "AZRebalance",
        "AlarmNotification",
        "ScheduledActions",
        "InstanceRefresh"
      ]
    }
  }
}

ASG:
  Type: 'AWS::AutoScaling::AutoScalingGroup'
  Properties:
    VPCZoneIdentifier:
      - subnetIdAz1
      - subnetIdAz2
      - subnetIdAz3
    LaunchTemplate:
      LaunchTemplateId: !Ref logicalName
      Version: !GetAtt logicalName.LatestVersionNumber
    MaxSize: '4'
    MinSize: '1'
  UpdatePolicy:
    AutoScalingScheduledAction:
      IgnoreUnmodifiedGroupSizeProperties: 'true'
    AutoScalingRollingUpdate:
      MinInstancesInService: '1'
      MaxBatchSize: '2'
      WaitOnResourceSignals: 'true'
      PauseTime: PT10M
      SuspendProcesses:
        - HealthCheck
        - ReplaceUnhealthy
        - AZRebalance
        - AlarmNotification
        - ScheduledActions
        - InstanceRefresh

AutoScalingReplacingUpdate 政策

以下範例宣告一項政策，強制在更新期間替換關聯的 Auto Scaling 群組。為了成功更新，必須在 MinSuccessfulPercentParameter 期間發出成功訊號的執行個體百分比 (以 Timeout 參數指定)。

"UpdatePolicy" : {
  "AutoScalingReplacingUpdate" : {
    "WillReplace" : true
  }
},
"CreationPolicy" : {
  "ResourceSignal" : {
    "Count" : { "Ref" : "ResourceSignalsOnCreate"},
    "Timeout" : "PT10M"
  },
  "AutoScalingCreationPolicy" : {
    "MinSuccessfulInstancesPercent" : { "Ref" : "MinSuccessfulPercentParameter" }
  }
}

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: true
CreationPolicy:
  ResourceSignal:
    Count: !Ref 'ResourceSignalsOnCreate'
    Timeout: PT10M
  AutoScalingCreationPolicy:
    MinSuccessfulInstancesPercent: !Ref 'MinSuccessfulPercentParameter'

在更新 cfn-init 協助程式指令碼的中繼資料時維持可用性

在執行個體上安裝軟體應用程式時，您可以使用中AWS::CloudFormation::Init繼資料金鑰和cfn-init輔助程式指令碼來啟動 Auto Scaling 群組中的執行個體。 CloudFormation 安裝套件、執行命令，以及執行中繼資料中描述的其他啟動載入動作。

當您僅更新中繼資料時 (例如，將套件更新為另一個版本時)，可使用 cfn-hup 協助程式以偵測和套用更新。但是，cfn-hup 協助程式獨立執行於每個執行個體。如果協助程式剛好在所有執行個體上同時執行，您的應用程式或服務在更新期間可能會無法使用。為了保證可用性，您可以強制進行滾動更新，以便一次 CloudFormation 更新一個批次的執行個體。

若要強制滾動更新，請變更啟動組態資源的邏輯 ID，然後更新堆疊以及指向原始邏輯 ID 的任何參照 (例如相關聯的 Auto Scaling 群組)。 CloudFormation 觸發 Auto Scaling 群組的滾動式更新，取代所有執行個體。

原始範本

"LaunchConfig": {
  "Type" : "AWS::AutoScaling::LaunchConfiguration",
  "Metadata" : {
    "Comment" : "Install a simple PHP application",
    "AWS::CloudFormation::Init" : {
    ...
    }
  }
}

更新的邏輯 ID

"LaunchConfigUpdateRubygemsPkg": {
  "Type" : "AWS::AutoScaling::LaunchConfiguration",
  "Metadata" : {
    "Comment" : "Install a simple PHP application",
    "AWS::CloudFormation::Init" : {
    ...
    }
  }
}

Lambda 別名更新政策

以下範例指定 UpdatePolicy 資源的 AWS::Lambda::Alias 屬性。部署的所有詳細資訊皆由傳遞至政策的應用程式和部署群組所定義。

"Alias": {
  "Type": "AWS::Lambda::Alias",
  "Properties": {
    "FunctionName": {
      "Ref": "LambdaFunction"
    },
    "FunctionVersion": {
      "Fn::GetAtt": [
        "FunctionVersionTwo",
        "Version"
      ]
    },
    "Name": "MyAlias"
  },
  "UpdatePolicy": {
    "CodeDeployLambdaAliasUpdate": {
      "ApplicationName": {
        "Ref": "CodeDeployApplication"
      },
      "DeploymentGroupName": {
        "Ref": "CodeDeployDeploymentGroup"
      },
      "BeforeAllowTrafficHook": {
        "Ref": "PreHookLambdaFunction"
      },
      "AfterAllowTrafficHook": {
        "Ref": "PreHookLambdaFunction"
      }
    }
  }
}

Alias:
  Type: 'AWS::Lambda::Alias'
  Properties:
    FunctionName: !Ref LambdaFunction
    FunctionVersion: !GetAtt FunctionVersionTwo.Version
    Name: MyAlias
  UpdatePolicy:
    CodeDeployLambdaAliasUpdate:
      ApplicationName: !Ref CodeDeployApplication
      DeploymentGroupName: !Ref CodeDeployDeploymentGroup
      BeforeAllowTrafficHook: !Ref PreHookLambdaFunction
      AfterAllowTrafficHook: !Ref PreHookLambdaFunction