Utilizzo di Application Manager per gestire i modelli CloudFormation - AWS Systems Manager

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

Utilizzo di Application Manager per gestire i modelli CloudFormation

Application Manager, uno strumento di AWS Systems Manager, include una libreria di modelli e altri strumenti per poter gestire i modelli di AWS CloudFormation. Questa sezione include le seguenti informazioni.

Utilizzo della libreria dei modelli

La libreria dei modelli di Application Manager offre strumenti che consentono di visualizzare, creare, modificare, eliminare e clonare i modelli. È inoltre possibile effettuare il provisioning degli stack direttamente dalla libreria dei modelli. I modelli vengono memorizzati come documenti di Systems Manager (SSM) di tipo CloudFormation. Memorizzando i modelli come documenti SSM, è possibile utilizzare i controlli versione per utilizzare versioni diverse di un modello. È anche possibile impostare autorizzazioni e condividere modelli. Dopo aver effettuato correttamente il provisioning di uno stack, lo stack e il modello sono disponibili in Application Manager e CloudFormation.

Prima di iniziare

Si consiglia di leggere i seguenti argomenti per ulteriori informazioni sui documenti SSM prima di iniziare a utilizzare i modelli di CloudFormation in Application Manager.

Per visualizzare la libreria dei modelli in Application Manager
  1. Aprire la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel pannello di navigazione, scegliere Application Manager.

  3. Scegli Libreria di modelli CloudFormation.

Creazione di un modello

La procedura seguente descrive come creare un modello di CloudFormation in Application Manager. Quando crei un modello, inserisci i dettagli dello stack del modello in JSON o YAML. Se non hai familiarità con JSON o YAML, puoi usare AWS Infrastructure Composer, uno strumento che permette di creare e modificare visivamente i modelli. Per ulteriori informazioni, consulta Creare modelli visivamente con Infrastructure Composer nella Guida per l'utente AWS CloudFormation. Per ulteriori informazioni sulla struttura e sintassi di un modello, consulta Sezioni dei modelli CloudFormation nella Guida per l'utente AWS CloudFormation.

È inoltre possibile creare un modello da più frammenti di modello. I frammenti di modello sono esempi che illustrano come scrivere modelli per una risorsa specifica. Ad esempio, puoi visualizzare frammenti per istanze di Amazon Elastic Compute Cloud (Amazon EC2), domini di Amazon Simple Storage Service (Amazon S3), mappature di CloudFormation e altro ancora. I frammenti sono raggruppati per risorsa. Puoi trovare i frammenti generici di CloudFormation nella sezione General template snippets (frammenti di modello generali) della Guida per l'utente di AWS CloudFormation.

Creazione di un modello di CloudFormation in Application Manager (console)

Usa la procedura seguente per creare un modello di CloudFormation in Application Manager utilizzando la AWS Management Console.

Per creare un modello di CloudFormation in Application Manager
  1. Aprire la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel pannello di navigazione, scegliere Application Manager.

  3. Scegli Libreria di modelli CloudFormation, quindi o scegli Crea modello o scegli un modello esistente e poi scegli Azioni, Clona.

  4. Per Name (Nome), inserire un nome per il modello che consente di identificare le risorse create o lo scopo dello stack.

  5. (Facoltativo) Per Version name (Versione nome), inserire un nome o un numero per identificare la versione del modello.

  6. Nella sezione Editor di copia, scegli YAML o JSON e quindi inserisci o copia e incolla il codice del modello.

  7. (Facoltativo) Nella sezione Tags (Tag) applica una o più coppie nome/valore chiave tag al modello.

  8. (Facoltativo) Nella sezione Permissions (Autorizzazioni), inserire un ID di Account AWS e scegliere Add account (Aggiungi un account). Questa operazione fornisce l'autorizzazione di lettura per il modello. Il proprietario dell'account può effettuare il provisioning e clonare il modello, ma non può modificarlo o eliminarlo.

  9. Scegliere Create (Crea). Il modello viene salvato nel servizio documenti di Systems Manager (SSM).

Creazione di un modello di CloudFormation in Application Manager (riga di comando)

Dopo aver creato il contenuto del modello di CloudFormation in JSON o YAML, puoi usare AWS Command Line Interface (AWS CLI) o AWS Strumenti per PowerShell per salvare il modello come documento SSM. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni.

Prima di iniziare

Se non è già stato fatto, installare e configurare AWS CLI o AWS Strumenti per PowerShell. Per informazioni, consulta le pagine Installazione o aggiornamento della versione più recente di AWS CLI e Installazione di AWS Strumenti per PowerShell.

Linux & macOS
aws ssm create-document \ --content file://path/to/template_in_json_or_yaml \ --name "a_name_for_the_template" \ --document-type "CloudFormation" \ --document-format "JSON_or_YAML" \ --tags "Key=tag-key,Value=tag-value"
Windows
aws ssm create-document ^ --content file://C:\path\to\template_in_json_or_yaml ^ --name "a_name_for_the_template" ^ --document-type "CloudFormation" ^ --document-format "JSON_or_YAML" ^ --tags "Key=tag-key,Value=tag-value"
PowerShell
$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String New-SSMDocument ` -Content $json ` -Name "a_name_for_the_template" ` -DocumentType "CloudFormation" ` -DocumentFormat "JSON_or_YAML" ` -Tags "Key=tag-key,Value=tag-value"

Se il comando viene eseguito correttamente, verrà visualizzata una risposta simile alla seguente:

{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }

Modifica di un modello

Usa la procedura seguente per modificare un modello di CloudFormation in Application Manager. Le modifiche ai modelli sono disponibili in CloudFormation dopo avere effettuato il provisioning di uno stack che utilizza il modello aggiornato.

Per modificare un modello di CloudFormation in Application Manager
  1. Aprire la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel pannello di navigazione, scegliere Application Manager.

  3. Scegli Libreria di modelli CloudFormation

  4. Scegliere un modello e quindi scegliere Actions (Operazioni), Edit (Modifica). Non è possibile modificare il nome di un modello, ma è possibile modificare tutti gli altri dettagli.

  5. Scegliere Save (Salva). Il modello viene salvato nel servizio Systems Manager Document.