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:
Argomenti
- Dove vengono archiviati i modelli
- Convalida dei modelli
- Guida introduttiva ai modelli
- Formati di modello
- Sezioni del modello
- Infrastructure Composer
- generatore IAc
- Ottieni valori archiviati in altri servizi
- Ottieni gli output esportati
- Usa i tipi di CloudFormation parametri forniti da -provided
- Procedure guidate
- Frammenti di modello
- Utilizzo dei modelli di stack di Windows
- Crea configurazioni di risorse riutilizzabili con i moduli
- Usa i CloudFormation tipi di risorse forniti
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:
-
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:
-
Scegli le risorse: identifica le AWS risorse che desideri includere nel tuo stack, come EC2 istanzeVPCs, gruppi di sicurezza e altro.
-
Scrivi il modello: scrivi il modello nel JSON nostro YAML formato, definendo le risorse e le relative proprietà.
-
Salva il modello: salva il modello localmente con un'estensione di file come:
.json
.yaml
, o.txt
. -
Convalida il modello: convalida il modello utilizzando i metodi descritti nella Convalida dei modelli sezione.
-
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.
-