View a markdown version of this page

AWSPremiumSupport-ResizeNitroInstance - AWS Systems Manager Referensi Buku Runbook Otomasi

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

AWSPremiumSupport-ResizeNitroInstance

Deskripsi

AWSPremiumSupport-ResizeNitroInstanceRunbook ini menyediakan solusi otomatis untuk mengubah ukuran instans Amazon Elastic Compute Cloud (Amazon EC2) yang dibangun di atas Sistem Nitro.

Untuk mengurangi potensi risiko kehilangan data dan downtime, runbook memverifikasi hal-hal berikut:

  • Perilaku berhenti contoh.

  • Jika instans merupakan bagian dari grup Amazon EC2 Auto Scaling, standby dan dalam mode.

  • Status instans dan sewa.

  • Jenis instans yang ingin Anda ubah untuk mendukung jumlah antarmuka jaringan yang saat ini dilampirkan ke instance Anda.

  • Arsitektur prosesor dan jenis virtualisasi untuk tipe instans saat ini dan target adalah sama.

  • Jika instance sedang berjalan, itu melewati semua pemeriksaan status.

  • Jenis instans yang ingin Anda ubah tersedia di Availability Zone yang sama.

Jika Amazon EC2 tidak lulus pemeriksaan status setelah mengubah jenis instans, runbook secara otomatis memutar kembali ke jenis instance sebelumnya.

Secara default, runbook ini tidak akan mengubah jenis instance jika sedang berjalan dan volume penyimpanan instance dilampirkan. Runbook juga tidak akan mengubah jenis instance jika instance adalah bagian dari AWS CloudFormation tumpukan. Jika Anda ingin mengubah salah satu perilaku ini, yes tentukan AllowCloudFormationInstances parameter AllowInstanceStoreInstances dan.

Runbook menyediakan dua cara berbeda untuk menentukan jenis instance yang ingin Anda ubah:

  • Untuk otomatisasi sederhana yang menargetkan satu instance, tentukan jenis instance yang ingin Anda ubah menggunakan parameter. TargetInstanceTypeFromParameter

  • Untuk menjalankan otomatisasi pada skala untuk mengubah jenis instance dari beberapa instance, tentukan jenis instance menggunakan parameter. TargetInstanceTypeFromTagValue Untuk informasi tentang menjalankan otomatisasi dalam skala besar, lihat Menjalankan otomatisasi dalam skala besar.

Jika Anda tidak menentukan nilai untuk salah satu parameter, otomatisasi gagal.

penting

Akses ke AWSPremiumSupport-* runbook memerlukan Business + Support, Enterprise Support, atau Unified Operations Subscription. Untuk informasi selengkapnya, lihat Bandingkan AWS Dukungan Paket.

Pertimbangan-pertimbangan

  • Kami merekomendasikan untuk membuat cadangan instance Anda sebelum menggunakan runbook ini.

  • Untuk informasi tentang kompatibilitas untuk mengubah jenis instance, lihat Kompatibilitas untuk mengubah jenis instance.

  • Jika otomatisasi gagal dan kembali ke jenis instans asli, lihat Memecahkan masalah mengubah jenis instance.

  • Mengubah jenis instance membutuhkan runbook untuk menghentikan instance Anda. Ketika sebuah instance dihentikan, data apa pun yang disimpan dalam memori atau pada volume penyimpanan instance hilang. Juga, setiap IPv4 alamat publik yang ditetapkan secara otomatis akan dirilis. Untuk informasi selengkapnya tentang apa yang terjadi ketika Anda menghentikan sebuah instans, lihat Berhenti dan mulai instance Anda.

  • Dengan menggunakan SkipInstancesWithTagKey parameter, Anda dapat melewati instance yang memiliki kunci tag Amazon EC2 tertentu yang diterapkan.

Jalankan Otomasi ini (konsol)

Jenis dokumen

Otomatisasi

Pemilik

Amazon

Platform

Linux, Windows

