Aggiornare il modello di stack - 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à.

Aggiornare il modello di stack

Per modificare le risorse o le proprietà di uno stack CloudFormation, devi aggiornare il modello dello stack. Inizia con il modello esistente per tale stack e apporta le modifiche necessarie. Se il modello è archiviato in un sistema di controllo dell’origine, usa una copia come punto di partenza. In caso contrario, puoi ottenere una copia del modello da CloudFormation.

Se desideri modificare solo i parametri o le impostazioni dello stack (ad esempio l’argomento Amazon SNS di uno stack), puoi riutilizzare il modello esistente senza ottenere una copia.

Puoi aggiornare un modello di stack CloudFormation utilizzando un editor di testo o Infrastructure Composer.

Per aggiornare un modello di stack esistente con Infrastructure Composer

  1. Accedere alla Console di gestione AWS e aprire la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.

  2. Nella pagina Stack, scegli il nome dello stack da aggiornare.

  3. Scegli la scheda Modello, poi scegli Visualizza in Infrastructure Composer.

    CloudFormation apre il modello in Infrastructure Composer.

  4. Aggiorna il modello utilizzando uno dei seguenti metodi:

    • Interfaccia Canvas: qui puoi trascinare e rilasciare le opzioni dalla palette Risorse. Configura le risorse facendo doppio clic su una scheda per aprire il pannello Proprietà delle risorse. Connetti le risorse in base alle esigenze. Per istruzioni dettagliate sull’uso dell’interfaccia Canvas, consulta How to compose in AWS Infrastructure Composer.

    • Interfaccia Modello: passa dall’interfaccia Canvas a quella Modello. Apporta aggiornamenti in linea al codice del modello. Passa dal formato JSON a YAML e viceversa in base alle esigenze.

  5. Scegli Convalida per verificare se sono presenti errori di sintassi nel modello.

  6. Quando è tutto pronto per esportare le modifiche in CloudFormation, scegli Aggiorna modello.

Per aggiornare un modello di stack esistente con AWS CLI

  1. Per ottenere il modello dello stack che desideri aggiornare, usa il comando CLI get-template.

  2. Copiare il modello, incollarlo in un file di testo, modificarlo e salvarlo. Copiare solo il modello. Nel comando il modello è racchiuso tra virgolette, ma le virgolette non vanno copiate. Il modello vero e proprio inizia con una parentesi graffa aperta e termina con la parentesi graffa finale chiusa. Specificare le modifiche alle risorse dello stack in questo file.

Tieni presente le seguenti considerazioni quando apporti modifiche al modello:

  • Non puoi aggiungere, modificare o eliminare un parametro utilizzato da una risorsa che non supporta gli aggiornamenti.

  • Per la maggior parte delle risorse, modificare il nome logico equivale a eliminare la risorsa sostituendola con una nuova. È necessario aggiornare anche tutte le altre risorse che dipendono dalla risorsa rinominata e questo potrebbe comportarne la sostituzione. Per altre risorse, l'avvio di un aggiornamento richiede l'aggiornamento di una proprietà (non solo del nome logico).

  • Per alcune risorse esistono limiti relativi ai valori che puoi impostare per determinate proprietà. Ad esempio, le modifiche della proprietà AllocatedStorage per un’istanza database RDS devono essere superiori al valore attuale. Se l’aggiornamento viola queste regole, quella parte non andrà a buon fine.

  • L’aggiornamento di una risorsa può influire anche su altre risorse che vi fanno riferimento. Se usi funzioni come La funzione Ref o La funzione Fn::GetAtt per impostare una proprietà basata su un’altra risorsa, quando apporti modifiche alla risorsa oggetto del riferimento, CloudFormation aggiornerà anche la risorsa di riferimento.

  • Per ulteriori informazioni sugli effetti dell’aggiornamento di determinate proprietà delle risorse, consulta AWS resource and property types reference. Per ogni proprietà, l'effetti di un aggiornamento sarà uno dei seguenti:

  • Puoi verificare la sintassi JSON o YAML del modello utilizzando il comando CLI validate-template o specificando il modello nella console. La console esegue la convalida automaticamente. Tuttavia, questi metodi verificano solamente la sintassi del modello e non convalidano se i valori delle proprietà specificati per una risorsa sono validi per tale risorsa. Per convalide più complesse o per verificare le best practice, puoi utilizzare strumenti aggiuntivi come CloudFormation Linter (cfn-lint) e CloudFormation Rain (rain fmt).

Nota

A volte CloudFormation non consente determinate modifiche che cerchi di apportare e segnalerà che la modifica non è consentita. Tuttavia, questo messaggio può essere visualizzato in modo asincrono perché le risorse vengono create e aggiornate da CloudFormation in un ordine non deterministico per impostazione predefinita.