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

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

후보 채널에서 SSM Agent 버전 정보를 추적하려면 Ubuntu Server 20.04 및 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에서는 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 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 및 25.04에 SSM Agent를 설치하려면(Snap 패키지 포함)

  1. SSM Agent는 20180627 이상의 식별자를 사용하는 Ubuntu Server 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