Parameter

  • AutomationAssumeRole

    Tipe: String

    Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.

  • Akui

    Tipe: String

    Deskripsi: (Wajib) Enter yes untuk mengetahui bahwa instans Anda akan dihentikan jika sedang berjalan.

  • AllowInstanceStoreInstances

    Tipe: String

    Nilai yang valid: tidak | ya

    Default: no

    Deskripsi: (Opsional) Jika Anda menentukanyes, Anda mengizinkan runbook berjalan pada instance yang memiliki volume penyimpanan instans yang dilampirkan.

  • AllowCloudFormationInstances

    Tipe: String

    Nilai yang valid: tidak | ya

    Default: no

    Deskripsi: (Opsional) Jika Anda menentukanyes, runbook berjalan pada instance yang merupakan bagian dari tumpukan. CloudFormation

  • DryRun

    Tipe: String

    Nilai yang valid: tidak | ya

    Default: no

    Deskripsi: (Opsional) Jika Anda menentukanyes, buku runbook memvalidasi persyaratan pengubahan ukuran tanpa membuat perubahan pada jenis instance.

  • InstanceId

    Tipe: String

    Deskripsi: (Wajib) ID instans Amazon EC2 yang jenisnya ingin Anda ubah.

  • SkipInstancesWithTagKey

    Tipe: String

    Deskripsi: (Opsional) Otomatisasi melewatkan instance target jika kunci tag yang Anda tentukan diterapkan ke instance.

  • SleepTime

    Tipe: String

    Default: 3

    Deskripsi: (Opsional) Jumlah detik runbook ini harus tidur setelah selesai.

  • TagInstance

    Tipe: String

    Deskripsi: (Opsional) Tandai instance dengan kunci dan nilai pilihan Anda menggunakan format berikut:Key=ChangingType,Value=True. Opsi ini memungkinkan Anda untuk melacak instance yang telah ditargetkan oleh runbook ini. Kunci dan nilai tag sensitif huruf besar dan kecil.

  • TargetInstanceTypeFromParameter

    Tipe: String

    Deskripsi: (Opsional) Jenis instans yang ingin Anda ubah instans Anda. Biarkan parameter ini kosong jika Anda ingin menggunakan nilai kunci tag yang disediakan dalam TargetInstanceTypeFromTagValue parameter.

  • TargetInstanceTypeFromTagValue

    Tipe: String

    Deskripsi: (Opsional) Kunci tag diterapkan ke instance target Anda yang nilainya berisi jenis instance yang ingin Anda ubah. Jika Anda menentukan nilai untuk TargetInstanceTypeFromParameter parameter, itu akan mengganti nilai apa pun yang Anda tentukan untuk parameter ini.

Izin IAM yang diperlukan

AutomationAssumeRoleParameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.

  • autoscaling:DescribeAutoScalingInstances

  • cloudformation:DescribeStackResources

  • ssm:GetAutomationExecution

  • ssm:DescribeAutomationExecutions

  • ec2:DescribeInstanceAttribute

  • ec2:DescribeInstances

  • ec2:DescribeInstanceStatus

  • ec2:DescribeInstanceTypeOfferings

  • ec2:DescribeInstanceTypes

  • ec2:DescribeTags

  • ec2:ModifyInstanceAttribute

  • ec2:StartInstances

  • ec2:StopInstances

