• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.
# Ubuntu Server 인스턴스에 SSM Agent 수동 설치
**중요**
Ubuntu Server의 64비트 버전에 SSM Agent을(를) 설치하기 전에 올바른 설치 도구를 사용 중인지 확인합니다. 20180627로 식별된 Amazon Machine Image(AMI)부터 SSM Agent는 Snap 패키지를 사용하여 버전 16.04에 사전 설치됩니다. 이전 AMI에서 생성된 인스턴스에서는 deb 설치 관리자 패키지를 사용하여 SSM Agent를 설치해야 합니다. 자세한 내용은 [64비트 Ubuntu Server 16.04 인스턴스에 설치할 올바른 SSM Agent 버전 확인](agent-install-ubuntu-about-v16.md) 섹션을 참조하세요.
대부분의 경우 AWS에서 제공하는 Ubuntu Server용 Amazon Machine Images(AMIs)에는 AWS Systems Manager 에이전트(SSM Agent)가 기본적으로 사전 설치되어 있습니다. 자세한 내용은 [SSM Agent가 사전 설치된 상태로 AMIs 검색](ami-preinstalled-agent.md) 섹션을 참조하세요.
SSM Agent가 새 Ubuntu Server 인스턴스에 사전 설치되어 있지 않거나 에이전트를 수동으로 다시 설치해야 하는 경우 이 섹션의 정보를 사용하면 도움이 됩니다.
**시작하기 전 준비 사항**
Ubuntu Server 인스턴스에 SSM Agent를 설치하기 전에 다음 사항에 유의하세요.
+ 모든 Linux 기반 운영 체제에서의 SSM Agent 설치에 적용되는 중요한 정보는 [Linux용 EC2 인스턴스에 수동으로 SSM Agent 설치 및 제거](manually-install-ssm-agent-linux.md)의 내용을 참조하세요.
**Topics**
+ [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-install-ubuntu-64-snap.md)
+ [Ubuntu Server 16.04 64비트(deb)에 SSM Agent 설치](agent-install-ubuntu-64-deb.md)
+ [Ubuntu Server 16.04 32비트에 SSM Agent 설치](agent-install-ubuntu-32.md)
+ [64비트 Ubuntu Server 16.04 인스턴스에 설치할 올바른 SSM Agent 버전 확인](agent-install-ubuntu-about-v16.md)
# 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](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 패키지로 설치](agent-install-ubuntu-64-deb.md)합니다. 설치하기 전에 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/amazon-ssm-agent)([https://snapcraft.io](https://snapcraft.io))에서 에이전트를 자동으로 다운로드하기 때문에 다운로드를 위해 URL을 지정할 필요는 없습니다.
```
sudo snap install amazon-ssm-agent --classic
```
1. 다음 명령을 실행하여 SSM Agent가 실행 중인지 확인합니다.
```
sudo snap list amazon-ssm-agent
```
1. 이전 명령에서 `amazon-ssm-agent is stopped`, `inactive` 또는 `disabled`가 반환되는 경우 다음 명령을 실행하여 서비스를 시작합니다.
```
sudo snap start amazon-ssm-agent
```
1. 에이전트의 상태를 확인합니다.
```
sudo snap services amazon-ssm-agent
```
# Ubuntu Server 16.04 64비트(deb)에 SSM Agent 설치
**중요**
Ubuntu Server의 64비트 버전에 SSM Agent를 설치하기 전에 올바른 설치 도구를 사용 중인지 확인합니다. 20180627로 식별된 Amazon Machine Image(AMI)부터 SSM Agent는 Snap 패키지를 사용하여 버전 16.04에 사전 설치됩니다. 이전 AMI에서 생성된 인스턴스에서는 deb 설치 관리자 패키지를 사용하여 SSM Agent를 설치해야 합니다. 자세한 내용은 [64비트 Ubuntu Server 16.04 인스턴스에 설치할 올바른 SSM Agent 버전 확인](agent-install-ubuntu-about-v16.md) 단원을 참조하세요. If SSM Agent가 Snap과 함께 인스턴스에 설치될 때 deb 설치 관리자 패키지를 사용하여 SSM Agent를 설치하거나 업데이트하는 경우 설치 또는 SSM Agent 작업이 실패할 수 있습니다.
대부분의 경우 AWS에서 제공하는 Amazon Machine Images(AMIs) Ubuntu Server 16.04에는 AWS Systems Manager 에이전트(SSM Agent)가 기본적으로 사전 설치되어 있습니다. 자세한 내용은 [SSM Agent가 사전 설치된 상태로 AMIs 검색](ami-preinstalled-agent.md) 섹션을 참조하세요.
SSM Agent가 버전 20180627 전에 새 Ubuntu Server 16.04 인스턴스에 사전 설치되어 있지 않거나 에이전트를 수동으로 다시 설치해야 하는 경우 이 페이지의 정보를 사용하면 도움이 됩니다.
## Ubuntu Server 16.04(deb)에 SSM Agent를 설치하기 위한 빠른 설치 명령
다음 단계를 사용하여 단일 인스턴스에서 SSM Agent를 수동으로 설치합니다. 이 절차에서는 전역에서 사용 가능한 설치 파일을 사용합니다.
**빠른 복사 및 붙여넣기 명령을 사용하여 Ubuntu Server 16.04 64비트(deb)에서 SSM Agent 설치**
1. 선호하는 방법(예: SSH)을 사용하여 Ubuntu Server 인스턴스에 연결합니다.
1. 다음 명령을 실행하여 인스턴스에서 임시 디렉터리를 생성합니다.
```
mkdir /tmp/ssm
```
1. 임시 디렉터리로 변경합니다.
```
cd /tmp/ssm
```
1. 다음 명령을 실행합니다.
**참고**
다음 명령의 URL에는 `ec2-downloads-windows` 디렉터리가 포함되어 있지만, 이 파일들이 Ubuntu Server 16.04 64비트용 올바른 글로벌 설치 파일입니다.
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
1. (권장) 다음 명령을 실행하여 SSM Agent가 실행 중인지 확인합니다.
Ubuntu Server 16.04
```
sudo systemctl status amazon-ssm-agent
```
대부분의 경우 명령에서 에이전트가 실행 중임을 보고합니다.
드물게 다음 예시와 같이 명령에서 에이전트가 설치되었지만 실행 중이지 않음을 보고합니다.
1. 이전 명령에서 `amazon-ssm-agent is stopped`, `inactive` 또는 `disabled`가 반환되는 경우 다음 명령을 실행하여 서비스를 시작합니다.
Ubuntu Server 16.04:
```
sudo systemctl enable amazon-ssm-agent
```
## 리전에서 Ubuntu Server 16.04 64비트(deb)용 SSM Agent의 사용자 지정 설치 명령 생성
스크립트 또는 템플릿을 사용하여 여러 인스턴스에서 SSM Agent를 설치할 때 사용 중인 AWS 리전에 저장된 설치 파일을 사용하는 것이 좋습니다.
다음 명령의 경우 미국 동부(오하이오) 리전(`us-east-2`)에서 공개적으로 액세스할 수 있는 S3 버킷을 사용하는 예제를 제공합니다.
**작은 정보**
또한 앞선 주제의 [Ubuntu Server 16.04(deb)에 SSM Agent를 설치하기 위한 빠른 설치 명령](#quick-install-ub-16-14-64-bit) 절차에 있는 전역 URL을 구성한 사용자 지정 리전 URL로 바꿀 수 있습니다.
다음 명령에서 *region*을 자신의 정보로 바꿉니다. 지원되는 *리전* 값 목록은 **Amazon Web Services 일반 참조의 [Systems Manager 서비스 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region)에 있는 **리전** 열을 참조하세요.
```
wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/debian_amd64/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
다음 예제를 참조하세요.
```
wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/debian_amd64/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
# Ubuntu Server 16.04 32비트에 SSM Agent 설치
대부분의 경우 AWS에서 제공하는 Amazon Machine Images(AMIs) Ubuntu Server 16.04에는 AWS Systems Manager 에이전트(SSM Agent)가 기본적으로 사전 설치되어 있습니다. 자세한 내용은 [SSM Agent가 사전 설치된 상태로 AMIs 검색](ami-preinstalled-agent.md) 섹션을 참조하세요.
SSM Agent가 새 Ubuntu Server 16.04 인스턴스에 사전 설치되어 있지 않거나 에이전트를 수동으로 다시 설치해야 하는 경우 이 페이지의 정보를 사용하면 도움이 됩니다.
## Ubuntu Server 16.04 32비트(deb)에 SSM Agent를 설치하기 위한 빠른 설치 명령
다음 단계를 사용하여 단일 인스턴스에서 SSM Agent를 수동으로 설치합니다. 이 절차에서는 전역에서 사용 가능한 설치 파일을 사용합니다.
**빠른 복사 및 붙여넣기 명령을 사용하여 Ubuntu Server 16.04 32비트(deb)에서 SSM Agent 설치**
1. 선호하는 방법(예: SSH)을 사용하여 Ubuntu Server 인스턴스에 연결합니다.
1. 다음 명령을 실행하여 인스턴스에서 임시 디렉터리를 생성합니다.
```
mkdir /tmp/ssm
```
1. 임시 디렉터리로 변경합니다.
```
cd /tmp/ssm
```
1. 다음 명령을 실행합니다.
**참고**
다음 명령의 URL에는 `ec2-downloads-windows` 디렉터리가 포함되어 있지만, 이 파일들이 Ubuntu Server 16.04 32비트용 올바른 글로벌 설치 파일입니다.
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_386/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
1. (권장) 다음 명령을 실행하여 SSM Agent가 실행 중인지 확인합니다.
Ubuntu Server 16.04
```
sudo systemctl status amazon-ssm-agent
```
대부분의 경우 명령에서 에이전트가 실행 중임을 보고합니다.
드물게 다음 예시와 같이 명령에서 에이전트가 설치되었지만 실행 중이지 않음을 보고합니다.
1. 이전 명령에서 `amazon-ssm-agent is stopped`, `inactive` 또는 `disabled`가 반환되는 경우 다음 명령을 실행하여 서비스를 시작합니다.
Ubuntu Server 16.04:
```
sudo systemctl enable amazon-ssm-agent
```
## 리전에서 Ubuntu Server 16.04 32비트(deb)용 SSM Agent의 사용자 지정 설치 명령 생성
스크립트 또는 템플릿을 사용하여 여러 인스턴스에서 SSM Agent를 설치할 때 사용 중인 AWS 리전에 저장된 설치 파일을 사용하는 것이 좋습니다.
다음 명령의 경우 미국 동부(오하이오) 리전(`us-east-2`)에서 공개적으로 액세스할 수 있는 S3 버킷을 사용하는 예제를 제공합니다.
**작은 정보**
또한 앞선 주제의 [Ubuntu Server 16.04 32비트(deb)에 SSM Agent를 설치하기 위한 빠른 설치 명령](#quick-install-ub-16-14-32-bit) 절차에 있는 전역 URL을 구성한 사용자 지정 리전 URL로 바꿀 수 있습니다.
다음 명령에서 *region*을 자신의 정보로 바꿉니다. 지원되는 *리전* 값 목록은 **Amazon Web Services 일반 참조의 [Systems Manager 서비스 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region)에 있는 **리전** 열을 참조하세요.
```
wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/debian_386/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
다음 예제를 참조하세요.
```
wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/debian_386/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
# 64비트 Ubuntu Server 16.04 인스턴스에 설치할 올바른 SSM Agent 버전 확인
**중요**
Ubuntu Server의 64비트 버전에 SSM Agent를 설치하기 전에 올바른 설치 도구를 사용 중인지 확인합니다. 20180627로 식별된 Amazon Machine Image(AMI)부터 SSM Agent는 Snap 패키지를 사용하여 버전 16.04에 사전 설치됩니다. 이전 AMI에서 생성된 인스턴스에서는 deb 설치 관리자 패키지를 사용하여 SSM Agent를 설치해야 합니다. 자세한 내용은 [64비트 Ubuntu Server 16.04 인스턴스에 설치할 올바른 SSM Agent 버전 확인](#agent-install-ubuntu-about-v16) 단원을 참조하세요.
인스턴스에 SSM Agent 설치가 두 개 이상 있는 경우(예: Snap을 사용하여 설치된 항목, deb 설치 관리자를 사용하여 설치된 항목) 에이전트 작업이 제대로 작동하지 않습니다.
다음 방법 중 하나를 사용하여 인스턴스에 대한 소스 AMI ID 생성 날짜를 확인할 수 있습니다. 이 절차는 AWS 관리형 AMIs에만 적용됩니다.
**소스 AMI ID 생성 날짜 확인(콘솔)**
1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)에서 Amazon EC2 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **인스턴스**를 선택합니다.
1. 인스턴스를 선택합니다.
1. **세부 정보(Details)** 탭의 **AMI 이름(name)** 필드 값에서 `YYYYMMDD` 식별자를 확인합니다. 예를 들면 `ubuntu/images/hvm-ssd/ubuntu-xenial-16.04-amd64-server-20180627`입니다.
**소스 AMI ID 생성 날짜 확인(AWS CLI)**
+ 다음 명령을 실행합니다.
```
aws ec2 describe-images --image-ids ami-id
```
*ami-id*는 AWS에서 제공하는 AMI의 ID를 나타냅니다(예: `ami-07c8bc5c1ce9598c3`).
성공하면 명령에서 다음과 같은 정보를 반환합니다. `CreationDate` 및 `Name` 필드에서 정보를 확인할 수 있습니다.
```
{
"Images": [
{
"Architecture": "x86_64",
"CreationDate": "2020-07-24T20:40:27.000Z",
"ImageId": "ami-07c8bc5c1ce9598c3",
-- truncated --
"ImageOwnerAlias": "amazon",
"Name": "amzn2-ami-hvm-2.0.20200722.0-x86_64-gp2",
"RootDeviceName": "/dev/xvda",
"RootDeviceType": "ebs",
"SriovNetSupport": "simple",
"VirtualizationType": "hvm"
}
]
}
```