View a markdown version of this page

Rollback di un aggiornamento - AWS CloudFormation

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Rollback di un aggiornamento

A volte, quando CloudFormation tenta di ripristinare un aggiornamento dello stack, non riesce a ripristinare tutte le modifiche apportate durante il processo di aggiornamento. Questa operazione è chiamata stato UPDATE_ROLLBACK_FAILED. Ad esempio, potresti avere uno stack che inizia a tornare a una vecchia istanza di database che è stata eliminata all'esterno di. CloudFormation Poiché CloudFormation non sa che il database è stato eliminato, presume che l'istanza database sia ancora disponibile e tenta di eseguire il rollback, provocando un errore nel rollback di aggiornamento.

Uno stack con lo stato UPDATE_ROLLBACK_FAILED non può essere aggiornato, ma è possibile eseguire il rollback a uno stato di funzionamento (UPDATE_ROLLBACK_COMPLETE). Dopo aver ripristinato le impostazioni originali dello stack, puoi provare nuovamente ad aggiornarlo.

Nella maggior parte dei casi, devi correggere l'errore che causa un guasto durante l'aggiornamento del rollback prima di poter continuare a eseguire il rollback dello stack. In altri casi, puoi continuare a eseguire il rollback dell'aggiornamento senza alcuna modifica, ad esempio quando un'operazione stack scade.

Se non riesci a correggere l'errore, puoi forzare il completamento del rollback. CloudFormation salta ogni risorsa che non riesce a ripristinare e restituisce lo stack a. UPDATE_ROLLBACK_COMPLETE Per ulteriori informazioni, consulta Forza il completamento di un rollback.

Nota

Se utilizzi gli stack nidificati, il rollback dello stack padre cercherà di eseguire il rollback anche su tutti gli stack figlio.

Per continuare il rollback di un aggiornamento (console)
  1. Accedi a Console di gestione AWS e apri la CloudFormation console all'indirizzo. https://console.aws.amazon.com/cloudformation

  2. Nella barra di navigazione nella parte superiore dello schermo, scegli Regione AWS dove si trova lo stack.

  3. Nella pagina Stack, seleziona lo stack che desideri aggiornare, scegli Operazioni stack, poi scegli Continua il ripristino dello stato precedente l’aggiornamento.

    Se nessuna delle soluzioni Risoluzione degli errori funziona, puoi utilizzare l'opzione avanzata per saltare le risorse che non CloudFormation possono essere ripristinate correttamente. Devi ricercare e digitare gli ID logici delle risorse che desideri ignorare. Specifica solo le risorse con stato UPDATE_FAILED durante UpdateRollback e non durante l’aggiornamento successivo.

    avvertimento

    CloudFormation imposta lo stato delle risorse specificate su UPDATE_COMPLETE e continua a ripristinare lo stack. Dopo aver completato il rollback, lo stato delle risorse saltate saranno incoerenti con lo stato delle risorse nel modello di stack. Prima di eseguire un altro aggiornamento dello stack, devi aggiornare lo stack o le risorse in modo che siano coerenti. Altrimenti, i successivi aggiornamenti dello stack potrebbero fallire e lo stack diventerà irrecuperabile.

    Specifica il numero minimo di risorse necessarie per eseguire il rollback dello stack. Ad esempio, un aggiornamento della risorsa non riuscito potrebbe causare errori nelle risorse dipendenti. In questo caso, potrebbe non essere necessario ignorare le risorse dipendenti.

    Per ignorare le risorse che fanno parte di stack nidificati, utilizzare il formato seguente: NestedStackName.ResourceLogicalID. Se desideri specificare l'ID logico di una risorsa stack (Type: AWS::CloudFormation::Stack) nell'elenco ResourcesToSkip, lo stack corrispondente incorporato deve essere in uno dei seguenti stati: DELETE_IN_PROGRESSDELETE_COMPLETE o DELETE_FAILED.

Per continuare a ripristinare un aggiornamento (AWS CLI)
  • Usa il comando continue-update-rollback con l’opzione --stack-name per specificare l’ID dello stack sul quale desideri continuare a eseguire il rollback.

    Per forzare il completamento del rollback, aggiungi l'--force-rollbackopzione. Per ulteriori informazioni, consulta Forza il completamento di un rollback.

Forza il completamento di un rollback

Usa il rollback forzato quando non riesci a correggere l'errore che causa il fallimento del rollback dell'aggiornamento. Invece di cercare ed elencare ogni risorsa--resources-to-skip, lasci CloudFormation saltare le risorse che non riescono a ripristinare.

Quando si forza un rollback, CloudFormation continua a riportare indietro lo stack. CloudFormation salta ogni risorsa che si trova nello UPDATE_FAILED stato perché un rollback non è riuscito, comprese le risorse negli stack annidati. CloudFormation imposta lo stato di ogni risorsa ignorata con il motivo dello stato. UPDATE_COMPLETE Resource skipped during UpdateRollback Al termine del rollback, il motivo dello stato dello stack riporta che una o più risorse sono state ignorate.

