Membuat tumpukan dari sumber daya yang ada - AWS CloudFormation
Contoh TemplatBuat tumpukan dari sumber daya yang ada menggunakan Konsol Manajemen AWSBuat tumpukan dari sumber daya yang ada menggunakan AWS CLI

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat tumpukan dari sumber daya yang ada

Topik ini menunjukkan cara membuat tumpukan dari AWS sumber daya yang ada dengan mendeskripsikannya dalam templat. 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, lihatHasilkan templat dari sumber daya yang ada dengan generator IAc.

Prasyarat

Sebelum memulai, Anda harus memiliki hal-hal berikut:

  • Template yang menjelaskan semua sumber daya yang Anda inginkan di tumpukan baru. Simpan template secara lokal atau di bucket Amazon S3.

  • Untuk setiap sumber daya yang ingin Anda impor, sertakan yang berikut ini:

Contoh Templat

Dalam panduan ini, kami menganggap Anda menggunakan contoh template berikut, yang disebutTemplateToImport.json, yang menentukan dua tabel DynamoDB yang dibuat di luar. CloudFormation ServiceTabledan GamesTable merupakan target impor.

catatan

Template ini dimaksudkan sebagai contoh saja. Untuk menggunakannya untuk tujuan pengujian Anda sendiri, ganti sumber daya sampel dengan sumber daya dari akun Anda. 

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Import test",
    "Resources": {
        "ServiceTable": {
            "Type": "AWS::DynamoDB::Table",
            "DeletionPolicy": "Retain",
            "Properties": {
                "TableName": "Service",
                "AttributeDefinitions": [
                    {
                        "AttributeName": "key",
                        "AttributeType": "S"
                    }
                ],
                "KeySchema": [
                    {
                        "AttributeName": "key",
                        "KeyType": "HASH"
                    }
                ],
                "ProvisionedThroughput": {
                    "ReadCapacityUnits": 5,
                    "WriteCapacityUnits": 1
                }
            }
        },
        "GamesTable": {
            "Type": "AWS::DynamoDB::Table",
            "DeletionPolicy": "Retain",
            "Properties": {
                "TableName": "Games",
                "AttributeDefinitions": [
                    {
                        "AttributeName": "key",
                        "AttributeType": "S"
                    }
                ],
                "KeySchema": [
                    {
                        "AttributeName": "key",
                        "KeyType": "HASH"
                    }
                ],
                "ProvisionedThroughput": {
                    "ReadCapacityUnits": 5,
                    "WriteCapacityUnits": 1
                }
            }
        }
    }
}

Buat tumpukan dari sumber daya yang ada menggunakan Konsol Manajemen AWS

  1. Masuk ke Konsol Manajemen AWS dan buka CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

  2. Pada halaman Tumpukan, pilih Buat Tumpukan, lalu pilih Dengan sumber daya yang ada (sumber daya impor).

    Buat tumpukan dari pilihan sumber daya yang ada dalam konsol.

  3. Baca halaman Gambaran Umum Impor untuk daftar hal yang harus Anda berikan selama operasi ini. Lalu, pilih Selanjutnya.

  4. Di halaman Tentukan templat, berikan templat Anda menggunakan salah satu metode berikut, lalu pilih Selanjutnya.

    • Pilih URL Amazon S3, lalu tentukan URL untuk templat Anda di kotak teks.

    • Pilih Unggah file templat, lalu telusuri templat Anda.

  5. Di halaman Identifikasi sumber daya, identifikasi setiap sumber daya target. Untuk informasi selengkapnya, lihat Pengidentifikasi sumber daya.

    1. Di bawah Properti pengidentifikasi, pilih jenis pengidentifikasi sumber daya. Misalnya, sumber daya AWS::DynamoDB::Table dapat diidentifikasi menggunakan TableName properti.

    2. Di bawah Nilai pengidentifikasi, ketikkan nilai properti yang sebenarnya. Misalnya, TableName untuk GamesTable sumber daya di templat contoh adalah Games.

    3. Pilih Berikutnya.

  6. Di halaman Tentukan detail tumpukan, ubah parameter apa pun, lalu pilih Selanjutnya. Ini secara otomatis membuat set perubahan.

    penting

    Operasi impor gagal jika Anda mengubah parameter yang sudah ada yang memulai operasi membuat, memperbarui, atau menghapus.

  7. Pada stack-name halaman Tinjauan, konfirmasikan bahwa sumber daya yang benar sedang diimpor, lalu pilih Impor sumber daya. Ini secara otomatis mengeksekusi perubahan set yang dibuat pada langkah terakhir.

    Panel Peristiwa halaman Detail tumpukan untuk tampilan tumpukan baru Anda.

    Tab Peristiwa di konsol.

  8. (Opsional) Jalankan deteksi drift pada tumpukan untuk memastikan templat dan konfigurasi sebenarnya cocok dengan sumber daya yang diimpor. Untuk informasi lebih lanjut tentang mendeteksi penyimpangan, lihat. Mendeteksi penyimpangan di seluruh tumpukan CloudFormation

  9. (Opsional) Jika sumber daya yang diimpor tidak cocok dengan konfigurasi templat yang diharapkan, perbaiki konfigurasi templat atau perbarui sumber daya secara langsung. Dalam panduan ini, kita memperbaiki konfigurasi templat untuk mencocokkan konfigurasi yang sebenarnya.

    1. Kembalikan operasi impor untuk sumber daya yang terpengaruh.

    2. Tambahkan target impor ke templat Anda lagi, memastikan bahwa konfigurasi templat cocok dengan konfigurasi yang sebenarnya.

    3. Ulangi langkah 2 - 8 menggunakan template yang dimodifikasi untuk mengimpor sumber daya lagi.

