Langkah 1: Memulai Langkah 2: Membuat jendela pemeliharaan Langkah 3: Mendaftarkan target jendela pemeliharaan (AWS CLI)Langkah 4: MendaftarkanRun Command tugas agar jendela pemeliharaan diperbaruiSSM Agent

Panduan: Membuat jendela pemeliharaan untuk memperbaruiSSM Agent (AWS CLI)

Panduan berikut menunjukkan cara menggunakan AWS Command Line Interface (AWS CLI) untuk membuat jendela pemeliharaan AWS Systems Manager. Panduan juga menjelaskan cara mendaftarkan node terkelola Anda sebagai target dan mendaftarkanRun Command tugas Systems Manager untuk memperbaruiSSM Agent.

Sebelum Anda memulai

Sebelum menyelesaikan prosedur berikut, Anda harus memiliki izin administrator pada node yang ingin Anda konfigurasikan atau telah diberi izin yang sesuai diAWS Identity and Access Management (IAM). Sebelum Anda menyelesaikan prosedur berikut, pastikan Anda memiliki setidaknya satu node terkelola untuk Linux atauWindows Server yang dikonfigurasi untuk Systems Manager di lingkungan hibrid dan multicloud. Untuk informasi selengkapnya, lihat Menyiapkan AWS Systems Manager.

Topik

Langkah 1: Memulai
Langkah 2: Membuat jendela pemeliharaan
Langkah 3: Mendaftarkan target jendela pemeliharaan (AWS CLI)
Langkah 4: MendaftarkanRun Command tugas agar jendela pemeliharaan diperbaruiSSM Agent

Langkah 1: Memulai

Untuk menjalankan perintah menggunakan AWS CLI

Instal dan konfigurasikanAWS Command Line Interface (AWS CLI), jika Anda belum melakukannya.

Untuk informasi, lihat Menginstal atau memperbarui versi terbaru dariAWS CLI.
Pastikan node siap untuk didaftarkan sebagai target untuk jendela pemeliharaan.

Jalankan perintah berikut untuk melihat node mana yang online.
```
aws ssm describe-instance-information --query "InstanceInformationList[*]"
```
Jalankan perintah berikut untuk melihat detail tentang node tertentu.
```
aws ssm describe-instance-information --instance-information-filter-list key=InstanceIds,valueSet=instance-id
```

Langkah 2: Membuat jendela pemeliharaan

Gunakan prosedur berikut untuk membuat jendela pemeliharaan dan menentukan pilihan dasarnya, seperti jadwal dan durasi.

Membuat jendela pemeliharaan (AWS CLI)

Buka AWS CLI dan jalankan perintah berikut untuk membuat jendela pemeliharaan yang berjalan setiap minggu pada hari Minggu pukul 02.00, di zona waktu Pasifik Amerika Serikat, dengan satu jam cutoff.
Linux & macOS
```
aws ssm create-maintenance-window \
    --name "My-First-Maintenance-Window" \
    --schedule "cron(0 2 ? * SUN *)" \
    --duration 2 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1 \
    --no-allow-unassociated-targets
```
Windows
```
aws ssm create-maintenance-window ^
    --name "My-First-Maintenance-Window" ^
    --schedule "cron(0 2 ? * SUN *)" ^
    --duration 2 ^
    --schedule-timezone "America/Los_Angeles" ^
    --cutoff 1 ^
    --no-allow-unassociated-targets
```
Untuk informasi lebih lanjut tentang cara membuat ekspresi cron untuk parameter schedule, lihat Referensi: Ekspresi cron dan rate untuk Systems Manager.

Untuk penjelasan tentang cara berbagai pilihan terkait jadwal untuk windows pemeliharaan berkaitan satu sama lain, lihat Penjadwalan jendela pemeliharaan dan pilihan periode aktif.

Untuk informasi lebih lanjut tentang penggunaan pilihan --schedule, lihat Referensi: Ekspresi cron dan rate untuk Systems Manager.

Sistem mengembalikan informasi seperti berikut.
```
{
   "WindowId":"mw-0c50858d01EXAMPLE"
}
```

Untuk mencantumkan ini dan setiap jendela pemeliharaan lainnya yang dibuat di Akun AWS di Wilayah AWS Anda saat ini, jalankan perintah berikut.


aws ssm describe-maintenance-windows

Sistem mengembalikan informasi seperti berikut.

