View a markdown version of this page

在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 SSM Agent上安裝 - AWS Systems Manager

• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板,就像現在一樣。如需詳細資訊,請參閱 Amazon CloudWatch Dashboard 文件

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 SSM Agent上安裝

開始之前

在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 SSM Agent上安裝 之前,請注意下列事項:

SSM Agent 安裝程式檔案位置

在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上,SSM Agent安裝程式檔案,包括代理程式二進位檔和組態檔案,會存放在下列目錄中:/snap/amazon-ssm-agent/current/。如果您變更此目錄中的任何組態檔案,則必須將這些檔案從 /snap 目錄複製到 /etc/amazon/ssm/ 目錄。日誌和程式庫檔案未變更 (/var/lib/amazon/ssm/var/log/amazon/ssm)。

使用 Snap candidate 管道

Snap 商店中的候選頻道包含最新版本的 SSM Agent (包括所有最新錯誤修正);而不是穩定的頻道。若要進一步了解候選頻道和穩定頻道之間的差異,請參閱風險層級,網址為 https://snapcraft.io/docs/channels

如果您想要追蹤候選頻道的SSM Agent版本資訊,請在 20.04 Ubuntu Server 和 18.04 LTS 64 位元執行個體上執行下列命令。

sudo snap switch --channel=candidate amazon-ssm-agent
18.04 版及較新版本推薦使用的 Snap

在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上,建議您僅使用 Snaps。另外驗證代理程式只有一個執行個體在您的執行個體上安裝和執行。

Maximum timeout exceeded 錯誤訊息

由於 Snap 的已知問題,您可能會看到 snap 命令的 Maximum timeout exceeded 錯誤。如果您收到此錯誤,請一次執行下列一個命令來啟動、停止代理程式和檢查其狀態:

sudo systemctl start snap.amazon-ssm-agent.amazon-ssm-agent.service
sudo systemctl stop snap.amazon-ssm-agent.amazon-ssm-agent.service
sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
在 SSM Agent Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安裝 (使用 Snap 套件)
  1. SSM Agent 根據預設, 會安裝在識別符AMIs為 Ubuntu Server 20180627或更新版本的 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上。

    如果您需要在現場部署伺服器上安裝 SSM Agent 或者如果您需要重新安裝代理程式,您可以使用以下指令碼。您不需要指定 URL 以供下載,因為 snap 命令會自動從 Snap 應用程式商店下載代理程式,網址為 https://snapcraft.io

    sudo snap install amazon-ssm-agent --classic
  2. 執行下列命令來判斷 SSM Agent 是否在執行。

    sudo snap list amazon-ssm-agent
  3. 若之前的命令傳回 amazon-ssm-agent is stoppedinactivedisabled,請執行以下命令,以啟動服務。

    sudo snap start amazon-ssm-agent
  4. 檢查代理程式的狀態。

    sudo snap services amazon-ssm-agent