Buat snapshot VSS dengan dokumen perintah AWS Systems Manager - Amazon Elastic Compute Cloud

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

Buat snapshot VSS dengan dokumen perintah AWS Systems Manager

Anda dapat menggunakan dokumen perintah AWS Systems Manager untuk membuat snapshot dengan VSS aktif. Konten berikut memperkenalkan dokumen perintah yang tersedia, dan parameter runtime yang digunakan dokumen tersebut untuk membuat snapshot Anda.

Sebelum Anda menggunakan salah satu dokumen perintah Systems Manager, pastikan bahwa Anda telah memenuhi semua Prasyarat.

Parameter untuk dokumen snapshot VSS Systems Manager

Dokumen Systems Manager yang membuat snapshot VSS semuanya menggunakan parameter berikut, kecuali jika diberi catatan:

ExcludeBootVolume(string, opsional)

Pengaturan ini mengecualikan volume boot dari proses pencadangan jika Anda membuat snapshot. Untuk mengecualikan volume boot dari snapshot Anda, atur ExcludeBootVolumekeTrue, dan CreateAmikeFalse.

Jika Anda membuat AMI untuk cadangan Anda, parameter ini harus diatur ke False. Nilai default untuk parameter ini adalah False.

NoWriters(string, opsional)

Untuk mengecualikan penulis VSS aplikasi dari proses snapshot, atur parameter ini ke True. Ini dapat membantu Anda mengatasi konflik dengan komponen cadangan VSS pihak ketiga. Nilai default untuk parameter ini adalah False.

CopyOnly(string, opsional)

Jika Anda menggunakan cadangan SQL Server native selain VSS AWS , melakukan pencadangan hanya-salin akan mencegah VSS AWS memutus rantai cadangan diferensial native. Untuk melakukan operasi pencadangan hanya-salin, atur parameter ini ke True.

Nilai default untuk parameter ini adalah False, yang menyebabkan VSS AWS melakukan operasi pencadangan penuh.

CreateAmi(string, opsional)

Untuk membuat Amazon Machine Image (AMI) yang didukung VSS untuk mencadangkan instans Anda, atur parameter ini ke True. Nilai default untuk parameter ini adalah False, yang mencadangkan instans Anda dengan snapshot EBS sebagai gantinya.

Untuk informasi selengkapnya tentang cara membuat AMI dari suatu instans, lihat Membuat AMI Windows dari instans yang berjalan.

AmiName(string, opsional)

Jika CreateAmiopsi diaturTrue, tentukan nama AMI yang dibuat cadangan.

description (string, opsional)

Tentukan deskripsi untuk snapshot atau gambar yang dibuat proses ini.

tanda (string, opsional)

Tentukan kunci dan nilai untuk tanda yang ingin Anda terapkan pada snapshot atau gambar apa pun yang dibuat proses ini. Tanda dapat membantu Anda menemukan, mengelola, dan memulihkan volume dari daftar snapshot. Secara default, sistem mengisi parameter tanda dengan kunci Name. Untuk nilai kunci ini, tentukan nama yang ingin Anda terapkan pada snapshot yang dibuat oleh proses ini.

Jika Anda ingin menentukan tanda tambahan, pisahkan tanda dengan menggunakan titik koma. Misalnya, Key=Environment, Value=Test; Key=User, Value= 1. TestUser

Kami menyarankan Anda menandai snapshot dan gambar Anda. Secara default, snapshot dan gambar ditandai dengan ID perangkat dan tanda AppConsistent untuk menunjukkan keberhasilan pembuatan AMI atau snapshot EBS yang didukung VSS yang konsisten dengan aplikasi.

executionTimeout (string, opsional)

Tentukan waktu maksimum dalam hitungan detik untuk menjalankan proses pembuatan snapshot pada instans, atau untuk membuat AMI dari instans. Meningkatkan batas waktu ini memungkinkan perintah menunggu lebih lama hingga VSS memulai pembekuan dan melengkapi penandaan sumber daya yang dibuatnya. Batas waktu ini hanya berlaku untuk langkah pembuatan snapshot atau AMI. Langkah awal untuk menginstal atau memperbarui paket AwsVssComponents tidak termasuk dalam batas waktu.

CollectDiagnosticLogs(string, opsional)

Untuk mengumpulkan informasi selengkapnya selama langkah pembuatan snapshot dan AMI, atur parameter ini ke True. Nilai default untuk parameter ini adalah False.

VssVersion(string, opsional)

