Importazione manuale delle risorse AWS in uno stack CloudFormation - 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à.

Importazione manuale delle risorse AWS in uno stack CloudFormation

Con l’importazione delle risorse, puoi importare le risorse AWS esistenti in uno stack CloudFormation nuovo o esistente. Durante un’operazione di importazione, si crea un set di modifiche che importa le risorse esistenti in uno stack o crea un nuovo stack dalle risorse esistenti. Durante l’importazione è possibile fornire quanto segue.

  • Un modello che descrive l’intero stack, incluse le risorse dello stack originali e quelle in fase di importazione. Ogni risorsa da importare deve avere un attributo DeletionPolicy.

  • Identificatori per le risorse che stai importando che CloudFormation può utilizzare per mappare gli ID logici nel modello con le risorse esistenti.

Nota

CloudFormation supporta solo un livello di nidificazione utilizzando l’importazione delle risorse. Ciò significa che non è possibile importare uno stack in uno stack figlio o importare uno stack con figli.

Identificatori di risorse

Vengono forniti due valori per identificare ogni risorsa che importi.

  • Una proprietà identificatore. Si tratta di una proprietà di risorsa che può essere utilizzata per identificare ogni tipo di risorsa. Ad esempio, una risorsa AWS::S3::Bucket può essere identificata utilizzando il suo BucketName.

    La proprietà di risorsa che usi per identificare la risorsa che stai importando varia a seconda del tipo di risorsa. Puoi trovare la proprietà di risorsa nella console di CloudFormation. Dopo aver creato un modello che include la risorsa da importare, puoi avviare il processo di importazione, dove troverai le proprietà identificatore per le risorse che stai importando. Per alcuni tipi di risorse, potrebbero esserci diverse modalità di identificazione ed è possibile selezionare la proprietà da utilizzare negli elenchi a discesa.

    In alternativa, puoi ottenere le proprietà identificatore per le risorse che stai importando chiamando il comando CLI get-template-summary e specificando l’URL S3 del modello di stack come valore per l’opzione --template-url.

  • Un valore identificativo. Questo è il valore effettivo della proprietà della risorsa. Ad esempio, il valore effettivo per la proprietà BucketName potrebbe essere MyS3Bucket.

    È possibile ottenere il valore della proprietà identificatore dalla console di servizio per la risorsa.

Convalida dell’importazione delle risorse

Durante un’operazione di importazione, CloudFormation esegue le convalide seguenti.

  • La risorsa da importare esiste.

  • Le proprietà e i valori di configurazione per ogni risorsa da importare aderiscono allo schema del tipo di risorsa, che definisce le proprietà accettate, le proprietà richieste e i valori delle proprietà supportate.

  • Le proprietà richieste sono specificate nel modello. Le proprietà richieste per ogni tipo di risorsa sono descritte nell’argomento relativo alle informazioni di riferimento sulle proprietà e le risorse di AWS.

  • La risorsa da importare non appartiene a un altro stack nella stessa Regione.

CloudFormation non controlla che la configurazione del modello corrisponda alla configurazione effettiva delle proprietà delle risorse.

Importante

Verifica che le risorse e le rispettive proprietà definite nel modello corrispondano alla configurazione prevista per l’importazione delle risorse per evitare modifiche impreviste.

Codici di stato dell’importazione delle risorse

Questa tabella descrive i vari tipi di stato utilizzati con la funzionalità di importazione delle risorse.

Stato dell’operazione di importazione Descrizione

IMPORT_IN_PROGRESS

L’operazione di importazione è in corso.

IMPORT_COMPLETE

L’operazione di importazione è stata completata per tutte le risorse nello stack.

IMPORT_ROLLBACK_IN_PROGRESS

L’operazione di importazione di rollback sta eseguendo il rollback della configurazione del modello precedente.

IMPORT_ROLLBACK_FAILED

L’operazione di rollback dell’importazione ha avuto esito negativo.

IMPORT_ROLLBACK_COMPLETE

È stato eseguito il rollback dell’importazione alla configurazione del modello precedente.

Considerazioni durante un’operazione di importazione

  • Al termine dell’importazione e prima di eseguire operazioni di stack successive, ti consigliamo di eseguire il rilevamento della deviazione sulle risorse importate. Il rilevamento della deviazione garantisce che la configurazione del modello corrisponda alla configurazione effettiva. Per ulteriori informazioni, consulta Rilevamento della deviazione su un intero stack CloudFormation.

  • Le operazioni di importazione non consentono nuove creazioni di risorse, eliminazioni di risorse o modifiche alle configurazioni di proprietà.

  • Ogni risorsa da importare deve avere un attributo DeletionPolicy affinché l’operazione di importazione abbia esito positivo. È possibile impostare DeletionPolicy su qualsiasi valore possibile. Solo le risorse che stai importando necessitano di una DeletionPolicy. Le risorse che fanno già parte dello stack non richiedono una DeletionPolicy.

  • Non è possibile importare la stessa risorsa in più stack.

  • È possibile utilizzare la condizione della policy IAM cloudformation:ImportResourceTypes per controllare i tipi di risorse con cui gli utenti possono lavorare durante un’operazione di importazione. Per ulteriori informazioni, consulta Chiavi relative alle condizioni politiche per CloudFormation.

  • Quando si importano le risorse, si applicano i limiti dello stack CloudFormation. Per ulteriori informazioni sui limiti, consulta Comprendere le quote di CloudFormation.

Risorse aggiuntive

Per risolvere la deriva dello stack con l’importazione di risorse, consulta Risoluzione della deviazione con un’operazione di importazione.