UpdatePolicyatribut

Gunakan UpdatePolicy atribut untuk menentukan cara AWS CloudFormation menangani pembaruan ke sumber daya tertentu selama operasi pembaruan tumpukan.

Gambaran Umum

Dengan menggunakan UpdatePolicy atribut, Anda dapat mengontrol bagaimana sumber daya berikut diperbarui, seperti yang dijelaskan di sini:

Bagian berikut menjelaskan sintaks dan properti untuk UpdatePolicy atribut yang didukung oleh setiap jenis sumber daya.

AppStream Kebijakan pembaruan 2.0

Untuk menghentikan armada AppStream 2.0 sebelum pembaruan dan memulai ulang setelah pembaruan, gunakan kebijakan pembaruan AppStream 2.0.

Sintaks

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

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

AutoScalingReplacingUpdatekebijakan

Untuk mengganti grup Auto Scaling dan instance yang dikandungnya, gunakan kebijakan. AutoScalingReplacingUpdate

Sebelum mencoba pembaruan, pastikan Anda memiliki EC2 kapasitas Amazon yang cukup untuk grup Auto Scaling lama dan baru.

Sintaks

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

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: Boolean

Properti

AutoScalingRollingUpdatekebijakan

Untuk melakukan pembaruan bergulir instans dalam grup Auto Scaling daripada menunggu aktivitas penskalaan untuk secara bertahap mengganti instance lama dengan instance yang lebih baru, gunakan kebijakan tersebut. AutoScalingRollingUpdate Kebijakan ini memberi Anda fleksibilitas untuk menentukan apakah CloudFormation menggantikan instance yang ada di grup Auto Scaling dalam batch atau sekaligus tanpa mengganti seluruh sumber daya.

Hal-hal yang perlu dipertimbangkan saat menggunakan AutoScalingRollingUpdate kebijakan:

Sintaks

"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

Properti

AutoScalingScheduledActionkebijakan

Untuk menentukan cara CloudFormation menangani pembaruan untukMinSize,MaxSize, dan DesiredCapacity properti saat AWS::AutoScaling::AutoScalingGroup sumber daya memiliki tindakan terjadwal terkait, gunakan AutoScalingScheduledAction kebijakan tersebut.

Dengan tindakan terjadwal, properti ukuran grup Auto Scaling dapat berubah kapan saja. Saat Anda memperbarui tumpukan dengan grup Auto Scaling dan tindakan terjadwal, CloudFormation selalu tetapkan nilai properti ukuran grup grup Auto Scaling Anda ke nilai yang ditentukan dalam AWS::AutoScaling::AutoScalingGroup sumber daya templat Anda, meskipun tindakan terjadwal berlaku.

Jika Anda tidak CloudFormation ingin mengubah salah satu nilai properti ukuran grup ketika Anda memiliki tindakan terjadwal yang berlaku, gunakan kebijakan AutoScalingScheduledAction pembaruan dan setel IgnoreUnmodifiedGroupSizeProperties true untuk CloudFormation mencegah perubahanMinSize,MaxSize, atau DesiredCapacity properti kecuali Anda telah mengubah nilai ini di templat Anda.

Sintaks

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

UpdatePolicy:
  AutoScalingScheduledAction:
    IgnoreUnmodifiedGroupSizeProperties: Boolean

Properti

UseOnlineReshardingkebijakan

Untuk memodifikasi pecahan grup replikasi dengan menambahkan atau menghapus pecahan, alih-alih mengganti seluruh ReplicationGroup sumber daya AWS:::ElastiCache:, gunakan kebijakan pembaruan. UseOnlineResharding

Jika UseOnlineResharding diatur ketrue, Anda dapat memperbarui NumNodeGroups dan NodeGroupConfiguration properti AWS::ElastiCache::ReplicationGroup sumber daya, dan CloudFormation akan memperbarui properti tersebut tanpa gangguan. Ketika UseOnlineResharding diatur kefalse, atau tidak ditentukan, memperbarui NumNodeGroups dan NodeGroupConfiguration properti menghasilkan CloudFormation penggantian seluruh AWS::ElastiCache::ReplicationGroup sumber daya.

Kebijakan UseOnlineResharding pembaruan tidak memiliki properti.

Hal-hal yang perlu dipertimbangkan saat mengatur UseOnlineResharding kebijakan pembaruan ke true:

Untuk informasi selengkapnya tentang memodifikasi grup replikasi, lihat ModifyReplicationGroupShardConfigurationdi Referensi Amazon ElastiCache API.

Sintaks

"UpdatePolicy" : {
  "UseOnlineResharding" : Boolean
}

UpdatePolicy:
  UseOnlineResharding: Boolean

