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에서 SSM Agent는 16.04 AMI의 버전에 따라 Snap 또는 deb 설치 패키지를 사용하여 설치됩니다.

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/amazon-ssm-agent/current/ 디렉터리에 저장됩니다. 이 디렉터리의 구성 파일을 변경하는 경우 /snap 디렉터리에서 /etc/amazon/ssm/ 디렉터리로 이러한 파일을 복사해야 합니다. 로그 및 라이브러리 파일이 변경되지 않았습니다(/var/lib/amazon/ssm, /var/log/amazon/ssm).

Snap candidate 채널 사용

Snap Store의 후보(candidate) 채널에는 최신 버전의 SSM Agent(최신 버그 수정 모두 포함)가 있습니다. 안정적인 채널은 아닙니다. 후보 채널과 안정적인 채널의 차이점에 대해 자세히 알아보려면 https://snapcraft.io/docs/channels의 Risk-levels를 참조하세요.

후보 채널에서 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에서는 Snap만 사용하는 것이 좋습니다. 또한 인스턴스에 에이전트가 단 한 개만 설치되어 실행 중인지 확인하세요. Snap 없이 SSM Agent를 사용하려면 SSM Agent를 제거합니다. 그런 다음 Ubuntu Server 16.04(deb)에서의 SSM Agent 설치 지침을 사용하여 SSM Agent를 Debian 패키지로 설치합니다. 설치하기 전에 Debian 패키지로 관리하려는 패키지 목록과 겹치는 Snap이 설치되어 있지 않은지 확인합니다.

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는 20180627 이상의 식별자를 사용하는 Ubuntu Server 16.04 LTS 64비트(Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0, 25.04 AMIs에 기본적으로 설치됩니다.

   온프레미스 서버에 SSM Agent를 설치해야 하거나 에이전트를 다시 설치해야 하는 경우 다음 스크립트를 사용할 수 있습니다. snap 명령은 Snap 앱 스토어(https://snapcraft.io)에서 에이전트를 자동으로 다운로드하기 때문에 다운로드를 위해 URL을 지정할 필요는 없습니다.

   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