Langkah Dokumen

  1. aws:assertAwsResourceProperty: Memastikan instans Amazon EC2 tidak ditandai dengan kunci tag sumber daya yang ditentukan dalam parameter. SkipInstancesWithTagKey Jika kunci tag ditemukan diterapkan ke instance, langkah gagal dan otomatisasi berakhir.

  2. aws:assertAwsResourceProperty: Mengonfirmasi status instans Amazon EC2 target adalahrunning,, pendingstopped, atau. stopping Jika tidak, otomatisasi berakhir.

  3. aws:executeAwsApi: Mengumpulkan properti dari instans Amazon EC2.

  4. aws:executeAwsApi: Mengumpulkan detail tentang jenis instans Amazon EC2 saat ini.

  5. aws:branch: Memeriksa apakah jenis instance saat ini dan jenis instance yang ditentukan dalam TargetInstanceTypeFromParameter parameter adalah sama. Jika ya, otomatisasi berakhir.

  6. aws:assertAwsResourceProperty: Memastikan instance berjalan pada Sistem Nitro.

  7. aws:branch: Memastikan jenis volume root instans Amazon EC2 adalah volume Amazon Elastic Block Store (Amazon EBS).

  8. aws:assertAwsResourceProperty: Mengonfirmasi perilaku shutdown instance stop dan tidakterminate.

  9. aws:branch: Memastikan instans Amazon EC2 bukan instance Spot.

  10. aws:branch: Memastikan penyewaan instans Amazon EC2 adalah default dan bukan host khusus, atau instans khusus.

  11. aws:executeScript: Mengonfirmasi hanya ada satu otomatisasi runbook ini yang menargetkan ID instance saat ini. Jika otomatisasi lain sedang berlangsung dengan menargetkan instance yang sama, otomatisasi mengembalikan kesalahan dan berakhir.

  12. aws:branch: Memcabangkan otomatisasi berdasarkan status instans Amazon EC2.

    1. Jika stopped ataustopping, otomatisasi berjalan aws:waitForAwsResourceProperty hingga instans Amazon EC2 dihentikan sepenuhnya.

    2. Jika running ataupending, otomatisasi berjalan aws:waitForAwsResourceProperty hingga instans Amazon EC2 melewati pemeriksaan status.

  13. aws:assertAwsResourceProperty: Mengonfirmasi bahwa instans Amazon EC2 bukan bagian dari grup Auto Scaling dengan memanggil DescribeAutoScalingInstances operasi API. Jika instans merupakan bagian dari grup Auto Scaling, pastikan instans Amazon EC2 dalam mode. standby

  14. aws:branch: Memcabangkan otomatisasi tergantung pada apakah Anda ingin otomatisasi memeriksa apakah instans Amazon EC2 adalah bagian dari tumpukan: CloudFormation

    1. aws:executeScriptMemastikan instans Amazon EC2 bukan bagian dari CloudFormation tumpukan dengan memanggil operasi DescribeStackResources API.

  15. aws:executeAwsApi: Mengembalikan daftar jenis instance dengan tipe arsitektur prosesor yang sama, tipe virtulization, dan yang mendukung jumlah antarmuka jaringan yang saat ini dilampirkan ke instance target.

  16. aws:executeAwsApi: Mendapat nilai tipe instance target dari kunci tag yang ditentukan dalam TargetInstanceTypeFromTagValue parameter.

  17. aws:executeScript: Mengonfirmasi bahwa jenis instance saat ini dan target kompatibel. Memastikan bahwa jenis instance target tersedia di subnet yang sama. Memverifikasi kepala sekolah yang memulai runbook memiliki izin untuk mengubah jenis instance, dan menghentikan dan memulai instance jika sedang berjalan.

  18. aws:branch: Memcabangkan otomatisasi berdasarkan apakah nilai DryRun parameter disetel keyes. Jikayes, otomatisasi berakhir.

  19. aws:branch: Memeriksa apakah jenis instans asli dan target sama. Jika mereka sama, otomatisasi berakhir.

  20. aws:executeAwsApi: Mendapat status instance saat ini.

  21. aws:changeInstanceState: Menghentikan instans Amazon EC2.

  22. aws:changeInstanceState: Memaksa instance untuk berhenti jika macet di stopping negara bagian.

  23. aws:executeAwsApi: Mengubah jenis instance ke tipe instance target.

  24. aws:sleep: Menunggu 3 detik setelah mengubah jenis instance untuk konsistensi akhirnya.

  25. aws:branch: Memcabangkan otomatisasi berdasarkan status instance sebelumnya. Jika yarunning, instance dimulai.

    1. aws:changeInstanceState: Memulai instans Amazon EC2 jika dijalankan sebelum mengubah jenis instans.

    2. aws:waitForAwsResourceProperty: Menunggu instans Amazon EC2 untuk lulus pemeriksaan status. Jika instance tidak lulus pemeriksaan status, instance diubah kembali ke tipe instans aslinya.

      1. aws:changeInstanceState: Menghentikan instans Amazon EC2 sebelum mengubahnya ke jenis instans aslinya.

      2. aws:changeInstanceState: Memaksa instans Amazon EC2 untuk berhenti sebelum mengubahnya ke jenis instans aslinya jika macet dalam status berhenti.

      3. aws:executeAwsApi: Mengubah instans Amazon EC2 ke tipe aslinya.

      4. aws:sleep: Menunggu 3 detik setelah mengubah jenis instance untuk konsistensi akhirnya.

      5. aws:changeInstanceState: Memulai instans Amazon EC2 jika dijalankan sebelum mengubah jenis instans.

      6. aws:waitForAwsResourceProperty: Menunggu instans Amazon EC2 untuk lulus pemeriksaan status.

  26. aws:sleep: Menunggu sebelum mengakhiri runbook.