Stack from CloudFormation Template | Aggiornamento - Riferimento al tipo di modifica avanzata AMS
Dettagli del tipo di modificaInformazioni aggiuntiveParametri di input di esecuzioneEsempio: parametri obbligatoriEsempio: tutti i parametri

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

Stack from CloudFormation Template | Aggiornamento

Aggiorna i and/or parametri del modello di uno stack CFN. Per aggiornare solo i parametri in uno stack esistente non è necessario un modello CFN modificato, ma è possibile fornire parametri modificati. I valori dei parametri esistenti vengono sovrascritti, i valori dei nuovi parametri vengono aggiunti. Per aggiungere, eliminare o modificare una risorsa o per modificare gli attributi non referenziati da un parametro, utilizzate un modello CFN modificato. Se l'aggiornamento comporta la sostituzione o la rimozione di una risorsa dello stack, la RFC ha esito negativo e richiede l'approvazione tramite il CT «Approva ChangeSet e aggiorna lo CloudFormation stack» (ct-1404e21baa2ox).

Classificazione completa: Management | Custom Stack | Stack from Template | Update CloudFormation

Dettagli del tipo di modifica

Cambia tipo ID

ct-361tlo1k7339x

Versione corrente

2.0

Durata di esecuzione prevista

360 minuti

Approvazione AWS

Richiesto

Approvazione del cliente

Campo non obbligatorio

Modalità di esecuzione

Automatizzata

Informazioni aggiuntive

Aggiorna lo CloudFormation stack di importazione

CloudFormation stack update interface showing description, ID, and version details.

Per aggiornare uno stack CloudFormation di importazione utilizzando la console

  1. Vai alla pagina Crea RFC: nel riquadro di navigazione a sinistra della console AMS, fai clic RFCsper aprire la pagina dell' RFCs elenco, quindi fai clic su Crea RFC.

  2. Scegli un tipo di modifica (CT) popolare nella visualizzazione predefinita Sfoglia i tipi di modifica o seleziona un CT nella visualizzazione Scegli per categoria.

    • Naviga per tipo di modifica: puoi fare clic su un CT popolare nell'area di creazione rapida per aprire immediatamente la pagina Run RFC. Nota che non puoi scegliere una versione CT precedente con creazione rapida.

      Per ordinare CTs, utilizzate l'area Tutti i tipi di modifica nella vista a scheda o tabella. In entrambe le visualizzazioni, selezionate un CT, quindi fate clic su Crea RFC per aprire la pagina Esegui RFC. Se applicabile, accanto al pulsante Crea RFC viene visualizzata l'opzione Crea con una versione precedente.

    • Scegli per categoria: seleziona una categoria, sottocategoria, articolo e operazione e la casella dei dettagli CT si apre con l'opzione Crea con una versione precedente, se applicabile. Fai clic su Crea RFC per aprire la pagina Esegui RFC.

  3. Nella pagina Run RFC, apri l'area del nome CT per visualizzare la casella dei dettagli CT. È richiesto un oggetto (questo campo viene compilato automaticamente se si sceglie il CT nella vista Sfoglia i tipi di modifica). Apri l'area di configurazione aggiuntiva per aggiungere informazioni sull'RFC.

    Nell'area di configurazione dell'esecuzione, utilizza gli elenchi a discesa disponibili o inserisci i valori per i parametri richiesti. Per configurare i parametri di esecuzione opzionali, aprite l'area di configurazione aggiuntiva.

  4. Al termine, fate clic su Esegui. Se non sono presenti errori, viene visualizzata la pagina RFC creata correttamente con i dettagli RFC inviati e l'output iniziale di Run.

  5. Apri l'area dei parametri di esecuzione per visualizzare le configurazioni inviate. Aggiorna la pagina per aggiornare lo stato di esecuzione RFC. Facoltativamente, annulla la RFC o creane una copia con le opzioni nella parte superiore della pagina.

Per aggiornare uno stack CloudFormation di importazione utilizzando la CLI

  1. Utilizza Inline Create (immetti un create-rfc comando con tutti i parametri RFC e di esecuzione inclusi) o Template Create (crei due file JSON, uno per i parametri RFC e uno per i parametri di esecuzione) ed esegui il create-rfc comando con i due file come input. Entrambi i metodi sono descritti qui.

  2. Invia il aws amscm submit-rfc --rfc-id ID comando RFC: con l'ID RFC restituito.

    Monitora il comando RFC:. aws amscm get-rfc --rfc-id ID

Per verificare la versione del tipo di modifica, usa questo comando:

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
Nota

