Panoramica dei modelli

Un record AWS CloudFormation il modello definisce il AWS risorse che desideri creare, aggiornare o eliminare come parte di uno stack. È composta da diverse sezioni, ma l'unica sezione obbligatoria è la Resources sezione, che deve dichiarare almeno una risorsa.

• Per la struttura completa del modello con tutte le sezioni disponibili, vediFormati di modello.

• Per informazioni dettagliate su ciascuna sezione, vedereSezioni del modello.

Il file modello segue regole di formattazione specifiche utilizzando JavaScript Object Notation (JSON) o YAML standard. JSONè più dettagliato e rigido, mentre YAML è più leggibile e flessibile. Per ulteriori informazioni, consulta Formati di modello.

Dove vengono archiviati i modelli

Bucket Amazon S3

Puoi archiviare CloudFormation i modelli in un bucket Amazon S3. Quando crei o aggiorni uno stack, puoi specificare l'S3 URL del modello invece di caricarlo direttamente.

Se carichi i modelli direttamente tramite AWS Management Console oppure AWS CLI, un bucket S3 viene creato automaticamente per te. Per ulteriori informazioni, consulta Crea uno stack dalla console CloudFormation .

Repository Git

Con Git sync, puoi archiviare i modelli in un repository Git. Quando crei o aggiorni uno stack, puoi specificare la posizione del repository Git e il ramo contenente il modello invece di caricarlo direttamente o fare riferimento a un S3. URL CloudFormation monitora automaticamente il repository e il ramo specificati per le modifiche al modello.

Convalida dei modelli

Convalida della sintassi

È possibile verificare la YAML sintassi JSON o del modello utilizzando validate-templateCLIcomando o specificando il modello sulla console. La console esegue la convalida automaticamente. Tuttavia, questi metodi verificano solo la sintassi del modello e non convalidano i valori delle proprietà specificati per una risorsa.

Strumenti di convalida aggiuntivi

Per convalide più complesse e controlli basati sulle migliori pratiche, puoi utilizzare strumenti aggiuntivi come:

• CloudFormation Linter (cfn-lint): convalida i modelli rispetto agli schemi dei provider di risorse. Include il controllo dei valori validi per le proprietà delle risorse e le migliori pratiche.

• CloudFormation Rain (rain fmt): formatta i tuoi CloudFormation modelli secondo uno standard coerente o riformatta un modello da JSON a YAML (o YAML aJSON). Conserva i commenti durante l'uso YAML e, ove possibile, passa dall'uso delle funzioni intrinseche alla sintassi breve.

Guida introduttiva ai modelli

Per iniziare a creare un CloudFormation modello, segui questi passaggi:

1. Scegli le risorse: identifica le AWS risorse che desideri includere nel tuo stack, come EC2 istanzeVPCs, gruppi di sicurezza e altro ancora.

2. Scrivi il modello: scrivi il modello nel JSON nostro YAML formato, definendo le risorse e le relative proprietà.

3. Convalida il modello: convalida il modello utilizzando i metodi descritti nella Convalida dei modelli sezione.

4. Crea uno stack: crea uno stack utilizzando il modello convalidato.

Risorse aggiuntive

• AWS riferimento ai tipi di risorse e proprietàFornisce la sintassi per dichiarare diversi tipi di risorse.

• Le funzioni Riferimento funzione intrinseca dei documenti che puoi utilizzare per eseguire attività come unire stringhe o fare riferimento ad altre risorse all'interno dei tuoi modelli. Le funzioni intrinseche comunemente utilizzate includono:

  • Ref— Recupera il valore di un parametro o l'ID fisico di una risorsa.

  • Sub— Sostituisce i segnaposto nelle stringhe con valori effettivi.

  • GetAtt— Restituisce il valore di un attributo da una risorsa nel modello.

  • Join— Unisce un set di valori in un'unica stringa.

• Gli attributi speciali del Riferimento attributo della risorsa documento che possono essere utilizzati, tra cui:

  • DependsOn— Utilizzate questo attributo per specificare che una risorsa deve essere creata dopo l'altra.

  • DeletionPolicy— Utilizzate questo attributo per CloudFormation specificare come gestire l'eliminazione di una risorsa.

  • Metadata— Utilizzate questo attributo per specificare dati strutturati con una risorsa.