Buat tumpukan dari sumber daya yang ada menggunakan AWS CLI

  1. Untuk mempelajari properti mana yang mengidentifikasi setiap jenis sumber daya dalam template, jalankan get-template-summary perintah, tentukan URL S3 template. Misalnya, sumber daya AWS::DynamoDB::Table dapat diidentifikasi menggunakan TableName properti. Untuk GamesTable sumber daya dalam templat contoh, nilai TableName adalah Games. Anda akan membutuhkan informasi ini di langkah berikutnya.

    aws cloudformation get-template-summary \
    --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json

    Untuk informasi selengkapnya, lihat Pengidentifikasi sumber daya.

  2. Buat daftar sumber daya aktual dari template Anda dan pengenal uniknya dalam format string JSON berikut.

    [{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]

    Atau, Anda dapat menentukan parameter berformat JSON dalam file konfigurasi.

    Misalnya, untuk mengimpor ServiceTable danGamesTable, Anda dapat membuat ResourcesToImport.txt file yang berisi konfigurasi berikut.

    [
   {
      "ResourceType":"AWS::DynamoDB::Table",
      "LogicalResourceId":"GamesTable",
      "ResourceIdentifier":{
         "TableName":"Games"
      }
   },
   {
      "ResourceType":"AWS::DynamoDB::Table",
      "LogicalResourceId":"ServiceTable",
      "ResourceIdentifier":{
         "TableName":"Service"
      }
   }
]

  3. Untuk membuat set perubahan, gunakan create-change-set perintah berikut dan ganti teks placeholder. Untuk --change-set-type opsi, tentukan nilaiIMPORT. Untuk --resources-to-import opsi, ganti string JSON sampel dengan string JSON aktual yang baru saja Anda buat.

    aws cloudformation create-change-set \
    --stack-name TargetStack --change-set-name ImportChangeSet \
    --change-set-type IMPORT \
    --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json \
    --resources-to-import '[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]'
    catatan

    --resources-to-importtidak mendukung YAMAL sebaris. Persyaratan untuk menghindari tanda kutip dalam string JSON bervariasi tergantung pada terminal Anda. Untuk informasi selengkapnya, lihat Menggunakan tanda kutip di dalam string di AWS Command Line Interface Panduan Pengguna.

    Atau, Anda dapat menggunakan URL file sebagai masukan untuk --resources-to-import opsi, seperti yang ditunjukkan pada contoh berikut.

    --resources-to-import file://ResourcesToImport.txt

  4. Tinjau perubahan yang ditetapkan untuk memastikan sumber daya yang benar akan diimpor.

    aws cloudformation describe-change-set \
    --change-set-name ImportChangeSet --stack-name TargetStack

  5. Untuk memulai set perubahan dan mengimpor sumber daya, gunakan execute-change-set perintah berikut dan ganti teks placeholder. Setelah berhasil menyelesaikan operasi (IMPORT_COMPLETE), sumber daya berhasil diimpor.

    aws cloudformation execute-change-set \
    --change-set-name ImportChangeSet --stack-name TargetStack

  6. (Opsional) Jalankan deteksi drift pada IMPORT_COMPLETE tumpukan untuk memastikan templat dan konfigurasi sebenarnya cocok dengan sumber daya yang diimpor. Untuk informasi lebih lanjut tentang mendeteksi penyimpangan, lihat. Mendeteksi penyimpangan di sumber daya tumpukan individu

    1. Jalankan deteksi drift pada tumpukan yang ditentukan.

      aws cloudformation detect-stack-drift --stack-name TargetStack

      Jika berhasil, perintah ini mengembalikan output sampel berikut.

      { "Stack-Drift-Detection-Id" : "624af370-311a-11e8-b6b7-500cexample" }

    2. Lihat kemajuan operasi deteksi drift untuk ID deteksi drift tumpukan yang ditentukan.

      aws cloudformation describe-stack-drift-detection-status \
    --stack-drift-detection-id 624af370-311a-11e8-b6b7-500cexample

    3. Lihat informasi drift untuk sumber daya yang telah diperiksa untuk drift di tumpukan yang ditentukan.

      aws cloudformation describe-stack-resource-drifts --stack-name TargetStack

  7. (Opsional) Jika sumber daya yang diimpor tidak cocok dengan konfigurasi templat yang diharapkan, perbaiki konfigurasi templat atau perbarui sumber daya secara langsung. Dalam panduan ini, kita memperbaiki konfigurasi templat untuk mencocokkan konfigurasi yang sebenarnya.

    1. Kembalikan operasi impor untuk sumber daya yang terpengaruh.

    2. Tambahkan target impor ke templat Anda lagi, memastikan bahwa konfigurasi templat cocok dengan konfigurasi yang sebenarnya.

    3. Ulangi langkah 3 - 6 menggunakan template yang dimodifikasi untuk mengimpor sumber daya lagi.