Modifica i modelli visivamente con template studio

Template studio è un editor di modelli nella CloudFormation console. Mostra il modello come testo accanto a un diagramma delle risorse dichiarate dal modello. Quando si modifica il modello, il diagramma viene ridisegnato per corrispondere. Puoi convalidare il modello, convertirlo tra YAML e JSON e salvarlo su Amazon S3 senza uscire dalla console.

Il testo del modello è autorevole. Il diagramma è una rappresentazione visiva di quel testo, non una superficie modificabile separata. Tutte le modifiche vengono apportate al modello.

Considerazioni

Tieni presente quanto segue quando lavori in Template Studio:

• L'autore viene creato nel modello, non nel diagramma. Il diagramma mostra le risorse dichiarate dal modello e il modo in cui si riferiscono tra loro; non è possibile aggiungere o configurare una risorsa modificando il diagramma.

• Le modifiche non vengono salvate automaticamente. Template studio richiede una conferma prima di eliminare le modifiche non salvate. Se lasci o aggiorni la pagina, le modifiche non salvate vengono eliminate. Salva su Amazon S3 oppure copia o scarica il modello prima di partire.

• La conversione di un modello da YAML a JSON ne elimina i commenti, perché JSON non ha una sintassi corrispondente. La riconversione in YAML non li ripristina.

• CloudFormation la convalida in template studio non è attualmente disponibile per bozze di dimensioni superiori a 51.200 byte (50 KiB). L'azione Validate corrente invia la bozza tramite il TemplateBody parametro, che ha questo limite. Questo non è il limite complessivo per le dimensioni del modello. È comunque possibile salvare il modello e utilizzarlo in un'operazione di pila, soggetta a quote. CloudFormation Per ulteriori informazioni, consulta Convalida di un modello.

• Saving scrive il modello in un bucket del tuo account, quindi i modelli che salvi vengono fatturati secondo le tariffe standard di Amazon S3. Per ulteriori informazioni, consulta Prezzi di Amazon S3.

• Puoi scaricare il diagramma delle risorse solo quando l'area di disegno è visualizzata nella vista Canvas o Both.

Autorizzazioni richieste per Template Studio

Le autorizzazioni necessarie dipendono dall'origine del modello e dalle azioni eseguite:

cloudformation:GetTemplate

Necessario per aprire il modello di uno stack esistente. Concedi l'accesso allo stack di cui desideri modificare il modello.

s3:GetObject

Necessario per leggere un modello da Amazon S3 utilizzando le tue credenziali. Concedi l'accesso all'oggetto modello di origine. Un URL predefinito utilizza l'autorizzazione inclusa nell'URL.

cloudformation:ValidateTemplate

Obbligatorio per scegliere Convalida.

s3:PutObject

