• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.
# macOS용 EC2 인스턴스에서 SSM Agent 사용
AWS Systems Manager(SSM Agent)는 Systems Manager 요청을 처리하고 요청에 지정된 대로 시스템을 구성합니다. 다음 절차를 사용하여 macOS용 SSM Agent를 설치, 구성 또는 제거합니다.
**참고**
SSM Agent는 기본적으로 macOS용 Amazon Machine Images(AMIs)에 사전 설치됩니다. SSM Agent는 제거하지 않은 한 macOS에 대한 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에 설치할 필요가 없습니다.
SSM Agent의 소스 코드는 [https://github.com/aws/amazon-ssm-agent](https://github.com/aws/amazon-ssm-agent)에 제공되므로 필요에 따라 에이전트를 조정할 수 있습니다. 포함하고 싶은 변경에 대해서는 [풀 요청](https://github.com/aws/amazon-ssm-agent/blob/mainline/CONTRIBUTING.md)을 제출하는 것이 좋습니다. 단, AWS에서 이 소프트웨어의 수정된 사본 실행을 지원하지 않습니다.
**참고**
SSM Agent의 다양한 버전에 대한 세부 정보를 보려면 [출시 정보](https://github.com/aws/amazon-ssm-agent/blob/mainline/RELEASENOTES.md)를 참조하세요.
macOS 운영 체제에 SSM Agent를 수동으로 설치하기 전에 다음 정보를 검토합니다.
+ SSM Agent는 Systems Manager에서 지원하는 EC2 인스턴스 및 Amazon Machine Images에 기본적으로 설치됩니다. 자세한 내용은 [macOS에 대해 지원되는 운영 체제 목록](operating-systems-and-machine-types.md#prereqs-os-mac)을 참조하세요.
SSM Agent는 제거하지 않은 한 macOS EC2 인스턴스에 수동으로 설치할 필요가 없습니다.
+ 일부 AWS 리전에서는 macOS의 EC2 인스턴스가 지원되지 않습니다. macOS의 x86 기반 및 M1 EC2 인스턴스가 지원되는 리전의 목록은 Amazon EC2 FAQ에서 [macOS 워크로드](https://aws.amazon.com/ec2/faqs/#macos_workloads)를 참조하세요.
+ SSM Agent의 업데이트된 버전은 Systems Manager에 새 도구가 추가되거나 기존 도구가 업데이트될 때마다 릴리스됩니다. 최신 버전의 에이전트를 사용하지 못하면 관리형 노드에서 다양한 Systems Manager 도구를 사용하지 못할 수 있습니다. 이러한 이유로 시스템의 SSM Agent 상태를 최신 상태로 유지하는 프로세스를 자동화하는 것이 좋습니다. 자세한 내용은 [SSM Agent 업데이트 자동화](ssm-agent-automatic-updates.md) 섹션을 참조하세요. SSM Agent 업데이트에 대해 알림을 수신하려면 GitHub에서 [SSM Agent 릴리스 정보](https://github.com/aws/amazon-ssm-agent/blob/mainline/RELEASENOTES.md) 페이지를 구독합니다.
**Topics**
+ [SSM Agent용 EC2 인스턴스에 수동으로 macOS 설치 및 제거](manually-install-ssm-agent-macos.md)
# SSM Agent용 EC2 인스턴스에 수동으로 macOS 설치 및 제거
macOS 인스턴스에 연결하고 다음 단계를 수행하여 AWS Systems Manager Agent(SSM Agent)를 설치합니다. Systems Manager를 사용하여 명령을 실행하는 각 인스턴스에서 이 단계를 수행합니다. 이 절차에서 제공되는 명령은 사용자 데이터를 통해 Amazon EC2 인스턴스에 스크립트로 전달될 수도 있습니다.
**중요**
수명 종료(EOL)에 도달한 OS 버전은 사용하지 않는 것이 좋습니다. AWS를 포함한 OS 공급업체는 일반적으로 EOL에 도달한 버전의 보안 패치 또는 기타 업데이트를 제공하지 않습니다. EOL 시스템을 계속 사용하면 보안 수정 사항과 기타 운영 문제를 포함한 업그레이드를 적용할 수 없는 위험이 크게 증가합니다. AWS는 EOL에 도달한 OS 버전에서 Systems Manager 기능을 테스트하지 않습니다.
**시작하기 전 준비 사항**
Homebrew를 사용하여 `wget`을 설치합니다.
**macOS에 SSM Agent를 설치하려면**
1. 다음 명령을 사용하여 x86\$164 인스턴스용 에이전트 설치 관리자 파일을 다운로드합니다.
다음 명령에서 *region*을 자신의 정보로 바꿉니다. 지원되는 *리전* 값 목록은 **Amazon Web Services 일반 참조의 [Systems Manager 서비스 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region)에 있는 **리전** 열을 참조하세요.
```
sudo wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_amd64/amazon-ssm-agent.pkg
```
Apple silicon 인스턴스는 다음 명령을 사용합니다.
```
sudo wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_arm64/amazon-ssm-agent.pkg
```
다음 예를 참고하세요
```
sudo wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/darwin_amd64/amazon-ssm-agent.pkg
```
1. 다음 명령을 사용하여 SSM Agent 설치 관리자를 실행합니다.
x86\$164:
```
sudo installer -pkg amazon-ssm-agent.pkg -target /
```
1. 에이전트의 상태를 확인합니다.
SSM Agent의 실행 여부를 확인하려면 `/var/log/amazon/ssm/amazon-ssm-agent.log`에서 에이전트 로그를 확인합니다.
1. 에이전트 로그에 "amazon-ssm-agent가 중지됨(amazon-ssm-agent is stopped)"이라고 표시되면 다음 명령을 실행하여 서비스를 시작합니다.
```
sudo launchctl load -w /Library/LaunchDaemons/com.amazon.aws.ssm.plist && sudo launchctl start com.amazon.aws.ssm
```
**중요**
SSM Agent의 업데이트된 버전은 Systems Manager에 새 도구가 추가되거나 기존 도구가 업데이트될 때마다 릴리스됩니다. 최신 버전의 에이전트를 사용하지 못하면 관리형 노드에서 다양한 Systems Manager 도구를 사용하지 못할 수 있습니다. 이러한 이유로 시스템의 SSM Agent 상태를 최신 상태로 유지하는 프로세스를 자동화하는 것이 좋습니다. 자세한 내용은 [SSM Agent 업데이트 자동화](ssm-agent-automatic-updates.md) 섹션을 참조하세요. SSM Agent 업데이트에 대해 알림을 수신하려면 GitHub에서 [SSM Agent 릴리스 정보](https://github.com/aws/amazon-ssm-agent/blob/mainline/RELEASENOTES.md) 페이지를 구독합니다.
# macOS 인스턴스에서 SSM Agent 제거
macOS는 기본적으로 `PKG` 파일 제거를 지원하지 않습니다. macOS에 대한 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에서 AWS Systems Manager Agent(SSM Agent)를 제거하려면 다음 위치에서 AWS 관리형 스크립트를 사용할 수 있습니다.
[https://github.com/aws/amazon-ssm-agent/blob/mainline/Tools/src/update/darwin/uninstall.sh](https://github.com/aws/amazon-ssm-agent/blob/mainline/Tools/src/update/darwin/uninstall.sh)