Walkthrough: Perbarui 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.

Walkthrough: Perbarui secara otomatis SSM Agent dengan AWS CLI

Prosedur berikut memandu Anda melalui proses pembuatan State Manager asosiasi menggunakan AWS Command Line Interface. Asosiasi secara otomatis memperbarui SSM Agent sesuai dengan 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 memiliki setidaknya satu instans Amazon Elastic Compute Cloud (AmazonEC2) yang menjalankan Linux, macOS, atau Windows Server yang dikonfigurasi untuk Systems Manager. Untuk informasi selengkapnya, lihat Menyiapkan AWS Systems Manager.

Jika Anda membuat asosiasi dengan menggunakan salah satu AWS CLI atau AWS Tools for Windows PowerShell, gunakan --Targets parameter untuk menargetkan instance, seperti yang ditunjukkan pada 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 instance 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 instance dengan menentukan instance 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 ke.

    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.