에이전트 설치하기
인스턴스를 온보딩하면 Alpamon 에이전트가 설치되어 관리형 Alpacon 서버가 됩니다. AWS Systems Manager(SSM)를 통해 원클릭으로 설치하거나, 수동 SSH 가이드를 따를 수 있습니다.
원클릭 설치 (AWS SSM)
인스턴스 인벤토리나 인스턴스 상세 페이지에서 에이전트 설치를 클릭합니다. 진행 다이얼로그에 세 단계가 표시됩니다.
- 명령 전송: AWS Systems Manager를 통해 설치 명령이 전송됩니다.
- 에이전트 설치: 인스턴스에 에이전트가 설치됩니다.
- 서버 매칭: 인스턴스가 새 Alpacon 서버에 연결됩니다(태그, MAC, IP, 호스트명 기준).
세 단계가 모두 완료되면 서버 보기를 클릭해 새 서버를 엽니다. 단계가 실패하거나 시간이 초과되면 오류가 표시되며 재시도할 수 있습니다.
수동 설치 (SSH)
지원되지 않는 플랫폼 등으로 원클릭 설치를 사용할 수 없으면 수동 설치 가이드를 사용하세요. 인스턴스에서 직접 실행할 SSH 명령과 설치 스크립트가 표시되며, SSH 명령(퍼블릭 또는 사설 IP)과 설치 스크립트를 복사할 수 있습니다.
참고: 설치 스크립트에는 등록 토큰이 평문으로 포함되어 있으니 외부에 공유하지 마세요. 스크립트를 실행하면 인스턴스가 스스로 등록되고 서버에 매칭됩니다.
설치가 차단된 경우
에이전트 설치를 사용할 수 없으면 인스턴스에 차단됨 상태와 사유, 해소 방법이 표시됩니다. 흔한 사유는 다음과 같습니다.
| 사유 | 해소 방법 |
|---|---|
| 이미 관리 중 | 조치가 필요 없습니다. 에이전트가 이미 실행 중입니다. |
| 설치 진행 중 | 현재 설치가 끝날 때까지 기다립니다. |
| 인스턴스 미실행 | 인스턴스를 시작한 뒤 다음 동기화를 기다립니다. |
| 원격 명령 불가 | 인스턴스를 AWS SSM 관리형 노드로 등록합니다. |
| 미지원 플랫폼 | 에이전트를 수동으로 설치하고 등록합니다(예: Windows). |
| 계정 비활성 | 계정 상태가 Active가 될 때까지 재검증합니다. |
| 원격 명령 비활성 | 계정 설정에서 원격 명령을 활성화합니다. |
| 등록 토큰 없음 | 계정에 서버 등록 토큰을 연결합니다. |
온보딩 이후
온보딩된 인스턴스는 서버에 표시되며, 다른 서버와 마찬가지로 작업 세션을 통해 접속합니다.