Membawa sumber daya yang ada ke dalam CloudFormation manajemen

AWS CloudFormation menawarkan kemampuan yang memungkinkan Anda mengimpor AWS sumber daya yang ada ke tumpukan baru atau yang sudah ada dengan menjelaskannya di template Anda. Fitur ini berguna jika Anda ingin mulai menggunakan CloudFormation untuk mengelola sumber daya yang dibuat di luar CloudFormation, tanpa harus menghapus dan membuatnya kembali.

CloudFormation mendukung impor berbagai sumber daya. Untuk informasi selengkapnya, lihat Dukungan jenis sumber daya.

catatan

Untuk memindai sumber daya yang ada dan secara otomatis membuat templat yang dapat Anda gunakan untuk mengimpor sumber daya yang ada ke CloudFormation atau mereplikasi sumber daya di akun baru, lihatMenghasilkan template untuk sumber daya yang ada.

Topik

• Gambaran Umum
• Validasi
• Kode status
• Pertimbangan
• Sumber daya tambahan
• Membuat tumpukan dari sumber daya yang ada
• Mengimpor sumber daya yang ada ke dalam tumpukan
• Pengembalian operasi impor

Gambaran umum impor sumber daya

Selama operasi impor, Anda membuat perubahan set yang mengimpor sumber daya yang ada ke tumpukan atau membuat tumpukan baru dari sumber daya yang ada. Anda memberikan hal berikut selama impor.

• Templat yang menggambarkan seluruh tumpukan, termasuk sumber daya tumpukan asli dan sumber daya yang Anda impor. Setiap sumber daya yang akan diimpor harus memiliki fileDeletionPolicyatribut.

• Pengenal sumber daya untuk diimpor. Anda memberikan dua nilai untuk mengidentifikasi setiap sumber daya target.

  • Properti pengenal. Ini adalah properti sumber daya yang dapat digunakan untuk mengidentifikasi setiap jenis sumber daya. Misalnya, AWS::S3::Bucket sumber daya dapat diidentifikasi menggunakan BucketName.

  • Nilai pengenal. Ini adalah nilai properti aktual sumber daya target ini. Misalnya, nilai aktual untuk BucketName properti mungkin MyS3Bucket.

catatan

AWS CloudFormation hanya mendukung satu tingkat penggunaan resource import bersarang. Ini berarti Anda tidak dapat mengimpor tumpukan ke tumpukan anak atau mengimpor tumpukan yang memiliki anak.

Validasi impor sumber daya

Selama operasi impor, CloudFormation melakukan validasi berikut.

• Terdapat sumber daya untuk diimpor.

• Nilai properti dan konfigurasi untuk setiap sumber daya yang diimpor akan mematuhi skema jenis sumber daya, yang mendefinisikan properti yang diterima, properti yang diperlukan, dan nilai-nilai properti yang didukung.

• Properti yang dibutuhkan ditentukan dalam templat. Properti yang diperlukan untuk setiap jenis sumber daya tercantum dalamAWS referensi jenis sumber daya dan properti.

• Sumber daya yang akan diimpor bukan milik tumpukan lain di Wilayah yang sama.

CloudFormation tidak memeriksa apakah konfigurasi template cocok dengan konfigurasi properti sumber daya yang sebenarnya.

penting

Verifikasi bahwa sumber daya dan propertinya yang ditentukan dalam templat cocok dengan konfigurasi impor sumber daya yang dimaksudkan untuk menghindari perubahan yang tidak terduga.

Kode status impor sumber daya

Tabel ini menjelaskan berbagai jenis status yang digunakan dengan resource import.

Impor status operasi	Deskripsi
IMPORT_IN_PROGRESS	Operasi impor sedang berlangsung.
IMPORT_COMPLETE	Operasi impor selesai untuk semua sumber daya di tumpukan.
IMPORT_ROLLBACK_IN_PROGRESS	Operasi impor rollback memutar kembali konfigurasi template sebelumnya.
IMPORT_ROLLBACK_FAILED	Operasi rollback impor gagal.
IMPORT_ROLLBACK_COMPLETE	Impor digulung kembali ke konfigurasi template sebelumnya.

Pertimbangan selama operasi impor

• Setelah impor selesai dan sebelum melakukan operasi tumpukan berikutnya, kami sarankan untuk menjalankan deteksi drift pada sumber daya impor. Deteksi drift memastikan bahwa konfigurasi templat cocok dengan konfigurasi yang sebenarnya. Untuk informasi selengkapnya, lihat Mendeteksi penyimpangan di seluruh tumpukan CloudFormation .

• Operasi impor tidak mengizinkan pembuata sumber daya baru, penghapusan sumber daya, atau perubahan pada konfigurasi properti.

• Setiap sumber daya yang diimpor harus memiliki DeletionPolicy atribut untuk operasi impor supaya berhasil. Parameter DeletionPolicy dapat diatur untuk setiap nilai yang memungkinkan. Hanya target sumber daya yang membutuhkan DeletionPolicy. Sumber daya yang sudah menjadi bagian dari tumpukan tidak memerlukan DeletionPolicy.

• Anda tidak dapat mengimpor sumber daya yang sama ke beberapa tumpukan.

• Anda dapat menggunakan kondisi kebijakan cloudformation:ImportResourceTypes IAM untuk mengontrol jenis sumber daya yang dapat digunakan pengguna selama operasi impor. Untuk informasi selengkapnya, lihat AWS CloudFormation kondisi.

• Batas AWS CloudFormation tumpukan berlaku saat mengimpor sumber daya. Untuk informasi lebih lanjut tentang batasan, lihatAWS CloudFormation kuota.

Sumber daya tambahan

Untuk petunjuk pengimporan tambahan yang berfokus pada skenario pemfaktoran ulang tumpukan yang ada, lihat topik berikut:

• Untuk memindahkan sumber daya antar tumpukan, lihatMemindahkan sumber daya antar tumpukan.

• Untuk membuat sarang tumpukan yang ada di dalam tumpukan lain yang ada, lihatMembuat nest tumpukan yang ada.