Necessario per salvare un modello. Ambita questa autorizzazione agli oggetti nel bucket di destinazione, ad esempioarn:aws:s3:::destination-bucket/*, anziché a tutte le risorse.

s3:CreateBucket

Richiesto solo quando la console crea un bucket di destinazione mancante. Può essere il bucket gestito dalla console o il nome di un bucket specificato dall'utente. Il riutilizzo di un bucket esistente non richiede questa autorizzazione.

s3:ListBucket

Richiesto quando si salva in un bucket esistente specificato dall'utente. Template Studio lo utilizza HeadBucket per verificare l'accesso, il proprietario previsto del bucket e il bucket prima del caricamento Regione AWS .

Per il bucket gestito dalla console, questa autorizzazione è facoltativa. Senza di essa, la finestra di dialogo di salvataggio mostra ancora il nome del bucket. Il salvataggio richiede s3:PutObject e, se il bucket deve essere creato,. s3:CreateBucket

Apri template studio

La posizione da cui apri Template Studio determina con cosa si apre e cosa succede dopo il salvataggio.

Per iniziare un nuovo modello

1. Apri la CloudFormation console.

2. Nella barra di navigazione nella parte superiore dello schermo, scegli quello in Regione AWS cui intendi distribuirlo.

3. Nel riquadro di navigazione, scegli Template studio.

Per creare un modello durante la creazione di uno stack

1. Nella pagina Crea stack, scegli Crea con template studio.

2. Crea il modello, quindi scegli Salva e continua.

3. La procedura guidata dello stack continua con il modello che hai salvato, quindi non devi caricarlo separatamente.

Per modificare il modello di uno stack esistente

1. Nella pagina Pile, scegli il nome dello stack.

2. Aggiorna direttamente lo stack o crea un set di modifiche.

3. Nella pagina Prepara il modello, scegli Apri in template studio. Si apre il modello corrente dello stack.

4. Scegli Salva e continua a tornare all'aggiornamento o al set di modifiche con il modello modificato.

In un'altra parte della console, ovunque sia visualizzato un modello, puoi scegliere Apri in template studio per lavorarci sopra.

Lavora con il modello e il diagramma

Template studio si apre con il modello e il diagramma affiancati. Usa il controllo di visualizzazione per scegliere cosa visualizzare sullo schermo:

Template (Modello)

Solo il modello, a tutta larghezza. Utilizzatelo per leggere o scrivere un modello senza il diagramma.

Canvas

Solo il diagramma, a tutta larghezza. Usalo per un modello di grandi dimensioni in cui il diagramma richiede l'intera larghezza.

Entrambi

Il modello e il diagramma insieme. Trascina il divisorio tra di loro per dare più spazio a entrambi i lati.

Il diagramma raggruppa le risorse correlate e traccia una connessione ogni volta che una risorsa fa riferimento a un'altra tramiteRef, Fn::GetAttFn::Sub, o. DependsOn Una risorsa a cui non si fa riferimento viene visualizzata da sola, il che rende facile individuare una risorsa disconnessa accidentalmente.

Nota

Ad esempio, tre funzioni possono assumere lo stesso ruolo IAM. Il diagramma mostra il ruolo all'interno di ogni funzione, ma il modello dichiara solo un ruolo. Controlla il modello per vedere quante risorse esistono.

Converti tra YAML e JSON

Il formato in cui salvi determina il nome del file e il tipo di contenuto dell'oggetto che Template Studio scrive su Amazon S3.

Per convertire il modello che stai modificando

1. Scegli il controllo del formato, che assegna un nome al formato in cui ti trovi attualmente.

2. Scegli l'altro formato.

3. La conversione da YAML a JSON ti chiede di confermare, perché i commenti non possono essere trasferiti. Scegli Converti per continuare.

Importante

JSON non ha una sintassi per i commenti. Quando converti un modello YAML che contiene commenti in JSON, tali commenti vengono rimossi e la riconversione in YAML non li ripristina. Copia tutto ciò che desideri conservare prima di convertirlo.

Il controllo del formato non è disponibile mentre il modello non può essere letto, perché non c'è nulla di sufficientemente completo da convertire. Correggi prima il modello.

Problemi di sintassi durante la digitazione

L'editor controlla la sintassi del modello mentre lo scrivi e sottolinea ciò che non può leggere: una parentesi non chiusa, un rientro fuori posto, una chiave duplicata. Passa il mouse su una sottolineatura per vedere il problema. Se una riga presenta diversi problemi, questi vengono numerati in modo da poterli distinguere.

Si tratta di un controllo della sintassi del modello, non del suo contenuto. L'editor non sa quali tipi di risorse esistono o quali proprietà assumono, quindi un modello che sia perfettamente formato in YAML può comunque essere sbagliato in modi che solo io CloudFormation posso indicarvi. Scegli Convalida per questo.

Convalida un modello

La convalida verifica la sintassi del modello con l'editor e verifica il modello CloudFormation prima di utilizzarlo in un'operazione di pila. Entrambi i controlli utilizzano la bozza corrente, comprese le modifiche che non hai salvato. Un CloudFormation controllo riuscito non sostituisce gli errori di sintassi segnalati dall'editor.

Nota

Template studio invia la bozza all'ValidateTemplateAPI utilizzando il TemplateBody parametro. Questo parametro ha un limite di 51.200 byte (50 KiB).

Per una bozza superiore a questo limite, template studio non invia la richiesta. CloudFormation Il CloudFormation controllo non è disponibile, ma ciò non significa che il modello non sia valido. L'editor può comunque segnalare errori di sintassi.

La stessa API supporta modelli fino a 1 MB. TemplateURL Template studio non carica bozze modificate per la URL-based convalida. Puoi salvare il modello su Amazon S3 e convalidarlo tramite un'operazione di stack, soggetta a quote. CloudFormation

Per convalidare il modello che stai modificando

1. Scegli Convalida.

2. Un modello che supera entrambi i controlli viene segnalato come valido.

3. Se uno dei controlli rileva errori, esaminali nel messaggio di convalida. Gli errori dell'editor includono i numeri di riga e di colonna. Correggi gli errori nell'editor e convalida nuovamente.

Salvare un modello in Amazon S3

CloudFormation legge i modelli per le operazioni di stack da Amazon S3, quindi il salvataggio è ciò che rende il modello disponibile per il resto della console.

Utilizza riferimenti dinamici ai segreti archiviati in Secrets Manager o stringhe sicure in Systems Manager Parameter Store invece di includere segreti in testo semplice nei modelli salvati. Per ulteriori informazioni, consulta Ottenimento di valori archiviati in altri servizi utilizzando riferimenti dinamici.

Per salvare il modello che stai modificando

1. Seleziona Salva e continua.

2. Controlla la destinazione. Per impostazione predefinita, il modello va al bucket Amazon S3 che CloudFormation gestisce i modelli caricati nella versione corrente. Regione AWS Se quel bucket non esiste ancora, lo CloudFormation crea al momento del salvataggio e lo riutilizza per i modelli che salverai in seguito.

   1. Per scegliere invece la tua destinazione, scegli Usa un bucket diverso e inserisci un nome per il bucket. Il bucket viene creato se non esiste già.

3. Scegli Conferma e continua.

Nota

I modelli archiviati in Amazon S3 vengono fatturati alle tariffe standard di Amazon S3, indipendentemente dal bucket che li contiene. Per ulteriori informazioni, consulta Prezzi di Amazon S3.

Il salvataggio non richiede un risultato di convalida positivo. Quando la convalida rileva errori, template studio ti chiede di confermare che desideri comunque salvare. Il salvataggio non corregge questi errori; esaminali e correggili prima di utilizzare il modello in un'operazione di pila.

Copiate o scaricate un modello o un diagramma

Scegli Azioni modello per rimuovere il modello o il diagramma dalla console:

Copia il modello

Copia negli appunti il modello così come appare nell'editor.

Scarica il modello

Salva il modello come file, nel formato che stai modificando attualmente.

Scarica il diagramma delle risorse

Salva il diagramma come immagine PNG. Poiché l'immagine è un'acquisizione del diagramma, è disponibile solo quando il diagramma è sullo schermo.