安裝或更新 Distributor packages

使用主控台安裝或更新套件一次

1. 在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/。

2. 在導覽窗格中，選擇 Distributor.

3. 在 上 Distributor 首頁，選擇您要安裝的套件。

4. 選擇 Install one time (一次性安裝)。

   此命令會開啟 Run Command 使用 命令文件AWS-ConfigureAWSPackage和您的 Distributor 套件已選取。

5. 對於 Document version (文件版本)，選取您要執行的 AWS-ConfigureAWSPackage 文件的版本。

6. 針對 Action (動作)，選擇 Install (安裝)。

7. 對於 Installation type (安裝類型)，選擇以下其中一項：

   • Uninstall and reinstall (解除安裝並重新安裝)：套件會完全解除安裝，然後重新安裝。在重新安裝完成之前，應用程式無法使用。

   • In-place update (就地更新)：根據您在 update 指令碼中提供的指示，只將新的或變更的檔案新增至現有的安裝。應用程式在整個更新程序中仍然可用。除了套件之外，已 AWS 發佈的AWSEC2Launch-Agent套件不支援此選項。

8. 對於 Name (名稱)，確認已輸入您所選套件的名稱。

9. (選用) 對於 Version (版本)，輸入套件的版本名稱值。如果您將此欄位保留空白，Run Command 安裝您在 中選取的預設版本 Distributor.

10. 在 Targets (目標) 區段中，透過手動指定標籤、選取執行個體或裝置，或指定資源群組，選擇您要執行這項操作的受管節點。

    注意

    如果在清單中沒看到受管節點，則請參閱 疑難排解受管節點的可用性。

11. 對於 Other parameters (其他參數)：

    • 在 Comment (註解) 中，輸入此命令的相關資訊。

    • 在 Timeout (seconds) (逾時 (秒)) 中，指定在命令執行全面失敗之前，系統要等候的秒數。

12. 對於 Rate Control (速率控制)：

    • 在 Concurrency (並行) 中，指定可同時執行命令的節點數目或百分比。

      注意

      如果透過指定標籤或資源群組選取了目標，且您不確定會以多少個受管節點為目標，則透過指定百分比限制可以同時執行文件之目標的數量。

    • 在 Error threshold (錯誤閾值) 中，指定在特定數目或百分比之受管節點上的命令失敗之後，停止在其他目標上執行命令。例如，如果您指定三個錯誤，則 Systems Manager 會在收到第四個錯誤時停止傳送命令。仍在處理命令的受管節點也可能會傳送錯誤。

13. (選用) 針對 Output options (輸出選項)，若要將命令輸出儲存至檔案，請選取 Write command output to an S3 bucket (將命令輸出寫入至 S3 儲存貯體) 方塊。在方塊中輸入儲存貯體和字首 (資料夾) 名稱。

    注意

    授予將資料寫入 S3 儲存貯體的 S3 許可是指派給執行個體的執行個體描述檔 （適用於EC2執行個體） IAM或服務角色 （混合式啟用機器），而不是執行此任務IAM的使用者。如需詳細資訊，請參閱設定 Systems Manager 所需的執行個體許可或建立混合環境IAM的服務角色。此外，如果指定的 S3 儲存貯體位於不同的 中 AWS 帳戶，請確定與受管節點相關聯的執行個體設定檔IAM或服務角色具有寫入該儲存貯體的必要許可。

14. 在SNS通知區段中，如果您想要傳送有關命令執行狀態的通知，請選取啟用SNS通知核取方塊。

    如需為 設定 Amazon SNS通知的詳細資訊 Run Command，請參閱使用 Amazon SNS通知監控 Systems Manager 狀態變更。

15. 當您準備好安裝套件時，請選擇 Run (執行)。

16. Command status (命令狀態) 區域會報告執行的進度。如果命令仍在進行中，請選擇主控台左上角的重新整理圖示，直到 Overall status (整體狀態) 或 Detailed status (詳細狀態) 欄顯示 Success (成功) 或 Failed (失敗) 顯示為止。

17. 在 Targets and outputs (目標和輸出) 區域中，選擇受管節點名稱旁邊的按鈕，然後選擇 View output (檢視輸出)。

    此指令輸出頁面會顯示指令執行的結果。

18. (選用) 如果您選擇將命令輸出寫入 Amazon Simple Storage Service (Amazon S3) 儲存貯體，請選擇 Amazon Simple Storage Service (Amazon S3) 以檢視輸出日誌資料。

使用主控台排程套件安裝

1. 在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/。

2. 在導覽窗格中，選擇 Distributor.

3. 在 上 Distributor 首頁，選擇您要安裝或更新的套件。

4. 對於 Package (套件)，選擇 Install on a schedule (依排程安裝)。

   此命令會開啟 State Manager 為您建立的新關聯。

5. 對於 Name (名稱)，輸入名稱 (例如，Deploy-test-agent-package)。此為選用操作，但建議您採用。名稱中不得使用空格。

6. 在 Document (文件) 清單中，已選取文件名稱 AWS-ConfigureAWSPackage。

7. 對於 Action (動作)，請確認已選取 Install (安裝)。

8. 對於 Installation type (安裝類型)，選擇以下其中一項：

   • Uninstall and reinstall (解除安裝並重新安裝)：套件會完全解除安裝，然後重新安裝。在重新安裝完成之前，應用程式無法使用。

   • In-place update (就地更新)：根據您在 update 指令碼中提供的指示，只將新的或變更的檔案新增至現有的安裝。應用程式在整個更新程序中仍然可用。

9. 對於 Name (名稱)，確認已輸入您套件的名稱。

10. 對於 Version (版本)，如果您要安裝最新發佈版本以外的套件版本，請輸入版本識別碼。

11. 對於 Targets (目標)，請選擇 Selecting all managed instances in this account (選擇此帳戶中的所有受管執行個體)、Specifying tags (指定標籤) 或 Manually Selecting Instance (手動選擇執行個體)。如果您選擇使用標籤來指向資源，請在提供的欄位中輸入標籤索引鍵和標籤值。

    注意

    您可以選擇選取此帳戶中的所有受管執行個體或手動選取執行個體 ，以選擇受管 AWS IoT Greengrass 核心裝置。

12. 對於 Specify schedule (指定排程)，請選擇 On Schedule (依排程) 定期執行關聯，或 No Schedule (不排程) 來執行關聯一次。如需關於這些選項的詳細資訊，請參閱 在 Systems Manager 中使用關聯。使用控制項來建立 cron 或關聯速率排程。

13. 選擇 Create Association (建立關聯)。

14. 在 Association (關聯) 頁面上，選擇您建立的關聯旁邊的按鈕，然後選擇 Apply association now (立即套用關聯)。

    State Manager 會在指定的目標上建立並立即執行關聯。如需執行關聯結果的詳細資訊，請參閱此指南中的在 Systems Manager 中使用關聯。

使用 安裝套件一次 AWS CLI

• 在 AWS CLI中執行以下命令。

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  注意

  installationType 的預設行為是 Uninstall and reinstall。當您安裝完整套件時，您可以在此命令中忽略 "installationType":["Uninstall and reinstall"]。

  以下是範例。

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-00000000000000" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'

若要使用 更新套件一次 AWS CLI

• 在 AWS CLI中執行以下命令。

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  注意

  當您新增新的或變更的檔案時，必須在命令中包含 "installationType":["In-place update"]。

  以下是範例。

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-02573cafcfEXAMPLE" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'