Khusus untuk dokumen AWSEC2-VssInstallAndSnapshot, Anda dapat menentukan parameter VssVersion guna menginstal versi paket AwsVssComponents tertentu pada instans. Biarkan parameter ini kosong untuk menginstal versi default yang direkomendasikan.

Jika versi paket AwsVssComponents yang ditentukan sudah diinstal, skrip melewatkan langkah penginstalan dan melanjutkan ke langkah pencadangan. Untuk daftar versi AwsVssComponents paket dan dukungan operasi, lihat Riwayat versi solusi AWS VSS.

Jalankan dokumen perintah snapshot VSS Systems Manager

Anda dapat membuat snapshot EBS dengan VSS aktif menggunakan dokumen perintah AWS Systems Manager sebagai berikut.

Saat Anda menggunakan AWS Systems Manager untuk menjalankan dokumen AWSEC2-VssInstallAndSnapshot, skrip menjalankan langkah-langkah berikut.

  1. Skrip terlebih dahulu menginstal atau memperbarui paket AwsVssComponents pada instans Anda, tergantung apakah sudah diinstal.

  2. Skrip membuat snapshot yang konsisten dengan aplikasi setelah langkah pertama selesai.

Untuk menjalankan dokumen AWSEC2-VssInstallAndSnapshot, ikuti langkah-langkah untuk lingkungan pilihan Anda.

Console
Buat snapshot EBS yang didukung VSS dari konsol
  1. Buka konsol AWS Systems Manager di https://console.aws.amazon.com/systems-manager/.

  2. Pilih Jalankan Perintah dari panel navigasi. Ini menunjukkan daftar perintah yang sedang berjalan di akun Anda, jika berlaku.

  3. Pilih Jalankan perintah. Ini membuka daftar dokumen perintah yang dapat Anda akses.

  4. Pilih AWSEC2-VssInstallAndSnapshot dari daftar dokumen perintah. Untuk merampingkan hasil, Anda dapat memasukkan semua atau sebagian dari nama dokumen. Anda juga dapat memfilter berdasarkan pemilik, berdasarkan jenis platform, atau dengan tanda.

    Saat Anda memilih dokumen perintah, detail terisi di bawah daftar.

  5. Pilih Default version at runtime dari daftar Versi dokumen.

  6. Konfigurasikan Parameter perintah untuk menentukan cara AWSEC2-VssInstallAndSnapshot akan menginstal paket AwsVssComponents dan membuat cadangan dengan snapshot VSS atau AMI. Untuk detail parameter, lihat Parameter untuk dokumen snapshot VSS Systems Manager.

  7. Untuk pemilihan target, tentukan tanda atau pilih instans secara manual untuk mengidentifikasi instans untuk menjalankan operasi ini.

    catatan

    Jika Anda memilih instans secara manual, dan instans yang ingin Anda lihat tidak disertakan dalam daftar, lihat Di Mana Instans Saya? untuk kiat pemecahan masalah.

  8. Untuk parameter tambahan guna menentukan perilaku Run Command Systems Manager seperti Kontrol laju, masukkan nilai seperti yang dijelaskan dalam Menjalankan perintah dari konsol.

  9. Pilih Jalankan.

    Jika berhasil, perintah tersebut akan mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah Systems Manager untuk detail tentang alasan pelaksanaan tersebut gagal. Jika perintah berhasil diselesaikan, tetapi pencadangan volume tertentu gagal, Anda dapat memecahkan masalah kegagalan tersebut dalam daftar volume EBS.

AWS CLI

Anda dapat menjalankan perintah berikut di AWS CLI untuk membuat snapshot EBS dengan VSS aktif dan mendapatkan status pembuatan snapshot.

Buat snapshot EBS yang didukung VSS

Jalankan perintah berikut untuk membuat snapshot EBS yang didukung VSS. Untuk membuat snapshot, Anda harus mengidentifikasi instans dengan parameter --instance-ids. Untuk informasi selengkapnya tentang parameter lain yang dapat Anda gunakan, lihat Parameter untuk dokumen snapshot VSS Systems Manager.

aws ssm send-command \ --document-name "AWSEC2-VssInstallAndSnapshot" \ --instance-ids "i-01234567890abcdef" \ --parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'

Jika berhasil, dokumen perintah tersebut mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah untuk detail tentang alasan pelaksanaan tersebut gagal.

Dapatkan status perintah

Untuk mendapatkan status snapshot saat ini, jalankan perintah berikut menggunakan ID perintah yang dikembalikan dari send-command.

aws ssm get-command-invocation --instance-ids "i-01234567890abcdef" \ --command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \ --plugin-name "CreateVssSnapshot"
PowerShell

