View a markdown version of this page

Panduan: Gunakan AWS CLI dengan Run Command - AWS Systems Manager
Langkah 1: MemulaiLangkah 2: Jalankan skrip shell untuk melihat detail sumber dayaLangkah 3: Kirim perintah sederhana menggunakan dokumen AWS-RunShellScriptLangkah 4: Jalankan skrip Python sederhana menggunakan Run CommandLangkah 5: Jalankan skrip Bash menggunakan Run Command

• 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.

Panduan: Gunakan AWS CLI dengan Run Command

Panduan contoh berikut menunjukkan cara menggunakan AWS Command Line Interface (AWS CLI) untuk melihat informasi tentang perintah dan parameter perintah, cara menjalankan perintah, dan cara melihat status perintah tersebut.

penting

Hanya administrator tepercaya yang diizinkan untuk menggunakan dokumen AWS Systems Manager pra-konfigurasi yang ditampilkan dalam topik ini. Perintah atau skrip yang ditentukan dalam dokumen Manajer Sistem berjalan dengan izin administratif pada node terkelola Anda. Jika pengguna memiliki izin untuk menjalankan salah satu dokumen Manajer Sistem yang telah ditentukan sebelumnya (dokumen apa pun yang dimulai denganAWS-), maka pengguna tersebut juga memiliki akses administrator ke node. Untuk semua pengguna lain, Anda harus membuat dokumen yang restriktif dan membagikannya dengan pengguna tertentu.

Langkah 1: Memulai

Anda harus memiliki izin administrator pada node terkelola yang ingin Anda konfigurasikan atau Anda harus diberikan izin yang sesuai di AWS Identity and Access Management (IAM). Perhatikan juga, contoh ini menggunakan Wilayah AS Timur (Ohio) (us-east-2). Run Commandtersedia di titik akhir layanan Manajer Sistem yang Wilayah AWS tercantum di Referensi Umum Amazon Web Services. Untuk informasi selengkapnya, lihat Menyiapkan node terkelola untuk AWS Systems Manager.

Untuk menjalankan perintah menggunakan AWS CLI

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

    Untuk informasi, lihat Menginstal atau memperbarui versi terbaru dari AWS CLI.

  2. Cantumkan semua dokumen yang tersedia.

    Perintah ini mencantumkan semua dokumen yang tersedia untuk akun Anda berdasarkan izin IAM. 

    aws ssm list-documents

  3. Verifikasi bahwa node terkelola siap menerima perintah.

    Output dari perintah berikut menunjukkan jika node yang dikelola online.

    Linux & macOS
    aws ssm describe-instance-information \
    --output text --query "InstanceInformationList[*]"
    Windows
    aws ssm describe-instance-information ^
    --output text --query "InstanceInformationList[*]"

  4. Jalankan perintah berikut untuk melihat detail tentang node terkelola tertentu.

    catatan

    Untuk menjalankan perintah dalam panduan ini, ganti ID instans dan perintah. Untuk perangkat AWS IoT Greengrass inti terkelola, gunakan mi- ID_number misalnya ID. ID perintah dikembalikan sebagai respon terhadap send-command. ID Instance tersedia dariFleet Manager.

    Linux & macOS
    aws ssm describe-instance-information \
    --instance-information-filter-list key=InstanceIds,valueSet=instance-ID
    Windows
    aws ssm describe-instance-information ^
    --instance-information-filter-list key=InstanceIds,valueSet=instance-ID

Langkah 2: Jalankan skrip shell untuk melihat detail sumber daya

Menggunakan Run Command dan AWS-RunShellScript dokumen, Anda dapat menjalankan perintah atau skrip apa pun pada node yang dikelola seolah-olah Anda masuk secara lokal.

Lihat deskripsi dan parameter yang tersedia

Jalankan perintah berikut untuk melihat deskripsi dokumen JSON Systems Manager.

Linux & macOS
aws ssm describe-document \
    --name "AWS-RunShellScript" \
    --query "[Document.Name,Document.Description]"
Windows
aws ssm describe-document ^
    --name "AWS-RunShellScript" ^
    --query "[Document.Name,Document.Description]"

Jalankan perintah berikut untuk melihat parameter yang tersedia dan detail tentang parameter tersebut.

Linux & macOS
aws ssm describe-document \
    --name "AWS-RunShellScript" \
    --query "Document.Parameters[*]"
Windows
aws ssm describe-document ^
    --name "AWS-RunShellScript" ^
    --query "Document.Parameters[*]"

Langkah 3: Kirim perintah sederhana menggunakan dokumen AWS-RunShellScript

Jalankan perintah berikut untuk mendapatkan informasi IP untuk node yang dikelola Linux.

Jika Anda menargetkan Windows Server node terkelola, ubah document-name ke AWS-RunPowerShellScript dan ubah command dari ifconfig keipconfig.

Linux & macOS
aws ssm send-command \
    --instance-ids "instance-ID" \
    --document-name "AWS-RunShellScript" \
    --comment "IP config" \
    --parameters commands=ifconfig \
    --output text
Windows
aws ssm send-command ^
    --instance-ids "instance-ID" ^
    --document-name "AWS-RunShellScript" ^
    --comment "IP config" ^
    --parameters commands=ifconfig ^
    --output text
Dapatkan informasi perintah dengan data respon

Perintah berikut ini menggunakan Command ID yang dikembalikan dari perintah sebelumnya untuk mendapatkan detail dan data respon eksekusi perintah. Sistem mengembalikan data respon jika perintah selesai. Jika eksekusi perintah menunjukkan "Pending" atau "InProgress" Anda menjalankan perintah ini lagi untuk melihat data respon.