{
    "WindowIdentities": [
        {
            "Cutoff": 1,
            "Name": "My-First-Maintenance-Window",
            "NextExecutionTime": "2019-02-03T02:00-08:00",
            "Enabled": true,
            "WindowId": "mw-0c50858d01EXAMPLE",
            "Duration": 2
        }
    ]
}

Langkah 3: Mendaftarkan target jendela pemeliharaan (AWS CLI)

Gunakan prosedur berikut untuk mendaftarkan target dengan jendela pemeliharaan yang Anda buat di Langkah 2. Dengan mendaftarkan target, Anda menentukan node mana yang diperbarui.

Untuk mendaftarkan target jendela pemeliharaan (AWS CLI)

Jalankan perintah berikut. Ganti setiap contoh placeholder sumber daya dengan informasi Anda sendiri.

Sistem mengembalikan informasi seperti berikut, yang menyertakan ID target jendela pemeliharaan. Salin atau catat nilai WindowTargetId. Anda harus menentukan ID ini di langkah berikutnya untuk mendaftarkan tugas bagi jendela pemeliharaan ini.

{
   "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

Perintah alternatif

Gunakan perintah berikut untuk mendaftarkan beberapa node terkelola.

Gunakan perintah berikut untuk mendaftarkan node dengan menggunakan tag.

Jalankan perintah berikut untuk menampilkan target untuk jendela pemeliharaan.


aws ssm describe-maintenance-window-targets --window-id "mw-0c50858d01EXAMPLE"

Sistem mengembalikan informasi seperti berikut ini.

{
    "Targets": [
        {
            "ResourceType": "INSTANCE",
            "WindowId": "mw-0c50858d01EXAMPLE",
            "Targets": [
                {
                    "Values": [
                        "i-02573cafcfEXAMPLE"
                    ],
                    "Key": "InstanceIds"
                }
            ],
            "WindowTargetId": "e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE"
        },
        {
            "ResourceType": "INSTANCE",
            "WindowId": "mw-0c50858d01EXAMPLE",
            "Targets": [
                {
                    "Values": [
                        "Prod"
                    ],
                    "Key": "tag:Environment"
                },
                {
                    "Values": [
                        "Web"
                    ],
                    "Key": "tag:Role"
                }
            ],
            "WindowTargetId": "e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE"
        }
    ]
}

Langkah 4: MendaftarkanRun Command tugas agar jendela pemeliharaan diperbaruiSSM Agent

Gunakan prosedur berikut untuk mendaftarkanRun Command tugas untuk jendela pemeliharaan yang Anda buat di Langkah 2. Run CommandTugas memperbaruiSSM Agent target terdaftar.

Untuk mendaftarkanRun Command tugas agar jendela pemeliharaan memperbaruiSSM Agent (AWS CLI)

Jalankan perintah berikut untuk mendaftarkanRun Command tugas untuk jendela pemeliharaan menggunakanWindowTargetId nilai di Langkah 3. Ganti setiap contoh placeholder sumber daya dengan informasi Anda sendiri. Pembaruan tugasSSM Agent dengan menggunakanAWS-UpdateSSMAgent dokumen.

catatan

Jika target yang Anda daftarkan pada langkah sebelumnya adalahWindows Server 2012 R2 atau yang lebih lama, Anda harus menggunakan dokumen AWS-UpdateEC2Config.

Sistem mengembalikan informasi seperti berikut.

{
   "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE"
}

Jalankan perintah berikut untuk mencantumkan semua tugas terdaftar untuk jendela pemeliharaan.


aws ssm describe-maintenance-window-tasks --window-id "mw-0c50858d01EXAMPLE"

Sistem mengembalikan informasi seperti berikut ini.

{
    "Tasks": [
        {
            "ServiceRoleArn": "arn:aws:iam::111122223333:role/MW-Role",
            "MaxErrors": "1",
            "TaskArn": "AWS-UpdateSSMAgent",
            "MaxConcurrency": "1",
            "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE",
            "TaskParameters": {},
            "Priority": 10,
            "WindowId": "mw-0c50858d01EXAMPLE",
            "Type": "RUN_COMMAND",
            "Targets": [
                {
                    "Values": [
                        "e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE"
                    ],
                    "Key": "WindowTargetIds"
                }
            ],
            "Name": "UpdateSSMAgent"
        }
    ]
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Panduan jendela pemeliharaan

Buat jendela pemeliharaan untuk memperbarui secara otomatis SSM Agent (konsol)