Jalankan perintah berikut di AWS Tools for Windows PowerShell untuk membuat snapshot EBS yang didukung VSS dan dapatkan status runtime saat ini pembuatan output Anda. Tentukan parameter yang dijelaskan dalam daftar sebelumnya untuk mengubah perilaku proses snapshot.

Buat snapshot EBS berkemampuan VSS dengan Tools untuk Windows PowerShell

Jalankan perintah berikut untuk membuat snapshot EBS yang didukung VSS atau AMI.

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description' ;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
Dapatkan status perintah

Untuk mendapatkan status snapshot saat ini, jalankan perintah berikut menggunakan ID perintah yang dikembalikan dari Send-SSMCommand.

Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"

Jika berhasil, perintah tersebut akan mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah untuk detail tentang alasan pelaksanaan tersebut gagal.

Untuk menjalankan dokumen AWSEC2-CreateVssSnapshot, ikuti langkah-langkah untuk lingkungan pilihan Anda.

Console
Buat snapshot EBS yang didukung VSS dari konsol
  1. Buka konsol AWS Systems Manager di https://console.aws.amazon.com/systems-manager/.

  2. Pilih Jalankan Perintah dari panel navigasi. Ini menunjukkan daftar perintah yang sedang berjalan di akun Anda, jika berlaku.

  3. Pilih Jalankan perintah. Ini membuka daftar dokumen perintah yang dapat Anda akses.

  4. Pilih AWSEC2-CreateVssSnapshot dari daftar dokumen perintah. Untuk merampingkan hasil, Anda dapat memasukkan semua atau sebagian dari nama dokumen. Anda juga dapat memfilter berdasarkan pemilik, berdasarkan jenis platform, atau dengan tanda.

    Saat Anda memilih dokumen perintah, detail terisi di bawah daftar.

  5. Pilih Default version at runtime dari daftar Versi dokumen.

  6. Konfigurasikan Parameter perintah untuk menentukan cara AWSEC2-CreateVssSnapshot akan mencadangkan dengan snapshot VSS atau AMI. Untuk detail parameter, lihat Parameter untuk dokumen snapshot VSS Systems Manager.

  7. Untuk pemilihan target, tentukan tanda atau pilih instans secara manual untuk mengidentifikasi instans untuk menjalankan operasi ini.

    catatan

    Jika Anda memilih instans secara manual, dan instans yang ingin Anda lihat tidak disertakan dalam daftar, lihat Di Mana Instans Saya? untuk kiat pemecahan masalah.

  8. Untuk parameter tambahan guna menentukan perilaku Run Command Systems Manager seperti Kontrol laju, masukkan nilai seperti yang dijelaskan dalam Menjalankan perintah dari konsol.

  9. Pilih Jalankan.

    Jika berhasil, perintah tersebut akan mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah Systems Manager untuk detail tentang alasan pelaksanaan tersebut gagal. Jika perintah berhasil diselesaikan, tetapi pencadangan volume tertentu gagal, Anda dapat memecahkan masalah kegagalan tersebut dalam daftar volume EBS.

AWS CLI

Anda dapat menjalankan perintah berikut di AWS CLI untuk membuat snapshot EBS dengan VSS aktif.

Buat snapshot EBS yang didukung VSS

Jalankan perintah berikut untuk membuat snapshot EBS yang didukung VSS. Untuk membuat snapshot, Anda harus mengidentifikasi instans dengan parameter --instance-ids. Untuk informasi selengkapnya tentang parameter lain yang dapat Anda gunakan, lihat Parameter untuk dokumen snapshot VSS Systems Manager.

aws ssm send-command \ --document-name "AWSEC2-CreateVssSnapshot" \ --instance-ids "i-01234567890abcdef" \ --parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'

Jika berhasil, dokumen perintah tersebut mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah untuk detail tentang alasan pelaksanaan tersebut gagal.

PowerShell

Jalankan perintah berikut dengan AWS Tools for Windows PowerShell untuk membuat snapshot EBS dengan VSS aktif.

Buat snapshot EBS berkemampuan VSS dengan Tools untuk Windows PowerShell

Jalankan perintah berikut untuk membuat snapshot EBS yang didukung VSS. Untuk membuat snapshot, Anda harus mengidentifikasi instans dengan parameter InstanceId. Anda dapat menentukan lebih dari satu instans untuk membuat snapshot. Untuk informasi selengkapnya tentang parameter lain yang dapat Anda gunakan, lihat Parameter untuk dokumen snapshot VSS Systems Manager.

Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description' ;'tags'='Key=key_name,Value=tag_value'}

