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

AutoScalingReplacingUpdate kebijakan

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

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

Sintaksis

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

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: Boolean

Sifat-sifat

AutoScalingRollingUpdate kebijakan

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:

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

AutoScalingInstanceRefresh kebijakan

Untuk memperbarui instans dalam grup Auto Scaling dengan melakukan penyegaran instans Auto Scaling, gunakan kebijakan tersebut. AutoScalingInstanceRefresh Untuk daftar lengkap kemampuan penyegaran instans, lihat Menggunakan penyegaran instans untuk memperbarui instans dalam grup Auto Scaling di Panduan Pengguna Amazon EC2 Auto Scaling.

CloudFormation melakukan penyegaran instans hanya ketika Anda memperbarui salah satu properti AWS::AutoScaling::AutoScalingGroup sumber daya berikut:

Saat Anda menggunakan AutoScalingInstanceRefresh kebijakan ini, pertimbangkan hal berikut:

Sintaksis

"UpdatePolicy" : {
  "AutoScalingInstanceRefresh" : {
    "Strategy" : String,
    "Preferences" : {
      "AlarmSpecification" : {
        "Alarms" : [ List of alarm names ]
      },
      "BakeTime" : Integer,
      "CheckpointDelay" : Integer,
      "CheckpointPercentages" : [ List of integers ],
      "InstanceWarmup" : Integer,
      "MaxHealthyPercentage" : Integer,
      "MinHealthyPercentage" : Integer,
      "ScaleInProtectedInstances" : String,
      "SkipMatching" : Boolean,
      "StandbyInstances" : String
    }
  }
}

UpdatePolicy:
  AutoScalingInstanceRefresh:
    Strategy: String
    Preferences:
      AlarmSpecification:
        Alarms:
          - List of alarm names
      BakeTime: Integer
      CheckpointDelay: Integer
      CheckpointPercentages:
        - List of integers
      InstanceWarmup: Integer
      MaxHealthyPercentage: Integer
      MinHealthyPercentage: Integer
      ScaleInProtectedInstances: String
      SkipMatching: Boolean
      StandbyInstances: String

Sifat-sifat

Preferensi

AlarmSpecification

Verifikasi kesiapan instans selama penyegaran instans

Secara default, penyegaran instans secara otomatis melanjutkan ke kumpulan instance berikutnya ketika instans yang baru diluncurkan melewati pemeriksaan kesehatan yang dikonfigurasi pada grup Auto Scaling Anda. Ini termasuk pemeriksaan kesehatan Amazon EC2 dan, jika dikonfigurasi, pemeriksaan kesehatan Elastic Load Balancing. Untuk informasi selengkapnya, lihat Health memeriksa instans di grup Auto Scaling di Panduan Pengguna Amazon EC2 Auto Scaling.

Jika instance Anda memerlukan bootstrap aplikasi sebelum pindah keInService, tambahkan kait autoscaling:EC2_INSTANCE_LAUNCHING siklus hidup ke grup Auto Scaling. Penyegaran instance menunggu hook siklus hidup selesai sebelum melanjutkan ke set instance berikutnya. Lengkapi hook dengan memanggil CompleteLifecycleAction API. Anda dapat membuat panggilan ini dari instance itu sendiri menggunakan skrip data pengguna template peluncuran, atau dari layanan eksternal. Untuk informasi selengkapnya, lihat kait siklus hidup Amazon EC2 Auto Scaling dan Menyelesaikan tindakan siklus hidup dalam grup Auto Scaling di Panduan Pengguna Amazon EC2 Auto Scaling.

AutoScalingScheduledAction kebijakan

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.

Sintaksis

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

UpdatePolicy:
  AutoScalingScheduledAction:
    IgnoreUnmodifiedGroupSizeProperties: Boolean

Sifat-sifat

UseOnlineResharding kebijakan

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.

Sintaksis

"UpdatePolicy" : {
  "UseOnlineResharding" : Boolean
}

UpdatePolicy:
  UseOnlineResharding: Boolean

EnableVersionUpgrade kebijakan

Untuk memutakhirkan domain OpenSearch Layanan ke versi baru OpenSearch atau Elasticsearch daripada mengganti seluruh sumber daya AWS::OpenSearchService: :Domain atau AWS::Elasticsearch: :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.

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

Menambahkan UpdatePolicyke 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'

AutoScalingInstanceRefresh kebijakan

