Attributo UpdateReplacePolicy

Utilizzare l'attributo UpdateReplacePolicy per conservare o (in alcuni casi) eseguire il backup dell'istanza fisica esistente di una risorsa quando viene sostituita durante un'operazione di aggiornamento dello stack.

Quando si inizia un aggiornamento dello stack, AWS CloudFormation aggiorna le risorse in base alle differenze tra ciò che invii e il modello e i parametri correnti dello stack. Se si aggiorna una proprietà della risorsa che richiede che la risorsa debba essere sostituita, CloudFormation ricrea la risorsa durante l'aggiornamento. La ricreazione della risorsa genera un nuovo ID fisico. CloudFormation crea per prima cosa la risorsa sostitutiva, quindi modifica i riferimenti da altre risorse dipendenti in modo che puntino alla risorsa sostitutiva. Per impostazione predefinita, CloudFormation elimina infine la risorsa precedente. Usando UpdateReplacePolicy, è possibile specificare che CloudFormation mantenga o (in alcuni casi), crei uno snapshot della risorsa precedente.

Per le risorse che supportano gli snapshot, come ad esempio AWS::EC2::Volume, specificare Snapshot in modo che CloudFormation crei uno snapshot prima di eliminare l'istanza della risorsa precedente.

È possibile applicare l'attributo UpdateReplacePolicy a qualsiasi risorsa. UpdateReplacePolicy viene eseguito solo se aggiorni una proprietà della risorsa con un comportamento di tipo Replacement (Sostituzione), causando così la sostituzione della risorsa precedente con una nuova risorsa con un nuovo ID fisico da parte di CloudFormation. Ad esempio, se si aggiorna la proprietà Engine di un tipo di risorsa AWS::RDS::DBInstance, CloudFormation crea una nuova risorsa e sostituisce la risorsa dell'istanza database corrente con la nuova. L'attributo UpdateReplacePolicy specifica quindi se CloudFormation debba eliminare, conservare o creare uno snapshot dell'istanza database precedente. Il comportamento di aggiornamento per ogni proprietà di una risorsa è specificato nell'argomento di riferimento in AWS riferimento ai tipi di risorse e proprietà. Per ulteriori informazioni sul comportamento di aggiornamento delle risorse, consulta Aggiornamento dei comportamenti delle risorse stack.

L'attributo UpdateReplacePolicy si applica agli aggiornamenti dello stack eseguiti direttamente, oltre agli aggiornamenti dello stack eseguiti utilizzando set di modifiche.

Nota

Le risorse conservate continuano a esistere, quindi i relativi costi vengono ancora addebitati finché non le si elimina. Gli snapshot creati con questa policy continuano ad esistere e continuano a sostenere addebiti applicabili fino a quando tali snapshot non vengono eliminati. UpdateReplacePolicy conserva la vecchia risorsa fisica o istantanea, ma la rimuove dall'ambito di CloudFormation.

UpdateReplacePolicy differisce dall'attributo DeletionPolicy perché si applica solo alle risorse sostituite durante gli aggiornamenti dello stack. Utilizza DeletionPolicy per le risorse eliminate durante l'eliminazione di uno stack o quando la definizione stessa della risorsa viene eliminata dal modello nell'ambito di un aggiornamento dello stack.

Il frammento seguente contiene una risorsa dell'istanza database Amazon RDS con una policy Retain per la sostituzione. Quando questa risorsa viene sostituita con una nuova risorsa con un nuovo ID fisico, CloudFormation lascia l'istanza database precedente senza eliminarla.

JSON

{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Resources" : {
    "myDB" : {
      "Type" : "AWS::RDS::DBInstance",
      "DeletionPolicy" : "Retain",
      "UpdateReplacePolicy" : "Retain",
      "Properties" : {}
    }
  }
}

YAML

AWSTemplateFormatVersion: 2010-09-09
Resources:
  myDB:
    Type: 'AWS::RDS::DBInstance'
    DeletionPolicy: Retain
    UpdateReplacePolicy: Retain
    Properties: {} 

Opzioni UpdateReplacePolicy

Delete

CloudFormation elimina la risorsa e tutto il suo contenuto ove applicabile durante la sostituzione della risorsa. Puoi aggiungere questa policy a qualsiasi tipo di risorsa. Per impostazione predefinita, se non si specifica una UpdateReplacePolicy, CloudFormation elimina le risorse. Tuttavia, tieni presente le considerazioni seguenti:

Per i bucket Amazon S3 è necessario eliminare tutti gli oggetti nel bucket affinché l'eliminazione riesca.

Mantenimento

CloudFormation mantiene la risorsa senza eliminare la risorsa o il relativo contenuto quando la risorsa viene sostituita. Puoi aggiungere questa policy a qualsiasi tipo di risorsa. Le risorse conservate continuano a esistere, quindi i relativi costi vengono ancora addebitati finché non le si elimina.

Se una risorsa viene sostituita, UpdateReplacePolicy conserva la risorsa fisica precedente, ma la rimuove dall'ambito di CloudFormation.

Snapshot

Per le risorse che supportano gli snapshot, CloudFormation crea uno snapshot per la risorsa prima di eliminarla. Gli snapshot creati con questa policy continuano a esistere, quindi i relativi costi vengono ancora addebitati finché non li si elimina.

Nota

Se specifichi l'opzione Snapshot in UpdateReplacePolicy per una risorsa che non supporta gli snapshot, CloudFormation ripristina l'opzione predefinita, ovvero Delete.

Le risorse che supportano gli snapshot includono:

• AWS::EC2::Volume

• AWS::ElastiCache::CacheCluster

• AWS::ElastiCache::ReplicationGroup

• AWS::Neptune::DBCluster

• AWS::RDS::DBCluster

• AWS::RDS::DBInstance

• AWS::Redshift::Cluster