EnableVersionUpgradekebijakan

Untuk memutakhirkan domain OpenSearch Layanan ke versi baru OpenSearch atau Elasticsearch daripada mengganti seluruh sumber daya AWS::: :Domain atauOpenSearchService: :ElasticsearchAWS: :Domain, gunakan kebijakan pembaruan. EnableVersionUpgrade

Jika EnableVersionUpgrade disetel ketrue, Anda dapat memperbarui EngineVersion properti AWS::OpenSearchService::Domain sumber daya (atau ElasticsearchVersion properti sumber AWS::Elasticsearch::Domain daya lama), dan CloudFormation akan memperbarui properti itu tanpa gangguan. Kapan EnableVersionUpgrade diatur kefalse, atau tidak ditentukan, memperbarui EngineVersion atau ElasticsearchVersion properti menghasilkan CloudFormation penggantian seluruh AWS::Elasticsearch::Domain sumber dayaAWS::OpenSearchService::Domain/.

Kebijakan EnableVersionUpgrade pembaruan tidak memiliki properti.

Untuk informasi selengkapnya, lihat Memutakhirkan domain OpenSearch Layanan di Panduan Pengembang OpenSearch Layanan Amazon.

Sintaks

"UpdatePolicy" : {
  "EnableVersionUpgrade" : Boolean
}

UpdatePolicy:
  EnableVersionUpgrade: Boolean

CodeDeployLambdaAliasUpdate kebijakan

Untuk melakukan CodeDeploy penerapan saat versi berubah pada AWS::Lambda::Alias sumber daya, gunakan kebijakan CodeDeployLambdaAliasUpdate pembaruan.

Sintaks

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

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

Properti

Untuk contoh yang menentukan UpdatePolicy atribut untuk AWS::Lambda::Alias sumber daya, lihat Kebijakan pembaruan alias Lambda.

Contoh

Contoh berikut menunjukkan cara menambahkan kebijakan pembaruan ke grup Auto Scaling dan cara mempertahankan ketersediaan saat memperbarui metadata.

Menambahkan UpdatePolicy ke grup Auto Scaling

Contoh berikut menunjukkan cara menambahkan kebijakan pembaruan. Selama pembaruan, grup Auto Scaling memperbarui instance dalam batch dua dan menyimpan minimal satu instance dalam layanan. Karena WaitOnResourceSignals bendera disetel, grup Auto Scaling menunggu instance baru yang ditambahkan ke grup. Instans baru harus memberi sinyal pada grup Auto Scaling sebelum memperbarui batch instance berikutnya.

"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 kebijakan

Contoh berikut mendeklarasikan kebijakan yang memaksa grup Auto Scaling terkait diganti selama pembaruan. Agar pembaruan berhasil, persentase instans (ditentukan oleh MinSuccessfulPercentParameter parameter) harus menandakan keberhasilan dalam Timeout periode.

"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'

Pertahankan ketersediaan saat memperbarui metadata untuk skrip pembantu cfn-init

Ketika Anda menginstal aplikasi perangkat lunak pada instans Anda, Anda dapat menggunakan AWS::CloudFormation::Initkunci metadata dan cfn-initskrip pembantu untuk mem-bootstrap instance di grup Auto Scaling Anda. CloudFormation menginstal paket, menjalankan perintah, dan melakukan tindakan bootstrap lainnya yang dijelaskan dalam metadata.

Ketika Anda hanya memperbarui metadata (misalnya, saat memperbarui paket ke versi lain), Anda dapat menggunakan cfn-hupdaemon pembantu untuk mendeteksi dan menerapkan pembaruan. Namun, cfn-hup daemon berjalan secara independen pada setiap instans. Jika daemon ada untuk berjalan pada waktu yang sama pada semua instans, aplikasi atau layanan Anda mungkin tidak tersedia selama pembaruan. Untuk menjamin ketersediaan, Anda dapat memaksa CloudFormation pembaruan bergulir sehingga memperbarui instans Anda satu batch pada satu waktu.

Untuk memaksa pembaruan bergulir, ubah ID logis sumber daya konfigurasi peluncuran, lalu perbarui tumpukan dan referensi apa pun yang menunjuk ke ID logika asli (seperti grup Auto Scaling terkait). CloudFormation memicu pembaruan bergulir pada grup Auto Scaling, menggantikan semua instance.

Templat asli

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

ID logis yang diperbarui

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

Kebijakan pembaruan alias Lambda

Contoh berikut menentukan UpdatePolicy atribut untuk AWS::Lambda::Alias sumber daya. Semua detail deployment didefinisikan oleh aplikasi dan grup deployment yang diteruskan ke kebijakan.

"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