UpdatePolicyatribut

Gunakan UpdatePolicy atribut untuk menentukan cara 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.

WorkSpaces Kebijakan pembaruan aplikasi

Untuk menghentikan armada WorkSpaces Aplikasi sebelum pembaruan dan memulai ulang setelah pembaruan, gunakan kebijakan pembaruan WorkSpaces Aplikasi.

Sintaksis

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

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

AutoScalingReplacingUpdatekebijakan

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

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

Sintaksis

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

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: Boolean

Sifat-sifat

AutoScalingRollingUpdatekebijakan

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

Hal-hal yang perlu dipertimbangkan saat menggunakan AutoScalingRollingUpdate kebijakan:

Sintaksis

"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

Sifat-sifat

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 grup EC2 Auto Scaling Amazon dapat berubah kapan saja. Saat Anda memperbarui tumpukan dengan grup EC2 Auto Scaling Amazon dan tindakan terjadwal, CloudFormation selalu tetapkan nilai properti ukuran grup grup Amazon EC2 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 atur IgnoreUnmodifiedGroupSizeProperties true untuk CloudFormation mencegah perubahanMinSize,MaxSize, atau DesiredCapacity properti kecuali Anda telah mengubah nilai ini di templat Anda.

Sintaksis

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

UpdatePolicy:
  AutoScalingScheduledAction:
    IgnoreUnmodifiedGroupSizeProperties: Boolean

Sifat-sifat

UseOnlineReshardingkebijakan

Untuk memodifikasi serpihan grup replikasi dengan menambahkan atau menghapus serpihan, daripada mengganti seluruh sumber daya AWS::ElastiCache::ReplicationGroup, 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.

Sintaksis

"UpdatePolicy" : {
  "UseOnlineResharding" : Boolean
}

UpdatePolicy:
  UseOnlineResharding: Boolean

EnableVersionUpgradekebijakan

Untuk memutakhirkan domain OpenSearch Layanan ke versi baru OpenSearch atau Elasticsearch daripada mengganti keseluruhan AWS::OpenSearchService::Domainatau AWS::Elasticsearch::Domainsumber daya, gunakan kebijakan EnableVersionUpgrade pembaruan.

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.

Sintaksis

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

Sintaksis

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

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

Sifat-sifat

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 EC2 Auto Scaling Amazon dan cara menjaga ketersediaan saat memperbarui metadata.

Menambahkan UpdatePolicy ke grup EC2 Auto Scaling Amazon

Contoh berikut menunjukkan cara menambahkan kebijakan pembaruan. Selama pembaruan, grup EC2 Auto Scaling Amazon memperbarui instance dalam batch dua dan menyimpan minimal satu instance dalam layanan. Karena WaitOnResourceSignals bendera disetel, grup EC2 Auto Scaling Amazon menunggu instance baru yang ditambahkan ke grup. Instans baru harus memberi sinyal pada grup EC2 Auto Scaling Amazon 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 EC2 Auto Scaling Amazon 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

Saat Anda menginstal aplikasi perangkat lunak pada instance Anda, Anda dapat menggunakan kunci AWS::CloudFormation::Init metadata dan skrip cfn-init helper untuk mem-bootstrap instance di grup Amazon Auto EC2 Scaling Anda. CloudFormation menginstal paket, menjalankan perintah, dan melakukan tindakan bootstrap lainnya yang dijelaskan dalam metadata.

Ketika Anda hanya memperbarui metadata (misalnya, ketika memperbarui paket ke versi lain), Anda dapat menggunakan cfn-hup daemon 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 Amazon EC2 Auto Scaling terkait). CloudFormation memicu pembaruan bergulir pada grup Amazon EC2 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