步驟 1：入門步驟 2：執行 Shell 指令碼以檢視資源詳細資訊步驟 3：使用 AWS-RunShellScript 文件發送簡單的命令步驟 4：使用 Run Command 執行一個簡單的 Python 指令碼步驟 5：使用 Run Command 執行 Bash 指令碼

逐步解說：使用 AWS CLI 與 Run Command

以下範例演練說明如何使用 AWS Command Line Interface (AWS CLI) 來檢視命令和命令參數，如何執行命令，以及如何查看這些命令狀態的相關資訊。

重要

只有信任管理員應受允許使用在這個主題中顯示的 AWS Systems Manager 預先設定的文件。Systems Manager 文件中指定的命令或指令碼會使用在您的受管節點上的管理許可執行。如果使用者具備執行任何預先定義的 Systems Manager 文件 (任何以 AWS- 為開頭的文件) 的許可，則該使用者還具有該節點的管理員存取權。對於所有其他使用者，您應該建立嚴格的文件和並將它們分享給特定使用者。

步驟 1：入門

您必須在您想要設定的受管節點上具有管理員許可，或已在 AWS Identity and Access Management (IAM) 中被授予適當的許可。另請注意，此範例使用美國東部 (俄亥俄) 區域 (us-east-2)。Run Command 在《Amazon Web Services 一般參考》的 Systems Manager 服務端點一節所列的 AWS 區域中可用。如需更多詳細資訊，請參閱設定 AWS Systems Manager。

使用 AWS CLI 執行命令

如果您尚未安裝並設定 AWS Command Line Interface (AWS CLI)，請進行相應的操作。

如需相關資訊，請參閱安裝或更新最新版本的 AWS CLI。
列出所有可用的文件。

此命令會列出根據 IAM 許可適用於您帳戶的所有文件。
```
aws ssm list-documents
```

確定受管節點已準備好接收命令。

以下命令的輸出會顯示受管節點是否上線。

使用下列命令來檢視特定受管節點的詳細資訊。

注意
若要在此演練中執行命令，請替換執行個體和命令 ID。適用於受管 AWS IoT Greengrass 核心裝置，請使用適用於執行個體 ID 的 mi-ID_number。會將命令 ID 傳回做為 send-command 的回應。來自 Fleet Manager (AWS Systems Manager 的功能) 的執行個體 ID 可用。
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
```

步驟 2：執行 Shell 指令碼以檢視資源詳細資訊

您可以使用 Run Command 和 AWS-RunShellScript 文件，在受管節點上執行任何命令或指令碼，如同您在本機登入一樣。

View the description and available parameters (查看描述和可用參數)

請執行下列命令以檢視 Systems Manager JSON 文件的說明。

執行下列命令來檢視可用的參數和這些參數的詳細資訊。

步驟 3：使用 `AWS-RunShellScript` 文件發送簡單的命令

若要取得 Linux 受管節點的 IP 資訊，請執行以下命令。

如果您正在鎖定 Windows Server 受管節點，請變更 document-name 至 AWS-RunPowerShellScript，然後將 command 從 ifconfig 變更至 ipconfig。

取得命令資訊與回應資料

以下命令使用從之前命令傳回的命令 ID，以取得命令執行的詳細資訊和回應資料。如果命令完成，系統會傳回回應資料。如果命令執行顯示 "Pending" 或 "InProgress"，您可再次執行此命令，以查看回應資料。

識別使用者

以下命令會顯示執行命令的預設使用者。

取得命令狀態

以下命令使用命令 ID，以取得在受管節點上命令執行的狀態。此範例使用在之前命令傳回的命令 ID。

取得命令詳細資訊

以下命令使用來自先前命令的命令 ID，以取得每個受管節點命令執行的狀態。

使用特定受管節點的回應資料來取得命令資訊

下列命令會傳回特定受管節點的原始 aws ssm send-command 請求輸出。

顯示 Python 版本

以下命令會傳回在節點上執行的 Python 版本。

步驟 4：使用 Run Command 執行一個簡單的 Python 指令碼

下面的命令會使用 Run Command 執行一個簡單的 Python "Hello World" 指令碼。

步驟 5：使用 Run Command 執行 Bash 指令碼

本節中的範例演示了如何使用 Run Command 執行以下 Bash 指令碼。

如需使用 Run Command 執行存放在遠端位置之指令碼的範例，請參閱從 Amazon Simple Storage Service (Amazon S3) 執行指令碼和從 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

此指令碼會在 Amazon Linux and Red Hat Enterprise Linux (RHEL) 執行個體上安裝 AWS CodeDeploy 代理程式，如《AWS CodeDeploy 使用者指南》中的為 CodeDeploy 建立 Amazon EC2 執行個體。

此指令碼會安裝來自美國東部 (俄亥俄) 區域 (us-east-2) aws-codedeploy-us-east-2 中 AWS 受管 S3 儲存貯體的 CodeDeploy 代理程式。

執行 AWS CLI 命令中的 Bash 指令碼

下列範例示範如何使用 --parameters 選項在 CLI 命令中包含 Bash 指令碼。

在 JSON 檔案中執行 Bash 指令碼

在下列範例中，Bash 指令碼的內容會存放在 JSON 檔案中，而且檔案會使用 --cli-input-json 選項包含在命令中。

參考 installCodeDeployAgent.json 檔案的內容如以下範例所示。


{
    "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"
        ]
    }
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用 Run Command 更新軟體

使用 Tools for Windows PowerShell