È possibile utilizzare qualsiasi CreateRfc parametro con qualsiasi RFC, indipendentemente dal fatto che faccia parte o meno dello schema per il tipo di modifica. Ad esempio, per ricevere notifiche quando lo stato RFC cambia, aggiungi questa riga --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" alla parte dei parametri RFC della richiesta (non ai parametri di esecuzione). Per un elenco di tutti i CreateRfc parametri, consulta l'AMS Change Management API Reference.

  1. Prepara il CloudFormation modello che desideri utilizzare per aggiornare lo stack e caricalo nel tuo bucket S3. Per dettagli importanti, consulta le linee guida, le CloudFormation best practice e le limitazioni di AWS Ingest.

  2. Crea e invia la RFC ad AMS:

    1. Crea e salva il file JSON dei parametri di esecuzione, includi i parametri del CloudFormation modello che desideri. Questo esempio lo chiama UpdateCfnParams .json.

      Esempio di UpdateCfnParams file.json con aggiornamenti dei parametri in linea:

      {
  "StackId": "stack-yjjoo9aicjyqw4ro2",
  "VpcId": "VPC_ID",
  "CloudFormationTemplate": "{\"AWSTemplateFormatVersion\":\"2010-09-09\",\"Description\":\"Create a SNS topic\",\"Parameters\":{\"TopicName\":{\"Type\":\"String\"},\"DisplayName\":{\"Type\":\"String\"}},\"Resources\":{\"SnsTopic\":{\"Type\":\"AWS::SNS::Topic\",\"Properties\":{\"TopicName\":{\"Ref\":\"TopicName\"},\"DisplayName\":{\"Ref\":\"DisplayName\"}}}}}",
  "TemplateParameters": [
    {
      "Key": "TopicName",
      "Value": "TopicNameCLI"
    },
    {
      "Key": "DisplayName",
      "Value": "DisplayNameCLI"
    }
  ],
  "TimeoutInMinutes": 1440
}

      Esempio di UpdateCfnParams file.json con endpoint bucket S3 contenente un modello aggiornato: CloudFormation 

      {
  "StackId": "stack-yjjoo9aicjyqw4ro2",
  "VpcId": "VPC_ID",
  "CloudFormationTemplateS3Endpoint": "s3_url",
  "TemplateParameters": [
    {
      "Key": "TopicName",
      "Value": "TopicNameCLI"
    },
    {
      "Key": "DisplayName",
      "Value": "DisplayNameCLI"
    }
  ],
  "TimeoutInMinutes": 1080
}

  3. Crea e salva il file JSON dei parametri RFC con il seguente contenuto. Questo esempio lo chiama UpdateCfnRfc file.json.

    {
   "ChangeTypeId": "ct-361tlo1k7339x",
   "ChangeTypeVersion": "1.0",
   "Title": "cfn-ingest-template-update"
}

  4. Crea la RFC, specificando il UpdateCfnRfc file e il file: UpdateCfnParams 

    aws amscm create-rfc --cli-input-json file://UpdateCfnRfc.json  --execution-parameters file://UpdateCfnParams.json

    Nella risposta ricevi l'ID della nuova RFC e puoi utilizzarlo per inviare e monitorare la RFC. Finché non la invii, la RFC rimane nello stato di modifica e non si avvia.

  • Questo tipo di modifica è ora alla versione 2.0. Le modifiche includono la rimozione del AutoApproveUpdateForResourcesparametro, utilizzato nella versione 1.0 di questo CT, e l'aggiunta di due nuovi parametri: AutoApproveRiskyUpdatese BypassDriftCheck.

  • Se il bucket S3 esiste in un account AMS, è necessario utilizzare le credenziali AMS per questo comando. Ad esempio, potrebbe essere necessario aggiungere --profile saml dopo aver ottenuto le credenziali AMS AWS Security Token Service ().AWS STS

  • Tutti Parameter i valori per le risorse nel CloudFormation modello devono avere un valore, tramite un valore predefinito o personalizzato tramite la sezione dei parametri del CT. È possibile sovrascrivere il valore del parametro strutturando le risorse del CloudFormation modello in modo che facciano riferimento a una chiave Parameters. Per esempi che mostrano come fare, consulta CloudFormation ingest stack: esempi di validatori CFN.

    IMPORTANTE: i parametri mancanti non vengono forniti esplicitamente nel modulo, per impostazione predefinita sono i valori attualmente impostati nello stack o nel modello esistente.

  • Per un elenco dei servizi forniti autonomamente che è possibile aggiungere utilizzando CloudFormation Ingest, consulta CloudFormation Ingest Stack: Supported Resources.

    Per ulteriori informazioni CloudFormation, consulta AWS CloudFormation.

Il modello è convalidato per garantire che possa essere creato in un account AMS. Se supera la convalida, viene aggiornato per includere tutte le risorse o le configurazioni necessarie per renderlo conforme ad AMS. Ciò include l'aggiunta di risorse come gli CloudWatch allarmi Amazon per consentire ad AMS Operations di monitorare lo stack.

La RFC viene rifiutata se si verifica una delle seguenti condizioni:

  • La sintassi RFC JSON non è corretta o non segue il formato specificato.

  • L'URL prefirmato del bucket S3 fornito non è valido.

  • Il modello non è una sintassi valida. CloudFormation

  • Nel modello non sono impostati valori predefiniti per tutti i valori dei parametri.

  • Il modello non supera la convalida AMS. Per le fasi di convalida AMS, consulta le informazioni più avanti in questo argomento.

La RFC fallisce se lo CloudFormation stack non viene creato a causa di un problema di creazione delle risorse.

Per saperne di più sulla convalida e la validazione CFN, consulta Template Validation and CloudFormation ingest stack: esempi di validatori CFN.

Parametri di input di esecuzione

Per informazioni dettagliate sui parametri di input di esecuzione, vedereSchema per il tipo di modifica ct-361tlo1k7339x.

Esempio: parametri obbligatori

{
  "StackId": "stack-kiwonebfnadq08sol",
  "VpcId": "vpc-01234567890abcdef",
  "TimeoutInMinutes": 360
}

Esempio: tutti i parametri

Example not available.