View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnWindows - 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-ExtendVolumesOnWindows

Deskripsi

AWSPremiumSupport-ExtendVolumesOnWindowsRunbook memperluas volume Amazon Elastic Block Store (Amazon EBS), partisinya, dan sistem file pada instans Amazon Elastic Compute Cloud (Amazon EC2) target.

Pertimbangan penting

  • Dampak Operasi dan Status Volume: Modifikasi volume Amazon EBS terjadi dalam tiga fase:modifying,optimizing, dancompleted. Otomatisasi ini berlanjut dengan ekstensi sistem file ketika volume mencapai status. optimizing Selama optimizing status, Anda mungkin mengalami dampak kinerja sementara dan potensi gangguan tingkat sistem file selama pengubahan ukuran partisi. Anda dapat Memantau kemajuan modifikasi volume Amazon EBS.

  • Biaya dan Batasan: Meningkatkan ukuran volume Amazon EBS akan menghasilkan biaya penyimpanan bulanan yang lebih tinggi. Untuk informasi selengkapnya, lihat Harga Amazon EBS. AMI cadangan dan snapshot terkait yang dibuat oleh runbook ini akan dikenakan biaya tambahan berdasarkan ukuran dan lamanya waktu Anda menyimpannya. Untuk beberapa jenis volume, jika Anda perlu mempertahankan rasio IOPS per GB yang sama setelah ekspansi, Anda mungkin perlu memodifikasi IOPS yang disediakan.

  • Backup and Recovery: Runbook membuat AMI cadangan sebelum membuat perubahan apa pun pada volume. AMI dan snapshot terkait tidak secara otomatis dihapus dari akun Anda. Anda harus menghapus cadangan ini secara manual jika tidak lagi diperlukan. Jika terjadi kegagalan, volume dapat dipulihkan dari snapshot AMI terkait seperti yang dijelaskan dalam Ganti volume Amazon EBS menggunakan snapshot.

Bagaimana cara kerjanya?

Runbook ini melakukan operasi berikut:

  • Memverifikasi bahwa instance target dikelola oleh Systems Manager dan menjalankan Windows Server

  • Memastikan hanya ada satu eksekusi runbook ini yang menargetkan instans Amazon EC2 saat ini

  • Membuat cadangan Amazon Machine Image (AMI) dari instance target

  • Memperluas volume Amazon EBS yang ditentukan untuk ekspansi

  • Memperluas sistem file pada instance target menggunakan perintah PowerShell

penting

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

Jalankan Otomasi ini (konsol)

Izin IAM yang diperlukan

AutomationAssumeRoleParameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

Contoh kebijakan IAM:


 {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:DescribeInstanceInformation",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }

Instruksi

Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi:

  1. Arahkan ke AWSPremiumSupport-ExtendVolumesOnWindowsSystems Manager di bawah Documents.

  2. Pilih Jalankan otomatisasi.

  3. Untuk parameter input, masukkan yang berikut ini:

    • AutomationAssumeRole (Opsional):

      • Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) dari peran 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.

      • Tipe: AWS::IAM::Role::Arn

    • InstanceId (Diperlukan):

      • Deskripsi: (Wajib) ID instans Amazon EC2.

      • Tipe: String

      • Izinkan Pola: ^i-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize (Diperlukan):

      • Deskripsi: (Wajib) Ukuran maksimum (dalam GiB) bahwa volume Amazon EBS akan ditingkatkan.

      • Tipe: String

      • Izinkan Pola: ^[0-9]{1,4}$

    • DiagnosticResults (Diperlukan):

      • Deskripsi: (Wajib) Hasil skrip prechecks dari DiagnoseDiskUsage dokumen, diformat sebagai CSV satu baris. String dimulai dengan EXTEND; diikuti oleh informasi volume yang dipisahkan koma untuk setiap volume, dengan volume dipisahkan oleh titik koma. Informasi setiap volume meliputi: ID Volume, huruf Drive, Perpanjang bendera (1 untuk memperpanjang, 0 untuk dilewati), Ukuran baru dalam GB, AWS wilayah, dan Alasan/Tindakan.

      • Tipe: String

      • Izinkan Pola: ^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$

  4. Pilih Jalankan.

  5. Otomatisasi dimulai.

  6. Dokumen melakukan langkah-langkah berikut:

    • AssertInstanceIsManagedInstance:

      Memverifikasi bahwa instance target dikelola oleh Systems Manager.

    • DescribeInstance:

      Mengambil informasi Platform dari instans Amazon EC2 target.

    • BranchOnPlatform:

      Mengonfirmasi bahwa platform instans Amazon EC2 target adalah Windows Server.

    • CheckConcurrency:

      Memastikan hanya ada satu eksekusi runbook ini yang menargetkan instans Amazon EC2 saat ini.

    • CreateImage:

      Membuat cadangan Amazon Machine Image (AMI) dari instance target.

    • WaitUntilImageReady:

      Menunggu Amazon Machine Image (AMI) untuk menyelesaikan pembuatan dan mencapai available status.

    • Memperpanjang EBSVolume:

      Memperluas volume Amazon EBS dari instans target yang ditentukan untuk ekspansi.

    • DescribeVolumes:

      Menjelaskan volume Amazon EBS dari instans target yang ditentukan untuk ekspansi.

    • ExtendFilesystem:

      Memperluas filesystem dari instance target menggunakan perintah. PowerShell

  7. Setelah selesai, tinjau bagian Output untuk hasil eksekusi yang terperinci.

Referensi

Otomatisasi Systems Manager