在 Ubuntu Server 16.04 LTS 64 位元 (Snap)、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安裝 SSM Agent - AWS Systems Manager

AWS Systems ManagerChange Manager 不再開放給新客戶。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱AWS Systems ManagerChange Manager可用性變更。

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

在 Ubuntu Server 16.04 LTS 64 位元 (Snap)、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安裝 SSM Agent

開始之前

在 Ubuntu Server 16.04 LTS 64 位元 (Snap)、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安裝 SSM Agent 之前，請注意下列事項：

透過 Snap 或 deb 安裝程式安裝 16.04 版

依 Ubuntu Server 16.04 AMI 的版本而定，在版本 16.04 AMI 上，使用 Snaps 或 deb 安裝套件安裝 SSM Agent。

SSM Agent 安裝程式檔案位置

在 Ubuntu Server 16.04 LTS 64 位元 (Snap)、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上，SSM Agent 安裝程式檔案 (包括 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 版本資訊，請在 Ubuntu Server 20.04、18.04 和 16.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。另外驗證代理程式只有一個執行個體在您的執行個體上安裝和執行。如果您想要在沒有 Snaps 的情況下使用 SSM Agent，請解除安裝 SSM Agent。然後，使用在 Ubuntu Server 16.04 (deb) 上安裝 SSM Agent 的說明，安裝 SSM Agent 作為 debian 套件。在安裝之前，請確定您安裝的任何 Snaps 不會與您想要作為 debian 套件進行管理的套件清單重疊。

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
在 Ubuntu Server 16.04 LTS 64 位元 (Snap)、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 (包含 Snap 套件) 上安裝 SSM Agent

  1. SSM Agent 預設安裝在 Ubuntu Server 16.04 LTS 64 位元 (Snap)、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 AMIs 上，識別碼為 20180627 或以上。

    如果您需要在現場部署伺服器上安裝 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 stopped、inactive 或 disabled，請執行以下命令，以啟動服務。

    sudo snap start amazon-ssm-agent

  4. 檢查代理程式的狀態。

    sudo snap services amazon-ssm-agent