Linux & macOS
aws ssm list-command-invocations \
    --command-id $sh-command-id \
    --details
Windows
aws ssm list-command-invocations ^
    --command-id $sh-command-id ^
    --details

Identifikasi pengguna

Perintah berikut menampilkan pengguna default yang menjalankan perintah.

Linux & macOS
sh_command_id=$(aws ssm send-command \
    --instance-ids "instance-ID" \
    --document-name "AWS-RunShellScript" \
    --comment "Demo run shell script on Linux managed node" \
    --parameters commands=whoami \
    --output text \
    --query "Command.CommandId")
Dapatkan status perintah

Perintah berikut menggunakan ID Perintah untuk mendapatkan status eksekusi perintah pada node yang dikelola. Contoh ini menggunakan Command ID yang dikembalikan pada perintah sebelumnya.

Linux & macOS
aws ssm list-commands \
    --command-id "command-ID"
Windows
aws ssm list-commands ^
    --command-id "command-ID"
Dapatkan detail perintah

Perintah berikut menggunakan ID Perintah dari perintah sebelumnya untuk mendapatkan status eksekusi perintah pada basis node yang dikelola.

Linux & macOS
aws ssm list-command-invocations \
    --command-id "command-ID" \
    --details
Windows
aws ssm list-command-invocations ^
    --command-id "command-ID" ^
    --details
Dapatkan informasi perintah dengan data respons untuk node terkelola tertentu

Perintah berikut mengembalikan output dari aws ssm send-command permintaan asli untuk node terkelola tertentu.

Linux & macOS
aws ssm list-command-invocations \
    --instance-id instance-ID \
    --command-id "command-ID" \
    --details
Windows
aws ssm list-command-invocations ^
    --instance-id instance-ID ^
    --command-id "command-ID" ^
    --details

Tampilkan versi Python

Perintah berikut mengembalikan versi Python yang berjalan pada node.

Linux & macOS
sh_command_id=$(aws ssm send-command \
    --instance-ids "instance-ID" \
    --document-name "AWS-RunShellScript" \
    --comment "Demo run shell script on Linux Instances" \
    --parameters commands='python -V' \
    --output text --query "Command.CommandId") \
    sh -c 'aws ssm list-command-invocations \
    --command-id "$sh_command_id" \
    --details \
    --query "CommandInvocations[].CommandPlugins[].{Status:Status,Output:Output}"'

Langkah 4: Jalankan skrip Python sederhana menggunakan Run Command

Perintah berikut menjalankan skrip Python sederhana “Hello World” menggunakanRun Command.

Linux & macOS
sh_command_id=$(aws ssm send-command \
    --instance-ids "instance-ID" \
    --document-name "AWS-RunShellScript" \
    --comment "Demo run shell script on Linux Instances" \
    --parameters '{"commands":["#!/usr/bin/python","print \"Hello World from python\""]}' \
    --output text \
    --query "Command.CommandId") \
    sh -c 'aws ssm list-command-invocations \
    --command-id "$sh_command_id" \
    --details \
    --query "CommandInvocations[].CommandPlugins[].{Status:Status,Output:Output}"'

Langkah 5: Jalankan skrip Bash menggunakan Run Command

Contoh-contoh di bagian ini menunjukkan cara menjalankan skrip bash berikut menggunakanRun Command.

Untuk contoh penggunaan Run Command untuk menjalankan skrip yang disimpan di lokasi terpencil, lihat Menjalankan skrip dari Amazon S3 danMenjalankan skrip dari GitHub.

#!/bin/bash
yum -y update
yum install -y ruby
cd /home/ec2-user
curl -O https://aws-codedeploy-us-east-2.s3.amazonaws.com/latest/install
chmod +x ./install
./install auto

Skrip ini menginstal AWS CodeDeploy agen pada instans Amazon Linux dan Red Hat Enterprise Linux (RHEL), seperti yang dijelaskan dalam Membuat instans Amazon EC2 untuk CodeDeploy di Panduan AWS CodeDeploy Pengguna.

Skrip menginstal CodeDeploy agen dari bucket S3 ter AWS kelola di Wilayah AS Timur (Ohio) (us-east-2),. aws-codedeploy-us-east-2

Jalankan skrip bash dalam perintah AWS CLI

Contoh berikut ini menunjukkan cara menyertakan skrip bash dalam perintah CLI menggunakan opsi --parameters.

Linux & macOS
aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --targets '[{"Key":"InstanceIds","Values":["instance-id"]}]' \
    --parameters '{"commands":["#!/bin/bash","yum -y update","yum install -y ruby","cd /home/ec2-user","curl -O https://aws-codedeploy-us-east-2.s3.amazonaws.com/latest/install","chmod +x ./install","./install auto"]}'

Jalankan skrip bash dalam file JSON

Pada contoh berikut ini, konten dari skrip bash disimpan dalam file JSON, dan file tersebut disertakan dalam perintah menggunakan opsi --cli-input-json.

Linux & macOS
aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --targets "Key=InstanceIds,Values=instance-id" \
    --cli-input-json file://installCodeDeployAgent.json
Windows
aws ssm send-command ^
    --document-name "AWS-RunShellScript" ^
    --targets "Key=InstanceIds,Values=instance-id" ^
    --cli-input-json file://installCodeDeployAgent.json

Konten dari file installCodeDeployAgent.json yang direferensikan ini ditampilkan dalam contoh berikut.

{
    "Parameters": {
        "commands": [
            "#!/bin/bash",
            "yum -y update",
            "yum install -y ruby",
            "cd /home/ec2-user",
            "curl -O https://aws-codedeploy-us-east-2.s3.amazonaws.com/latest/install",
            "chmod +x ./install",
            "./install auto"
        ]
    }
}