Lavorare con i CloudFormation modelli - 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à.

Lavorare con i CloudFormation modelli

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

È possibile creare modelli utilizzando i seguenti metodi:

  • AWS Infrastructure Composer— Un'interfaccia visiva per la progettazione di modelli.

  • AWS CloudFormation Designer: una vecchia interfaccia visiva per la progettazione di modelli.

  • Editor di testo: scrivi modelli direttamente nella JSON nostra YAML sintassi.

  • Generatore IaC: genera modelli a partire dalle risorse fornite nel tuo account che attualmente non sono gestite da. CloudFormation Il generatore IAc funziona con un'ampia gamma di tipi di risorse supportati da Cloud Control API nella tua regione.

Questa sezione fornisce una guida completa su come utilizzare le diverse sezioni di un CloudFormation modello e su come iniziare a creare modelli di stack. Tratta i seguenti argomenti:

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 o AWS CLI, viene creato automaticamente un bucket S3. 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. Per ulteriori informazioni, consulta Crea uno stack dal codice sorgente del repository con Git sync.

Convalida dei modelli

Convalida della sintassi

È possibile verificare la YAML sintassi JSON o del modello utilizzando il validate-templateCLIcomando o specificando il modello sulla console. La console esegue la convalida automaticamente. Per ulteriori informazioni, consulta Crea uno stack dalla console CloudFormation .

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:

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.

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

  3. Salva il modello: salva il modello localmente con un'estensione di file come: .json.yaml, o.txt.

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

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

Pianifica di utilizzare il modello di riferimento CloudFormation

Durante la scrittura dei modelli, è possibile trovare la documentazione sulla sintassi dettagliata per i diversi tipi di risorse in. AWS riferimento ai tipi di risorse e proprietà

Spesso, i modelli di stack richiedono funzioni intrinseche per assegnare valori di proprietà che non sono disponibili fino al runtime e attributi speciali per controllare il comportamento delle risorse. Durante la stesura del modello, consulta le seguenti risorse come guida:

  • Riferimento funzione intrinseca— Alcune funzioni intrinseche di uso comune 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.

  • Riferimento attributo della risorsa— Alcuni attributi speciali di uso comune includono:

    • 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.