Attributo UpdatePolicy

Utilizzate l'UpdatePolicyattributo per specificare come AWS CloudFormation gestisce gli aggiornamenti di determinate risorse durante le operazioni di aggiornamento dello stack.

Panoramica

Utilizzando l'UpdatePolicyattributo, è possibile controllare il modo in cui vengono aggiornate le seguenti risorse, come descritto di seguito:

Le sezioni che seguono descrivono la sintassi e le proprietà dell'UpdatePolicyattributo supportato da ogni tipo di risorsa.

AppStream Politica di aggiornamento 2.0

Per interrompere una flotta AppStream 2.0 prima di un aggiornamento e riavviarla dopo un aggiornamento, utilizza la politica di aggiornamento AppStream 2.0.

Sintassi

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

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

Policy AutoScalingReplacingUpdate

Per sostituire il gruppo Auto Scaling e le istanze in esso contenute, utilizzate la policy. AutoScalingReplacingUpdate

Prima di tentare un aggiornamento, assicurati di disporre di una EC2 capacità Amazon sufficiente per i tuoi gruppi di Auto Scaling vecchi e nuovi.

Sintassi

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

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: Boolean

Proprietà

Policy AutoScalingRollingUpdate

Per eseguire un aggiornamento continuo delle istanze in un gruppo di Auto Scaling anziché attendere che le attività di scaling sostituiscano gradualmente le istanze più vecchie con istanze più nuove, utilizza la policy. AutoScalingRollingUpdate Questa politica offre la flessibilità di specificare se CloudFormation sostituire le istanze che si trovano in un gruppo di Auto Scaling in batch o tutte contemporaneamente senza sostituire l'intera risorsa.

Aspetti da considerare quando si utilizza una policy: AutoScalingRollingUpdate

Sintassi

"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

Proprietà

Policy AutoScalingScheduledAction

Per specificare in che modo CloudFormation gestisce gli aggiornamenti per MinSizeMaxSize, e DesiredCapacity le proprietà quando alla AWS::AutoScaling::AutoScalingGroup risorsa è associata un'azione pianificata, utilizza la AutoScalingScheduledAction politica.

Con le operazioni programmate, le proprietà delle dimensioni dei gruppi per un gruppo con dimensionamento automatico possono variare in qualsiasi momento. Quando aggiorni uno stack con un gruppo Auto Scaling e un'azione pianificata CloudFormation , imposta sempre i valori delle proprietà delle dimensioni del gruppo del gruppo Auto Scaling sui valori definiti nella risorsa AWS::AutoScaling::AutoScalingGroup del modello, anche se è in corso un'azione pianificata.

Se non desideri modificare nessuno dei valori delle proprietà relative CloudFormation alla dimensione del gruppo quando hai in corso un'azione pianificata, utilizza il criterio di AutoScalingScheduledAction aggiornamento e imposta in modo CloudFormation da IgnoreUnmodifiedGroupSizeProperties true evitare di modificare le DesiredCapacity proprietà MinSizeMaxSize, o a meno che tu non abbia modificato questi valori nel tuo modello.

Sintassi

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

UpdatePolicy:
  AutoScalingScheduledAction:
    IgnoreUnmodifiedGroupSizeProperties: Boolean

Proprietà

Policy UseOnlineResharding

Per modificare shard del gruppo di replica aggiungendo o rimuovendo shard, anziché sostituendo l'intera risorsa AWS::ElastiCache::ReplicationGroup, utilizza la policy di aggiornamento UseOnlineResharding.

Se UseOnlineResharding è impostata sutrue, è possibile aggiornare le NodeGroupConfiguration proprietà NumNodeGroups e la AWS::ElastiCache::ReplicationGroup risorsa CloudFormation aggiornerà tali proprietà senza interruzioni. Quando UseOnlineResharding è impostato false su o non è specificato, l'aggiornamento delle NodeGroupConfiguration proprietà NumNodeGroups and comporta la CloudFormation sostituzione dell'intera AWS::ElastiCache::ReplicationGroup risorsa.

La policy di aggiornamento UseOnlineResharding non ha proprietà.

Aspetti da considerare quando si imposta la policy di aggiornamento UseOnlineResharding su true:

Per ulteriori informazioni sulla modifica dei gruppi di replica, consulta ModifyReplicationGroupShardConfigurationAmazon ElastiCache API Reference.

Sintassi

"UpdatePolicy" : {
  "UseOnlineResharding" : Boolean
}

UpdatePolicy:
  UseOnlineResharding: Boolean

Policy EnableVersionUpgrade

