• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola dasbor Amazon CloudWatch mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat dokumentasi CloudWatch Dasbor Amazon.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Dokumen Perintah SSM untuk menambal: AWS-RunPatchBaseline
AWS Systems Manager mendukungAWS-RunPatchBaseline, dokumen Manajer Sistem (dokumen SSM) untukPatch Manager. Dokumen SSM ini melakukan operasi tambalan pada node terkelola untuk pembaruan terkait keamanan dan jenis lainnya. Ketika dokumen dijalankan, ia menggunakan dasar patch yang ditetapkan sebagai "default" untuk suatu jenis sistem operasi jika tidak ada grup patch yang ditentukan. Jika tidak, ia menggunakan dasar patch yang terkait dengan grup patch. Untuk informasi tentang grup patch, lihat Grup patch.
Anda dapat menggunakan AWS-RunPatchBaseline untuk menerapkan patch untuk sistem operasi dan aplikasi. (Pada Windows Server, support aplikasi dibatasi pada pembaruan untuk aplikasi yang dirilis oleh Microsoft.)
Dokumen ini mendukung Linux,macOS, dan node Windows Server terkelola. Dokumen ini akan melakukan tindakan yang sesuai untuk setiap platform.
catatan
Patch Managerjuga mendukung dokumen AWS-ApplyPatchBaseline SSM lama. Namun, dokumen ini mendukung tambalan pada node yang dikelola Windows saja. Kami mendorong Anda untuk menggunakan sebagai AWS-RunPatchBaseline gantinya karena mendukung tambalan di Linux,macOS, dan node terkel Windows Server ola. Versi 2.0.834.0 atau yang lebih baru SSM Agent diperlukan untuk menggunakan dokumen. AWS-RunPatchBaseline
Setiap snapshot khusus untuk grup patch Akun AWS, sistem operasi, dan ID snapshot. Snapshot dikirimkan melalui URL Amazon Simple Storage Service (Amazon S3) yang telah ditandatangani sebelumnya, yang kedaluwarsa 24 jam setelah snapshot dibuat. Namun, setelah URL kedaluwarsa, jika Anda ingin menerapkan konten snapshot yang sama ke node terkelola lainnya, Anda dapat membuat URL Amazon S3 baru yang telah ditandatangani sebelumnya hingga 3 hari setelah snapshot dibuat. Untuk melakukannya, gunakan perintah get-deployable-patch-snapshot-for-instance.
Setelah semua pembaruan yang disetujui dan berlaku telah diinstal, dengan reboot dilakukan seperlunya, informasi kepatuhan patch dihasilkan pada node yang dikelola dan dilaporkan kembali kePatch Manager.
catatan
Jika RebootOption parameter disetel ke NoReboot dalam AWS-RunPatchBaseline dokumen, node yang dikelola tidak di-boot ulang setelah Patch Manager dijalankan. Untuk informasi selengkapnya, lihat Nama parameter: RebootOption.
Untuk informasi tentang melihat data kepatuhan patch, lihat Tentang kepatuhan patch.
Parameter AWS-RunPatchBaseline
AWS-RunPatchBaseline support enam parameter. parameter Operation diperlukan. RebootOptionParam InstallOverrideList eterBaselineOverride,, dan bersifat opsional. Snapshot-IDsecara teknis opsional, tetapi kami menyarankan Anda memberikan nilai khusus untuk itu ketika Anda menjalankan AWS-RunPatchBaseline di luar jendela pemeliharaan. Patch Managerdapat menyediakan nilai kustom secara otomatis ketika dokumen dijalankan sebagai bagian dari operasi jendela pemeliharaan.
Parameter
Nama parameter: Operasi
Penggunaan: Wajib.
Opsi: Scan | Install.
- Pemindaian
-
Saat Anda memilih
Scanopsi,AWS-RunPatchBaselinemenentukan status kepatuhan patch dari node yang dikelola dan melaporkan informasi ini kembali kePatch Manager.Scantidak meminta pembaruan untuk diinstal atau node yang dikelola untuk di-boot ulang. Sebagai gantinya, operasi mengidentifikasi di mana pembaruan hilang yang disetujui dan berlaku untuk node. - Menginstal
-
Saat Anda memilih
Installopsi, mencobaAWS-RunPatchBaselinemenginstal pembaruan yang disetujui dan berlaku yang hilang dari node yang dikelola. Informasi kepatuhan patch yang dihasilkan sebagai bagian operasiInstalltidak mencantumkan pembaruan yang hilang, tetapi mungkin melaporkan pembaruan yang berstatus gagal jika instalasi pembaruan tidak berhasil karena alasan apa pun. Setiap kali pembaruan diinstal pada node terkelola, node di-reboot untuk memastikan pembaruan diinstal dan aktif. (Pengecualian: JikaRebootOptionparameter disetel keNoRebootdalamAWS-RunPatchBaselinedokumen, node yang dikelola tidak di-boot ulang setelah Patch Manager dijalankan. Untuk informasi lebih lanjut, lihatNama parameter: RebootOption.)catatan
Jika patch yang ditentukan oleh aturan dasar diinstal sebelum Patch Manager memperbarui node terkelola, sistem mungkin tidak melakukan reboot seperti yang diharapkan. Ini dapat terjadi ketika patch diinstal secara manual oleh pengguna atau diinstal secara otomatis oleh program lain, seperti
unattended-upgradespaket aktifUbuntu Server.
Nama parameter: AssociationId
Penggunaan: Opsional.
AssociationIdadalah ID dari asosiasi yang ada diState Manager. Ini digunakan oleh Patch Manager untuk menambahkan data kepatuhan ke asosiasi tertentu. Asosiasi ini terkait dengan operasi tambalan yang diatur dalam kebijakan patch di Quick Setup.
catatan
DenganAWS-RunPatchBaseline, jika AssociationId nilai diberikan bersama dengan penggantian dasar kebijakan patch, tambalan dilakukan sebagai PatchPolicy operasi dan ExecutionType nilai yang dilaporkan juga AWS:ComplianceItem dilakukan. PatchPolicy Jika tidak ada AssociationId nilai yang diberikan, tambalan dilakukan sebagai Command operasi dan laporan ExecutionType nilai yang dikirimkan AWS:ComplianceItem juga Command dilakukan.
Jika Anda belum memiliki asosiasi yang ingin Anda gunakan, Anda dapat membuatnya dengan menjalankan create-association perintah.
Nama parameter: ID Snapshot
Penggunaan: Opsional.
Snapshot IDadalah ID unik (GUID) yang digunakan Patch Manager untuk memastikan bahwa satu set node terkelola yang ditambal dalam satu operasi semuanya memiliki set patch yang disetujui yang sama persis. Meskipun parameter didefinisikan sebagai opsional, rekomendasi praktik terbaik kami bergantung pada apakah Anda menjalankan AWS-RunPatchBaseline di jendela pemeliharaan, seperti yang dijelaskan dalam tabel berikut.
| Mode | Praktik terbaik | Detail |
|---|---|---|
Menjalankan AWS-RunPatchBaseline di dalam jendela pemeliharaan |
Jangan berikan ID Snapshot. Patch Managerakan menyediakannya untuk Anda. |
Jika Anda menggunakan jendela pemeliharaan untuk menjalankan Jika Anda menentukan nilai dalam skenario ini, perhatikan bahwa snapshot dari baseline patch mungkin tidak tetap di tempatnya selama lebih dari 3 hari. Setelah itu, snapshot baru akan dihasilkan bahkan jika Anda menentukan ID yang sama setelah snapshot berakhir. |
Menjalankan AWS-RunPatchBaseline di luar jendela pemeliharaan |
Menghasilkan dan menentukan nilai GUID kustom untuk ID Snapshot.¹ |
Jika Anda tidak menggunakan jendela pemeliharaan untuk dijalankan Misalnya, katakanlah Anda menjalankan |
|
¹ Anda dapat menggunakan alat yang mampu menghasilkan GUID untuk menghasilkan nilai untuk parameter ID Snapshot. Misalnya, di PowerShell, Anda dapat menggunakan |
||
Nama parameter: InstallOverrideList
Penggunaan: Opsional.
Dengan menggunakan InstallOverrideList, Anda menentukan URL https atau URL ala jalur Amazon S3 ke daftar patch yang akan diinstal. Daftar instalasi patch ini, yang Anda pertahankan dalam format YAML, menggantikan patch yang ditentukan oleh dasar patch default saat ini. Ini memberi Anda kontrol yang lebih terperinci atas patch mana yang diinstal pada node terkelola Anda.
penting
Nama InstallOverrideList file tidak dapat berisi karakter berikut: backtick (`), tanda kutip tunggal ('), tanda kutip ganda (“), dan tanda dolar ($).
Perilaku operasi tambalan saat menggunakan InstallOverrideList parameter berbeda antara Linux & node terkel macOS ola dan node terkel Windows Server ola. Di Linux &macOS, Patch Manager mencoba menerapkan patch yang disertakan dalam daftar InstallOverrideList patch yang ada di repositori apa pun yang diaktifkan pada node, apakah patch tersebut cocok dengan aturan dasar patch atau tidak. Namun, pada Windows Server node, patch dalam daftar InstallOverrideList patch diterapkan hanya jika mereka juga cocok dengan aturan dasar patch.
Pada Linux & macOS node terkelola, patch yang InstallOverrideList ditentukan di dalam diterapkan hanya sebagai pembaruan untuk paket yang sudah diinstal pada node. Jika patch InstallOverrideList termasuk untuk paket yang saat ini tidak diinstal pada node, patch tersebut tidak diinstal.
Sadarilah bahwa laporan kepatuhan mencerminkan status patch berdasarkan apa yang ditentukan dalam dasar patch, bukan apa yang Anda tentukan dalam daftar patch InstallOverrideList. Dengan kata lain, operasi Pemindaian mengabaikan parameter InstallOverrideList. Hal ini untuk memastikan bahwa laporan kepatuhan secara konsisten mencerminkan keadaan patch berdasarkan kebijakan daripada apa yang disetujui untuk operasi patching tertentu.
catatan
Saat Anda menambal node yang hanya menggunakan IPv6, pastikan URL yang disediakan dapat dijangkau dari node. Jika opsi SSM Agent konfigurasi UseDualStackEndpoint disetel ketrue, maka klien dualstack S3 digunakan ketika URL S3 disediakan. Lihat Tutorial: Menambal server di lingkungan IPv6 saja untuk informasi selengkapnya tentang mengonfigurasi agen untuk menggunakan dualstack.
Untuk penjelasan tentang cara Anda dapat menggunakan parameter InstallOverrideList untuk menerapkan berbagai jenis patch berbeda ke sebuah grup target, pada jadwal jendela pemeliharaan yang berbeda, sembari tetap menggunakan dasar patch tunggal, lihat Contoh skenario untuk menggunakan InstallOverrideList parameter di AWS-RunPatchBaseline atau AWS-RunPatchBaselineAssociation.
Format URL yang valid
catatan
Jika file Anda disimpan dalam bucket yang tersedia secara publik, Anda dapat menentukan format URL https atau URL ala jalur Amazon S3. Jika file Anda disimpan dalam bucket privat, Anda harus menentukan URL ala jalur Amazon S3.
-
format URL https:
https://s3.aws-api-domain/amzn-s3-demo-bucket/my-windows-override-list.yaml -
URL ala jalur Amazon S3:
s3://amzn-s3-demo-bucket/my-windows-override-list.yaml
Format konten YAML yang valid
Format yang Anda gunakan untuk menentukan patch dalam daftar tergantung pada sistem operasi node terkelola Anda. Namun, format yang umum adalah seperti berikut ini:
patches: - id: '{patch-d}' title: '{patch-title}' {additional-fields}:{values}
Meskipun Anda dapat memberikan bidang tambahan dalam file YAML Anda, mereka diabaikan selama operasi patch.
Selain itu, kami merekomendasikan untuk memverifikasi bahwa format file YAML Anda valid sebelum menambahkan atau memperbarui daftar di bucket S3 Anda. Untuk informasi lebih lanjut tentang format YAML, lihat yaml.org
Contoh daftar patch
-
Amazon Linux 2
patches: - id: 'kernel.x86_64' - id: 'bind*.x86_64' title: '39.11.4-26.P2.amzn2.5.2' id: 'glibc*' - id: 'dhclient*' title: '*4.2.5-58.amzn2' - id: 'dhcp*' title: '*4.2.5-77.amzn2' -
Debian Server
patches: - id: 'apparmor.amd64' title: '2.10.95-0ubuntu2.9' - id: 'cryptsetup.amd64' title: '*2:1.6.6-5ubuntu2.1' - id: 'cryptsetup-bin.*' title: '*2:1.6.6-5ubuntu2.1' - id: 'apt.amd64' title: '*1.2.27' - id: 'apt-utils.amd64' title: '*1.2.25' -
macOS
patches: - id: 'XProtectPlistConfigData' - id: 'MRTConfigData.1.61' - id: 'Command Line Tools for Xcode.11.5' - id: 'Gatekeeper Configuration Data' -
Oracle Linux
patches: - id: 'audit-libs.x86_64' title: '*2.8.5-4.el7' - id: 'curl.x86_64' title: '*.el7' - id: 'grub2.x86_64' title: 'grub2.x86_64:1:2.02-0.81.0.1.el7' - id: 'grub2.x86_64' title: 'grub2.x86_64:1:*-0.81.0.1.el7' -
Red Hat Enterprise Linux (RHEL)
patches: - id: 'NetworkManager.x86_64' title: '*1:1.10.2-14.el7_5' - id: 'NetworkManager-*.x86_64' title: '*1:1.10.2-14.el7_5' - id: 'audit.x86_64' title: '*0:2.8.1-3.el7' - id: 'dhclient.x86_64' title: '*.el7_5.1' - id: 'dhcp*.x86_64' title: '*12:5.2.5-68.el7' -
SUSE Linux Enterprise Server (SLES)
patches: - id: 'amazon-ssm-agent.x86_64' - id: 'binutils' title: '*0:2.26.1-9.12.1' - id: 'glibc*.x86_64' title: '*2.19*' - id: 'dhcp*' title: '0:4.3.3-9.1' - id: 'lib*' -
Ubuntu Server
patches: - id: 'apparmor.amd64' title: '2.10.95-0ubuntu2.9' - id: 'cryptsetup.amd64' title: '*2:1.6.6-5ubuntu2.1' - id: 'cryptsetup-bin.*' title: '*2:1.6.6-5ubuntu2.1' - id: 'apt.amd64' title: '*1.2.27' - id: 'apt-utils.amd64' title: '*1.2.25' -
Windows
patches: - id: 'KB4284819' title: '2018-06 Cumulative Update for Windows Server 2016 (1709) for x64-based Systems (KB4284819)' - id: 'KB4284833' - id: 'KB4284835' title: '2018-06 Cumulative Update for Windows Server 2016 (1803) for x64-based Systems (KB4284835)' - id: 'KB4284880' - id: 'KB4338814'
Nama parameter: RebootOption
Penggunaan: Opsional.
Pilihan: RebootIfNeeded | NoReboot
Default: RebootIfNeeded
Awas
Opsi default-nya adalah RebootIfNeeded. Pastikan untuk memilih opsi yang benar untuk kasus penggunaan Anda. Misalnya, jika node terkelola Anda harus segera reboot untuk menyelesaikan proses konfigurasi, pilihRebootIfNeeded. Atau, jika Anda perlu mempertahankan ketersediaan node terkelola hingga waktu reboot yang dijadwalkan, pilihNoReboot.
penting
Kami tidak menyarankan penggunaan Patch Manager untuk menambal instans cluster di Amazon EMR (sebelumnya disebut Amazon Elas MapReduce tic). Secara khusus, jangan pilih RebootIfNeeded opsi untuk RebootOption parameter. (Opsi ini tersedia di dokumen Perintah SSM untuk menambal, AWS-RunPatchBaselineAWS-RunPatchBaselineAssociation, danAWS-RunPatchBaselineWithHooks.)
Perintah yang mendasari untuk menambal menggunakan Patch Manager use yum dan dnf perintah. Oleh karena itu, operasi menghasilkan ketidakcocokan karena bagaimana paket diinstal. Untuk informasi tentang metode pilihan untuk memperbarui perangkat lunak pada cluster Amazon EMR, lihat Menggunakan default AMI untuk Amazon EMR di Panduan Manajemen Amazon EMR.
- RebootIfNeeded
-
Ketika Anda memilih
RebootIfNeededopsi, node terkelola akan di-boot ulang dalam salah satu kasus berikut:-
Patch Managermenginstal satu atau lebih patch.
Patch Managertidak mengevaluasi apakah reboot diperlukan oleh patch. Sistem di-reboot bahkan jika patch tidak memerlukan reboot.
-
Patch Managermendeteksi satu atau lebih patch dengan status
INSTALLED_PENDING_REBOOTselamaInstalloperasi.INSTALLED_PENDING_REBOOTStatus dapat berarti bahwa opsiNoRebootdipilih saat terakhir kaliInstalloperasi dijalankan, atau bahwa patch diinstal di luar Patch Manager sejak terakhir kali node terkelola di-boot ulang.
Mem-boot ulang node terkelola dalam dua kasus ini memastikan bahwa paket yang diperbarui dihapus dari memori dan menjaga perilaku menambal dan reboot tetap konsisten di semua sistem operasi.
-
- NoReboot
-
Ketika Anda memilih
NoRebootopsi, Patch Manager tidak me-reboot node terkelola bahkan jika itu menginstal patch selamaInstalloperasi. Opsi ini berguna jika Anda tahu bahwa node terkelola Anda tidak memerlukan reboot setelah patch diterapkan, atau Anda memiliki aplikasi atau proses yang berjalan pada node yang seharusnya tidak terganggu oleh reboot operasi tambalan. Ini juga berguna ketika Anda ingin lebih banyak kontrol atas waktu reboot node terkelola, seperti dengan menggunakan jendela pemeliharaan.Jika Anda memilih opsi
NoRebootdan sebuah patch diinstal, patch diberikan statusInstalledPendingReboot. Node yang dikelola itu sendiri, bagaimanapun, ditandai sebagaiNon-Compliant. Setelah reboot terjadi danScanoperasi dijalankan, status node terkelola diperbarui keCompliant.penting
NoRebootOpsi ini hanya mencegah restart tingkat sistem operasi. Service-level restart masih dapat terjadi sebagai bagian dari proses tambalan. Misalnya, saat Docker diperbarui, layanan dependen seperti Amazon Elastic Container Service mungkin secara otomatis memulai ulang meskipunNoRebootdiaktifkan. Jika Anda memiliki layanan penting yang tidak boleh terganggu, pertimbangkan tindakan tambahan seperti menghapus instans sementara dari layanan atau menjadwalkan tambalan selama jendela pemeliharaan.
File pelacakan instalasi patch: Untuk melacak instalasi patch, terutama patch yang diinstal sejak reboot sistem terakhir, Manajer Sistem memelihara file pada node yang dikelola.
penting
Jangan menghapus atau memodifikasi file pelacakan. Jika file ini dihapus atau rusak, laporan kepatuhan patch untuk node terkelola tidak akurat. Jika ini terjadi, reboot node dan jalankan operasi patch Scan untuk mengembalikan file.
File pelacakan ini disimpan di lokasi berikut di node terkelola Anda:
-
Sistem operasi Linux:
-
/var/log/amazon/ssm/patch-configuration/patch-states-configuration.json -
/var/log/amazon/ssm/patch-configuration/patch-inventory-from-last-operation.json
-
-
Sistem operasi Windows Server:
-
C:\ProgramData\Amazon\PatchBaselineOperations\State\PatchStatesConfiguration.json -
C:\ProgramData\Amazon\PatchBaselineOperations\State\PatchInventoryFromLastOperation.json
-
Nama parameter: BaselineOverride
Penggunaan: Opsional.
Anda dapat menentukan preferensi patching pada saat runtime menggunakan parameter BaselineOverride. Baseline override ini disimpan sebagai objek JSON dalam bucket S3. Ini memastikan operasi patching menggunakan dasar yang disediakan yang cocok dengan sistem operasi host bukannya menerapkan aturan dari dasar patch default
penting
Nama BaselineOverride file tidak dapat berisi karakter berikut: backtick (`), tanda kutip tunggal ('), tanda kutip ganda (“), dan tanda dolar ($).
Untuk informasi selengkapnya tentang cara menggunakan BaselineOverride parameter, lihat Menggunakan BaselineOverride parameter.
Nama parameter: StepTimeoutSeconds
Penggunaan: Opsional.
Waktu dalam detik—antara 1 dan 36000 detik (10 jam) —untuk menyelesaikan perintah sebelum dianggap gagal.