Contoh berikut menunjukkan dua konfigurasi umum AutoScalingInstanceRefresh kebijakan. Contoh pertama menggunakan launch-before-terminate untuk mempertahankan kapasitas selama penyegaran. Contoh kedua menggunakan CloudWatch alarm untuk memutar kembali tumpukan jika penerapan menyebabkan masalah.

Launch-before-terminate menyegarkan

Contoh berikut mendeklarasikan AutoScalingInstanceRefresh kebijakan yang menggunakan launch-before-terminate. Pengaturan MinHealthyPercentage untuk 100 memastikan instance baru diluncurkan sebelum yang sudah ada dihentikan, dan MaxHealthyPercentage 200 memungkinkan grup untuk sementara dua kali lipat ukurannya. Kebijakan ini juga melewatkan instance yang sudah cocok dengan konfigurasi.

"ASG" : {
  "Type" : "AWS::AutoScaling::AutoScalingGroup",
  "Properties" : {
    "VPCZoneIdentifier" : [ "subnetIdAz1", "subnetIdAz2", "subnetIdAz3" ],
    "LaunchTemplate" : {
      "LaunchTemplateId" : { "Ref" : "logicalName" },
      "Version" : { "Fn::GetAtt" : [ "logicalName", "LatestVersionNumber" ] }
    },
    "MaxSize" : "4",
    "MinSize" : "1"
  },
  "UpdatePolicy" : {
    "AutoScalingInstanceRefresh" : {
      "Strategy" : "Rolling",
      "Preferences" : {
        "MinHealthyPercentage" : 100,
        "MaxHealthyPercentage" : 200,
        "SkipMatching" : true
      }
    }
  }
}

ASG:
  Type: AWS::AutoScaling::AutoScalingGroup
  Properties:
    VPCZoneIdentifier:
      - subnetIdAz1
      - subnetIdAz2
      - subnetIdAz3
    LaunchTemplate:
      LaunchTemplateId: !Ref logicalName
      Version: !GetAtt logicalName.LatestVersionNumber
    MaxSize: '4'
    MinSize: '1'
  UpdatePolicy:
    AutoScalingInstanceRefresh:
      Strategy: Rolling
      Preferences:
        MinHealthyPercentage: 100
        MaxHealthyPercentage: 200
        SkipMatching: true

Segarkan dengan rollback berbasis alarm

Contoh berikut mendeklarasikan AutoScalingInstanceRefresh kebijakan dengan pos pemeriksaan, rollback berbasis alarm, dan waktu pemanggangan. Auto Scaling berhenti selama 5 menit di setiap pos pemeriksaan, dan menunggu 10 menit setelah selesai sebelum menyatakan keberhasilan.

"ASG" : {
  "Type" : "AWS::AutoScaling::AutoScalingGroup",
  "Properties" : {
    "VPCZoneIdentifier" : [ "subnetIdAz1", "subnetIdAz2", "subnetIdAz3" ],
    "LaunchTemplate" : {
      "LaunchTemplateId" : { "Ref" : "logicalName" },
      "Version" : { "Fn::GetAtt" : [ "logicalName", "LatestVersionNumber" ] }
    },
    "MaxSize" : "4",
    "MinSize" : "1"
  },
  "UpdatePolicy" : {
    "AutoScalingInstanceRefresh" : {
      "Strategy" : "Rolling",
      "Preferences" : {
        "CheckpointPercentages" : [ 33, 66, 100 ],
        "CheckpointDelay" : 300,
        "BakeTime" : 600,
        "AlarmSpecification" : {
          "Alarms" : [ "my-cloud-watch-alarm" ]
        }
      }
    }
  }
}

ASG:
  Type: AWS::AutoScaling::AutoScalingGroup
  Properties:
    VPCZoneIdentifier:
      - subnetIdAz1
      - subnetIdAz2
      - subnetIdAz3
    LaunchTemplate:
      LaunchTemplateId: !Ref logicalName
      Version: !GetAtt logicalName.LatestVersionNumber
    MaxSize: '4'
    MinSize: '1'
  UpdatePolicy:
    AutoScalingInstanceRefresh:
      Strategy: Rolling
      Preferences:
        CheckpointPercentages:
          - 33
          - 66
          - 100
        CheckpointDelay: 300
        BakeTime: 600
        AlarmSpecification:
          Alarms:
            - my-cloud-watch-alarm

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 Auto 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 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