Importa AWS risorse in uno CloudFormation stack con un'importazione di risorse - 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à.

Importa AWS risorse in uno CloudFormation stack con un'importazione di risorse

La funzione di importazione delle risorse consente di importare le risorse esistenti AWS risorse in uno CloudFormation stack nuovo o esistente. Questa funzionalità è utile se si desidera iniziare CloudFormation a utilizzare per gestire risorse create all'esterno di CloudFormation, senza doverle eliminare e ricreare.

CloudFormation offre due opzioni per importare risorse esistenti in uno stack:

  • IaC generator è uno strumento che analizza automaticamente le risorse esistenti e genera un CloudFormation modello basato sul loro stato attuale. Questo modello può quindi essere utilizzato per importare tali risorse in uno stack.

  • L'importazione delle risorse è un processo manuale in cui si descrivono le risorse esistenti nel CloudFormation modello e quindi le si importa in uno stack. Questo approccio richiede di specificare manualmente le proprietà e le configurazioni delle risorse nel modello.

Oltre a CloudFormation gestire le risorse esistenti, la funzionalità di importazione delle risorse può essere utile nei seguenti scenari:

  • Spostamento delle risorse tra gli stack: è possibile importare risorse da uno stack all'altro, in modo da riorganizzare l'infrastruttura in base alle esigenze.

  • Annidamento degli stack esistenti: è possibile importare uno stack esistente come stack annidato all'interno di un altro stack, abilitando progetti di infrastruttura modulari e riutilizzabili.

CloudFormation supporta l'importazione di un'ampia gamma di risorse. Per ulteriori informazioni, consulta Supporto per tipi di risorse.

Panoramica

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 unAttributo DeletionPolicy.

  • Identificatori per le risorse che stai importando che CloudFormation possono essere utilizzati per mappare la logica IDs del modello con le risorse esistenti.

Nota

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

Identificatori di risorse

Fornisci due valori per identificare ogni risorsa che stai importando.

  • 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à della risorsa utilizzata per identificare la risorsa che stai importando varia a seconda del tipo di risorsa. Puoi trovare la proprietà della risorsa nella CloudFormation console. Dopo aver creato un modello che include la risorsa da importare, puoi avviare il processo di importazione, in cui troverai le proprietà degli identificatori per le risorse che stai importando. Per alcuni tipi di risorse, potrebbero esserci diversi modi per identificarli ed è possibile selezionare la proprietà da utilizzare negli elenchi a discesa.

    In alternativa, puoi ottenere le proprietà degli identificatori per le risorse che stai importando chiamando il get-template-summaryCLIcomando e specificando l'S3 del modello URL 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 seguenti convalide.

  • 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à obbligatorie per ogni tipo di risorsa sono elencate in. AWS riferimento ai tipi di risorse e proprietà

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

CloudFormation non verifica 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, si consiglia 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 Rileva la deriva su un'intera CloudFormation pila.

  • 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 richiedono unDeletionPolicy. Le risorse che fanno già parte dello stack non richiedono un DeletionPolicy.

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

  • È possibile utilizzare la condizione cloudformation:ImportResourceTypes IAM politica per controllare i tipi di risorse con cui gli utenti possono lavorare durante un'operazione di importazione. Per ulteriori informazioni, consulta CloudFormation condizioni.

  • I limiti CloudFormation dello stack si applicano all'importazione di risorse. Per ulteriori informazioni sui limiti, vedere. Comprendi le CloudFormation quote

Risorse aggiuntive

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