• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.
# Debian Server 인스턴스에 SSM Agent 수동 설치
AWS에서 제공하는 Debian Server용 Amazon Machine Images(AMIs)에는 AWS Systems Manager 에이전트(SSM Agent)가 기본적으로 사전 설치되어 있습니다. 에이전트가 사전 설치될 수 있는 AWS에서 관리하는 AMIs 목록은 [SSM Agent가 사전 설치된 상태로 AMIs 검색](ami-preinstalled-agent.md)의 내용을 참조하세요.
이 섹션의 정보를 사용하면 Debian Server 인스턴스에서 SSM Agent를 수동으로 설치 또는 재설치하는 데 도움이 됩니다.
**시작하기 전 준비 사항**
Debian Server 인스턴스에 SSM Agent를 설치하기 전에 다음 사항에 유의하세요.
+ 모든 Linux 기반 운영 체제에서의 SSM Agent 설치에 적용되는 중요한 정보는 [Linux용 EC2 인스턴스에 수동으로 SSM Agent 설치 및 제거](manually-install-ssm-agent-linux.md)의 내용을 참조하세요.
**Topics**
+ [Debian Server의 SSM Agent에 대한 빠른 설치 명령](#quick-install-debian)
+ [리전에서 Debian Server용 사용자 지정 에이전트 설치 명령 생성](#custom-url-debian)
## Debian Server의 SSM Agent에 대한 빠른 설치 명령
다음 단계를 사용하여 단일 인스턴스에서 SSM Agent를 수동으로 설치합니다. 이 절차에서는 전역에서 사용 가능한 설치 파일을 사용합니다.
**Debian Server에 SSM Agent를 설치하려면**
1. 선호하는 방법(예: SSH)을 사용하여 Debian Server 인스턴스에 연결합니다.
1. 다음 명령을 실행하여 인스턴스에서 임시 디렉터리를 생성합니다.
```
mkdir /tmp/ssm
```
1. 다음 명령을 실행하여 임시 디렉터리로 변경합니다.
```
cd /tmp/ssm
```
1. 인스턴스 아키텍처에 대한 명령을 복사하고 인스턴스에서 실행합니다.
**참고**
다음 명령의 URL에는 `ec2-downloads-windows` 디렉터리가 포함되어 있지만, 이는 Debian Server에 대한 올바른 전역 설치 파일입니다.
Debian Server 8의 경우 x86\_64 아키텍처만 지원됩니다.
x86\_64 인스턴스
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
```
ARM64 인스턴스
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_arm64/amazon-ssm-agent.deb
```
1. 다음 명령을 실행합니다.
```
sudo dpkg -i amazon-ssm-agent.deb
```
1. (권장) 다음 명령을 실행하여 에이전트가 실행 중인지 확인합니다.
```
sudo systemctl status amazon-ssm-agent
```
대부분의 경우 다음 예시와 같이 명령에서 에이전트가 실행 중임을 보고합니다.
```
● amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor
Active: active (running) since Tue 2025-04-19 16:25:03 UTC; 4s ago
Main PID: 628 (amazon-ssm-agen)
CGroup: /system.slice/amazon-ssm-agent.service
├─628 /usr/bin/amazon-ssm-agent
└─650 /usr/bin/ssm-agent-worker
--truncated--
```
드물게 다음 예시와 같이 명령에서 에이전트가 설치되었지만 실행 중이지 않음을 보고합니다.
```
● amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor
Active: inactive (dead) since Tue 2025-04-19 16:26:30 UTC; 5s ago
Main PID: 628 (code=exited, status=0/SUCCESS)
--truncated--
```
이러한 경우 에이전트를 활성화하려면 다음 명령을 실행합니다.
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
## 리전에서 Debian Server용 사용자 지정 에이전트 설치 명령 생성
스크립트 또는 템플릿을 사용하여 여러 인스턴스에서 SSM Agent를 설치할 때 사용 중인 AWS 리전에 저장된 설치 파일을 사용하는 것이 좋습니다.
다음 명령의 경우 미국 동부(오하이오) 리전(`us-east-2`)에서 공개적으로 액세스할 수 있는 S3 버킷을 사용하는 예제를 제공합니다.
**작은 정보**
또한 앞선 주제의 [Debian Server의 SSM Agent에 대한 빠른 설치 명령](#quick-install-debian) 절차에 있는 전역 URL을 구성한 사용자 지정 리전 URL로 바꿀 수 있습니다.
다음 명령에서 {{region}}을 자신의 정보로 바꿉니다. 지원되는 {{리전}} 값 목록은 **Amazon Web Services 일반 참조의 [Systems Manager 서비스 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region)에 있는 **리전** 열을 참조하세요.
x86\_64
```
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
```
ARM64
```
wget https://s3.{{region}}.amazonaws.com/amazon-ssm-{{region}}/latest/debian_arm64/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_arm64/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```