Per aggiornare un dominio OpenSearch di servizio a una nuova versione di OpenSearch Elasticsearch anziché sostituire l'intera AWS::Elasticsearch::Domainrisorsa, utilizza la AWS::OpenSearchService::Domainpolitica di aggiornamento. EnableVersionUpgrade

Se EnableVersionUpgrade è impostato sutrue, puoi aggiornare la EngineVersion proprietà della AWS::OpenSearchService::Domain risorsa (o la ElasticsearchVersion proprietà della AWS::Elasticsearch::Domain risorsa precedente) e CloudFormation aggiornerai tale proprietà senza interruzioni. Quando EnableVersionUpgrade è impostato sufalse, o non è specificato, l'aggiornamento della ElasticsearchVersion proprietà EngineVersion o comporta la CloudFormation sostituzione dell'intera AWS::Elasticsearch::Domain risorsa AWS::OpenSearchService::Domain /.

La policy di aggiornamento EnableVersionUpgrade non ha proprietà.

Per ulteriori informazioni, consulta Upgrading OpenSearch Service domains nella Amazon OpenSearch Service Developer Guide.

Sintassi

"UpdatePolicy" : {
  "EnableVersionUpgrade" : Boolean
}

UpdatePolicy:
  EnableVersionUpgrade: Boolean

CodeDeployLambdaAliasUpdate politica

Per eseguire una CodeDeploy distribuzione quando la versione cambia su una AWS::Lambda::Alias risorsa, utilizza la politica di CodeDeployLambdaAliasUpdate aggiornamento.

Sintassi

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

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

Proprietà

Per un esempio che specifica l'attributo UpdatePolicy per una risorsa AWS::Lambda::Alias, consulta Policy di aggiornamento dell'alias Lambda.

Esempi

I seguenti esempi mostrano come aggiungere una policy di aggiornamento a un gruppo con dimensionamento automatico e come garantire la disponibilità durante l'aggiornamento dei metadati.

Aggiunta di una UpdatePolicy a un gruppo con scalabilità automatica

Il seguente esempio mostra come aggiungere una policy di aggiornamento. Durante un aggiornamento, il gruppo con dimensionamento automatico aggiorna le istanze in batch di due e mantiene in servizio almeno un'istanza. Poiché il flag WaitOnResourceSignals è impostato, il gruppo con dimensionamento automatico attende nuove istanze che vengono aggiunte al gruppo. Le nuove istanze devono inviare il segnale al gruppo con dimensionamento automatico prima che aggiorni il batch di istanze successivo.

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

Nell'esempio seguente viene dichiarata una policy che impone la sostituzione di un gruppo con dimensionamento automatico associato durante un aggiornamento. Perché l'aggiornamento riesca, una percentuale di istanze (specificata dal parametro MinSuccessfulPercentParameter ) deve segnalare l'esito positivo entro il periodo 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'

Disponibilità durante l'aggiornamento dei metadati per lo script helper cfn-init

Quando installi applicazioni software sulle tue istanze, puoi utilizzare la chiave AWS::CloudFormation::Init dei metadati e lo script di cfn-init supporto per avviare le istanze nel tuo gruppo Auto Scaling. CloudFormation installa i pacchetti, esegue i comandi ed esegue altre azioni di bootstrap descritte nei metadati.

Quando si aggiornano solo i metadati (ad esempio, quando si aggiorna un pacchetto a un'altra versione), è possibile utilizzare il daemon assistente cfn-hup per rilevare e applicare gli aggiornamenti. Tuttavia, il daemon cfn-hup viene eseguito in modo indipendente su ciascuna istanza. Se il daemon viene eseguito contemporaneamente su tutte le istanze, l'applicazione o il servizio potrebbe non essere disponibile durante l'aggiornamento. Per garantire la disponibilità, puoi forzare un aggiornamento periodico in modo che CloudFormation aggiorni le istanze un batch alla volta.

Per forzare un aggiornamento continuo, modifica l'ID logico della risorsa di configurazione di avvio, quindi aggiorna lo stack e tutti i riferimenti che puntano all'ID logico originale (come il gruppo Auto Scaling associato). CloudFormation attiva un aggiornamento continuo nel gruppo Auto Scaling, sostituendo tutte le istanze.

Modello originale

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

ID logico aggiornato

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

Policy di aggiornamento dell'alias Lambda

Nell'esempio seguente viene specificato l'attributo UpdatePolicy per una risorsa AWS::Lambda::Alias. Tutti i dettagli per la distribuzione sono definiti dall'applicazione e dal gruppo di distribuzione trasferiti nella policy.

"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