CloudFormation salta solo le risorse il cui rollback non è riuscito. Le risorse che non sono riuscite durante l'aggiornamento successivo non vengono ignorate.

L'continue-update-rollbackesempio seguente forza il completamento del rollback dello MyStack stack.

aws cloudformation continue-update-rollback --stack-name MyStack \ --force-rollback

Non puoi usare --force-rollback and --resources-to-skip nella stessa richiesta. Per ignorare solo un set specifico di risorse, usa --resources-to-skip without--force-rollback.

avvertimento

Una volta completato il rollback, le risorse ignorate non corrispondono più alle risorse nel modello dello stack. Prima di eseguire un altro aggiornamento dello stack, è necessario aggiornare lo stack o le risorse in modo che siano coerenti tra loro. Altrimenti, i successivi aggiornamenti dello stack potrebbero fallire e lo stack diventerà irrecuperabile.

I rapporti sul rilevamento della deriva hanno ignorato le risorse come. NOT_CHECKED Per scoprire se una risorsa ignorata è diversa dal modello, DetectStackResourceDriftesegui sulla risorsa.

Continuare il rollback da aggiornamenti non riusciti di stack nidificati

Quando disponi di più stack nidificati l’uno all’interno dell’altro, potresti dover ignorare risorse in più livelli nidificati per far tornare l’intera gerarchia dello stack a uno stato di funzionamento.

Ad esempio, disponi di uno stack root chiamato WebInfra che contiene all’interno due stack più piccoli, WebInfra-Compute e WebInfra-Storage. Anche questi due stack hanno altri stack nidificati al loro interno.

Se si verifica un errore durante un aggiornamento e il relativo processo non va a buon fine, l’intera gerarchia dello stack potrebbe entrare nello stato UPDATE_ROLLBACK_FAILED, come illustrato nel seguente diagramma.

Un diagramma che mostra una gerarchia di stack nidificati su tre livelli.
Nota

I nomi di stack in questo esempio vengono troncati per semplicità. I nomi degli stack secondari sono in genere generati CloudFormation e contengono stringhe casuali uniche, quindi i nomi effettivi potrebbero non essere facili da usare.

Per rendere lo stack principale utilizzabile utilizzando il continue-update-rollback comando, è necessario ignorare le risorse che non sono state ripristinate. È possibile utilizzare l'--force-rollbackopzione per ignorarle su tutti i livelli annidati oppure utilizzare l'opzione per elencarle--resources-to-skip.

L'continue-update-rollbackesempio seguente forza il completamento del rollback dell'intera gerarchia. Non è necessario trovare i nomi degli stack annidati o gli ID logici.

aws cloudformation continue-update-rollback --stack-name WebInfra \ --force-rollback

L’esempio continue-update-rollback seguente riprende un’operazione di rollback da un aggiornamento dello stack precedentemente non riuscito. In questo esempio, l’opzione --resources-to-skip include i seguenti elementi:

  • myCustom

  • WebInfra-Compute-Asg.myAsg

  • WebInfra-Compute-LB.myLoadBalancer

  • WebInfra-Storage.DB

Per le risorse dello stack root, devi fornire solamente l’ID logico, ad esempio myCustom. Tuttavia, per le risorse contenute negli stack nidificati, devi fornire sia il nome che l’ID logico dello stack nidificato, separati da un punto. Ad esempio, WebInfra-Compute-Asg.myAsg.

aws cloudformation continue-update-rollback --stack-name WebInfra \ --resources-to-skip myCustom WebInfra-Compute-Asg.myAsg WebInfra-Compute-LB.myLoadBalancer WebInfra-Storage.DB
Per trovare il nome dello stack di uno stack nidificato

Puoi trovarlo all’interno dell’ID stack o nel nome della risorsa Amazon (ARN) dello stack figlio.

Il seguente ARN di esempio fa riferimento a uno stack chiamato WebInfra-Storage-Z2VKC706XKXT.

arn:aws:cloudformation:us-east-1:123456789012:stack/WebInfra-Storage-Z2VKC706XKXT/ea9e7f90-54f7-11e6-a032-028f3d2330bd
Per trovare l’ID logico di uno stack nidificato

Puoi trovare l'ID logico dello stack figlio nella definizione del modello del padre. Nel diagramma, il LogicalId dello stack figlio WebInfra-Storage-DB è DB nel padre WebInfra-Storage.

Nella CloudFormation console, puoi anche trovare l'ID logico nella colonna ID logico per la risorsa dello stack nella scheda Risorse o nella scheda Eventi. Per ulteriori informazioni, consulta Visualizza le informazioni sullo stack dalla console CloudFormation.

Nota

L'RollbackStackoperazione supporta anche la modalità express. È possibile utilizzare --deployment-config '{"mode": "EXPRESS"}' il rollback-stack comando per ripristinare più rapidamente uno stack fallito. Per ulteriori informazioni, consulta modalità Express.