Attributo UpdatePolicy

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

Panoramica

Utilizzando l’attributo UpdatePolicy, puoi 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’attributo UpdatePolicy supportato da ogni tipo di risorsa.

WorkSpaces Politica di aggiornamento delle applicazioni

Per interrompere un parco WorkSpaces applicazioni prima di un aggiornamento e riavviarlo dopo un aggiornamento, utilizza la politica di aggiornamento WorkSpaces delle applicazioni.

Sintassi

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

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

Policy AutoScalingReplacingUpdate

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

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

Sintassi

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

UpdatePolicy:
  AutoScalingReplacingUpdate:
    WillReplace: Boolean

Properties

Policy AutoScalingRollingUpdate

Per eseguire un aggiornamento continuo delle istanze in un gruppo Amazon EC2 Auto Scaling anziché attendere che le attività di scaling sostituiscano gradualmente le istanze più vecchie con istanze più nuove, utilizza la policy. AutoScalingRollingUpdate Questa policy ti offre la flessibilità necessaria per specificare se CloudFormation sostituire le istanze che si trovano in un gruppo Amazon EC2 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

Properties

Policy AutoScalingScheduledAction

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

Con le azioni pianificate, le proprietà delle dimensioni del gruppo di un gruppo Amazon EC2 Auto Scaling possono cambiare in qualsiasi momento. Quando aggiorni uno stack con un gruppo Amazon EC2 Auto Scaling e un'azione pianificata CloudFormation , imposta sempre i valori delle proprietà delle dimensioni del gruppo del gruppo Amazon EC2 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

Properties

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 è impostato sutrue, puoi aggiornare le NodeGroupConfiguration proprietà NumNodeGroups e della AWS::ElastiCache::ReplicationGroup risorsa e CloudFormation aggiornerai 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

Properties

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

Esempi

Gli esempi seguenti mostrano come aggiungere una politica di aggiornamento a un gruppo Amazon EC2 Auto Scaling e come mantenere la disponibilità durante l'aggiornamento dei metadati.

Aggiungi un utente UpdatePolicy a un gruppo Amazon EC2 Auto Scaling

Il seguente esempio mostra come aggiungere una policy di aggiornamento. Durante un aggiornamento, il gruppo Amazon EC2 Auto Scaling aggiorna le istanze in batch di due e mantiene almeno un'istanza in servizio. Poiché il WaitOnResourceSignals flag è impostato, il gruppo Amazon EC2 Auto Scaling attende che nuove istanze vengano aggiunte al gruppo. Le nuove istanze devono segnalare il gruppo Amazon EC2 Auto Scaling prima che aggiorni il successivo batch di istanze.

"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

L'esempio seguente dichiara una politica che impone la sostituzione di un gruppo Amazon EC2 Auto Scaling 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 Amazon Auto EC2 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 Amazon Auto EC2 Scaling associato). CloudFormation attiva un aggiornamento continuo sul gruppo Amazon EC2 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