Panduan: Memperbarui secara otomatis SSM Agent dengan AWS CLI - AWS Systems Manager

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

Panduan: Memperbarui secara otomatis SSM Agent dengan AWS CLI

Prosedur berikut memandu Anda melalui proses pembuatan sebuah State Manager asosiasi menggunakan AWS Command Line Interface. Asosiasi secara otomatis memperbarui SSM Agent sesuai jadwal yang Anda tentukan. Untuk informasi lebih lanjut tentang SSM Agent, lihat Bekerja dengan SSM Agent. Untuk menyesuaikan jadwal pembaruan untuk SSM Agent menggunakan konsol, lihatMemperbarui secara otomatis SSM Agent.

Untuk diberitahu tentang SSM Agent pembaruan, berlangganan SSM AgentHalaman Catatan Rilis di GitHub.

Sebelum Anda mulai

Sebelum Anda menyelesaikan prosedur berikut, verifikasi bahwa Anda setidaknya memiliki satu instans Amazon Elastic Compute Cloud (AmazonEC2) untuk Linux, macOS, atau Windows Server yang dikonfigurasi untuk Systems Manager. Untuk informasi selengkapnya, lihat Menyiapkan node terkelola untuk AWS Systems Manager.

Jika Anda membuat asosiasi dengan menggunakan AWS CLI atau AWS Tools for Windows PowerShell, gunakan --Targets parameter untuk menargetkan instans, seperti yang ditunjukkan dalam contoh berikut. Jangan gunakan --InstanceID parameter. Parameter --InstanceID adalah parameter warisan.

Untuk membuat asosiasi untuk memperbarui secara otomatis SSM Agent

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

    Untuk selengkapnya, lihat Menginstal atau memperbarui versi terbaru AWS CLI.

  2. Jalankan perintah berikut untuk membuat asosiasi dengan menargetkan instans menggunakan tag Amazon Elastic Compute Cloud (AmazonEC2). Ganti masing-masing example resource placeholder dengan informasi Anda sendiri. Parameter Schedule menetapkan jadwal untuk menjalankan asosiasi setiap Minggu pagi pukul 2:00 pagi. (UTC).

    State Manager asosiasi tidak mendukung semua ekspresi cron dan rate. Untuk informasi selengkapnya tentang membuat ekspresi cron dan rate untuk asosiasi, lihat Referensi: Ekspresi cron dan rate untuk Systems Manager.

    Linux & macOS
    aws ssm create-association \
--targets Key=tag:tag_key,Values=tag_value \
--name AWS-UpdateSSMAgent \
--schedule-expression "cron(0 2 ? * SUN *)"
    Windows
    aws ssm create-association ^
--targets Key=tag:tag_key,Values=tag_value ^
--name AWS-UpdateSSMAgent ^
--schedule-expression "cron(0 2 ? * SUN *)"

    Anda dapat menargetkan beberapa instans dengan menentukan instans IDs dalam daftar yang dipisahkan koma.

    Linux & macOS
    aws ssm create-association \
--targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID \
--name AWS-UpdateSSMAgent \
--schedule-expression "cron(0 2 ? * SUN *)"
    Windows
    aws ssm create-association ^
--targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID ^
--name AWS-UpdateSSMAgent ^
--schedule-expression "cron(0 2 ? * SUN *)"

    Anda dapat menentukan versi SSM Agent Anda ingin memperbarui.

    Linux & macOS
    aws ssm create-association \
--targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID \
--name AWS-UpdateSSMAgent \
--schedule-expression "cron(0 2 ? * SUN *)" \
--parameters version=ssm_agent_version_number
    Windows
    aws ssm create-association ^
--targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID ^
--name AWS-UpdateSSMAgent ^
--schedule-expression "cron(0 2 ? * SUN *)" ^
--parameters version=ssm_agent_version_number

    Sistem mengembalikan informasi seperti berikut ini.

    {
    "AssociationDescription": {
        "ScheduleExpression": "cron(0 2 ? * SUN *)",
        "Name": "AWS-UpdateSSMAgent",
        "Overview": {
            "Status": "Pending",
            "DetailedStatus": "Creating"
        },
        "AssociationId": "123..............",
        "DocumentVersion": "$DEFAULT",
        "LastUpdateAssociationDate": 1504034257.98,
        "Date": 1504034257.98,
        "AssociationVersion": "1",
        "Targets": [
            {
                "Values": [
                    "TagValue"
                ],
                "Key": "tag:TagKey"
            }
        ]
    }
}

    Sistem mencoba untuk membuat asosiasi pada instans dan menerapkan status setelah pembuatan. Status asosiasi menunjukkan Pending.

  3. Jalankan perintah berikut untuk menampilkan status terbaru dari asosiasi yang Anda buat. 

    aws ssm list-associations

    Jika instans Anda tidak menjalankan versi terbaru SSM Agent, statusnya menunjukkanFailed. Ketika versi baru SSM Agent diterbitkan, asosiasi secara otomatis menginstal agen baru, dan status ditampilkanSuccess.