Jika berhasil, perintah tersebut akan mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah untuk detail tentang alasan pelaksanaan tersebut gagal. Jika perintah berhasil diselesaikan, tetapi pencadangan volume tertentu gagal, Anda dapat memecahkan masalah kegagalan dalam daftar snapshot EBS.

Anda dapat menggunakan salah satu prosedur baris perintah yang dijelaskan di bagian sebelumnya untuk membuat snapshot yang didukung VSS. Dokumen perintah (AWSEC2-VssInstallAndSnapshot atau AWSEC2-CreateVssSnapshot) harus berjalan pada simpul primer di klaster Anda. Dokumen akan gagal pada simpul sekunder karena tidak memiliki akses ke disk bersama. Jika primer dan sekunder Anda berubah secara dinamis, Anda dapat menjalankan dokumen Run Command AWS Systems Manager pada beberapa simpul dengan harapan bahwa perintah akan berhasil pada simpul primer dan gagal pada simpul sekunder.

Anda dapat menggunakan skrip berikut dan dokumen SSM AWSEC2-ManageVssIO yang ditentukan sebelumnya untuk menghentikan sementara I/O, membuat snapshot EBS yang didukung VSS, dan memulai ulang I/O. Proses ini berjalan dalam konteks pengguna yang menjalankan perintah. Jika pengguna memiliki izin yang memadai untuk membuat dan menandai snapshot, AWS Systems Manager dapat membuat dan menandai snapshot EBS yang didukung VSS tanpa perlu peran snapshot IAM tambahan pada instans tersebut.

Sebaliknya, dokumen perintah (AWSEC2-VssInstallAndSnapshot atau AWSEC2-CreateVssSnapshot) mengharuskan Anda menetapkan peran snapshot IAM ke setiap instans yang ingin Anda buat snapshot EBS. Jika Anda tidak ingin memberikan izin IAM tambahan untuk instans Anda karena alasan kebijakan atau kepatuhan, Anda dapat menggunakan skrip berikut.

Sebelum Anda memulai

Perhatikan detail penting berikut tentang proses ini:

  • Proses ini menggunakan PowerShell script (CreateVssSnapshotAdvancedScript.ps1) untuk mengambil snapshot dari semua volume pada instance yang Anda tentukan, kecuali volume root. Jika Anda perlu mengambil snapshot volume root, Anda harus menggunakan dokumen SSM AWSEC2-CreateVssSnapshot.

  • Skripnya memanggil dokumen AWSEC2-ManageVssIO dua kali. Pertama kali dengan parameter Action diatur ke Freeze, yang menjeda semua I/O pada instans. Kedua kalinya, Action parameter diatur menjadi Thaw, yang memaksa I/O untuk melanjutkan.

  • Jangan mencoba menggunakan AWSEC2-ManageVssIO dokumen tanpa menggunakan CreateVssSnapshotAdvancedScript skrip.ps1. Kerangka VSS Microsoft mensyaratkan bahwa tindakan Freeze dan Thaw dipanggil tidak lebih dari sepuluh detik, dan memanggil tindakan ini secara manual tanpa skrip dapat mengakibatkan kesalahan.

Untuk membuat snapshot EBS yang didukung VSS menggunakan dokumen SSM AWSEC2-ManageVssIO
  1. Unduh CreateVssSnapshotAdvancedScriptfile.zip dan ekstrak konten file.

  2. Buka CreateVssSnapshotAdvancedScript.ps1 di editor teks, edit instans panggilan di bagian bawah skrip dengan ID instans EC2 yang valid, deskripsi snapshot, dan nilai tag yang diinginkan, kemudian jalankan skrip dari PowerShell.

Jika berhasil, perintah tersebut akan mengisi daftar snapshot EBS dengan snapshot baru. Anda dapat menemukan snapshot ini di daftar snapshot EBS dengan mencari tanda yang Anda tentukan, atau dengan mencari AppConsistent. Jika pelaksanaan perintah gagal, lihat output perintah untuk detail tentang alasan pelaksanaan tersebut gagal. Jika perintah berhasil diselesaikan, tetapi pencadangan volume tertentu gagal, Anda dapat memecahkan masalah kegagalan tersebut dalam daftar volume EBS.

catatan

Untuk mengotomatiskan pencadangan, Anda dapat membuat tugas jendela pemeliharaan AWS Systems Manager yang menggunakan dokumen AWSEC2-VssInstallAndSnapshot. Untuk informasi selengkapnya, lihat Bekerja dengan Jendela Pemeliharaan (Konsol) dalam Panduan Pengguna AWS Systems Manager.