[NxtGen] Instance Helper 가이드
관리자 기능
- 조직 크레딧 대시보드 — 총 풀 · 할당 · 사용량 실시간 파악
- 팀 관리 — 생성, 예산 배분, 인스턴스 할당, 허용 유형 제한
- 크레딧 시각화 — 분배 도넛 차트 + 24시간 추이 그래프
- Slack 알림 연동 — 크레딧 부족 · 자동 종료 알림 자동 발송
- 멀티 조직 지원 — 조직별 독립 운영, 역할 기반 접근 제어
관리자 매뉴얼 👇🏻
[NxtGen] Instance Helper 관리자 가이드
사용자 기능
- GPU 인스턴스 원클릭 제어 — 시작 / 정지로 EC2 즉시 운영
- 실시간 크레딧 모니터링 — 잔여 크레딧, 사용률, 예상 잔여 시간
- 자동 종료 타이머 — 시간 경과 시 자동 정지, 유연한 연장/단축
- GPU 유형 변경 — 다양한 유형 간 자유 전환
- JupyterLab 즉시 접속 — 원클릭 웹 개발 환경
사용자 매뉴얼 👇🏻
[NxtGen] Instance Helper 사용자 가이드
자주하는질문 (Q&A)
1. 일반
-
이 플랫폼은 무엇인가요?
팀별로 AWS EC2 GPU 인스턴스를 크레딧 기반으로 관리할 수 있는 플랫폼입니다. 인스턴스 시작/중지, 유형 변경, 사용량 추적, 보안 그룹 관리 등을 웹 대시보드에서 수행할 수 있습니다.
-
플랫폼 운영 주체는 어디인가요?
본 플랫폼은 NxtCloud에서 운영합니다. 서비스 관련 문의 사항은 NxtCloud에 문의해 주세요.
2. 조직 / 크레딧
-
조직 크레딧은 어떻게 발급받을 수 있나요?
조직 크레딧 풀(Credit Pool)은 NxtCloud에서 관리합니다. 크레딧 발급 및 충전이 필요한 경우 NxtCloud에 문의해 주세요.
-
크레딧은 어떻게 차감되나요?
인스턴스가 실행 중인 동안 자동 차감됩니다. 차감 금액은 인스턴스 유형별 시간당 크레딧 요율에 따라 초 단위로 정밀 계산됩니다. 예를 들어,
g4dn.xlarge(T4 GPU)는 시간당 1.00 크레딧이 차감됩니다. -
크레딧이 0이 되면 어떻게 되나요?
크레딧이 소진되면 실행 중인 인스턴스가 자동으로 중지되고, 팀 계정이 잠금(Locked) 상태가 됩니다. 잠금 상태에서는 인스턴스 시작 및 유형 변경이 불가합니다. 잠금 해제는 관리자에게 요청하거나, 관리자가 크레딧 예산을 증액하면 자동으로 해제됩니다.
-
팀별 크레딧 예산은 어떻게 배분되나요?
관리자가 조직 크레딧 풀 내에서 각 팀에 예산을 배분합니다. 모든 팀 예산의 합계는 조직 전체 크레딧 풀을 초과할 수 없습니다. 예산 조정이 필요하면 관리자에게 요청해 주세요.
3. 계정 / 로그인
-
팀 코드를 잊어버렸어요.
관리자에게 코드 초기화를 요청해 주세요. 관리자는 팀 코드를 확인하거나 새 코드로 재설정할 수 있습니다.
-
팀 코드를 변경하고 싶어요.
팀 대시보드에서 직접 변경할 수 있습니다. 현재 코드를 입력한 뒤 새 코드(최소 4자리)를 설정하면 됩니다.
-
로그인 세션은 얼마나 유지되나요?
로그인 후 8시간 동안 유효합니다. 세션이 만료되면 자동으로 로그인 페이지로 이동합니다.
-
로그인 시도에 제한이 있나요?
보안을 위해 1분당 최대 10회로 제한됩니다. 제한에 걸린 경우 잠시 후 다시 시도해 주세요.
4. 인스턴스 관리
-
인스턴스를 시작하려면 어떻게 하나요?
팀 대시보드에서 시작 버튼을 클릭하면 됩니다. 단, 다음 조건을 모두 충족해야 합니다:
- EC2 인스턴스가 팀에 배정되어 있어야 합니다
- 잔여 크레딧이 0보다 커야 합니다
- 팀이 잠금 상태가 아니어야 합니다
-
인스턴스를 시작하면 자동으로 꺼지나요?
네. 인스턴스를 시작하면 기본 4시간 후 자동 종료됩니다. 대시보드에서 시간 연장 또는 단축이 가능합니다.
-
인스턴스 자동 종료 시간을 변경하고 싶어요.
대시보드에서 시간 연장/단축 기능을 사용하세요. 원하는 시간(단위: 시간)을 입력하면 자동 종료 시각이 조정됩니다. 단, 종료 시각이 현재 시각보다 과거가 되도록 설정할 수는 없습니다.
-
인스턴스 유형(타입)을 변경하고 싶어요.
인스턴스가 중지(Stopped) 상태일 때만 변경 가능합니다. 대시보드에서 사용 가능한 인스턴스 유형 목록을 확인하고 원하는 유형을 선택하세요. 관리자가 팀별로 사용 가능한 유형을 제한할 수 있으므로, 원하는 유형이 목록에 없다면 관리자에게 문의하세요.
-
EC2 인스턴스는 어떻게 배정받나요?
EC2 인스턴스 배정은 관리자가 수행합니다. 인스턴스가 배정되지 않은 상태라면 관리자에게 요청해 주세요. 인스턴스 생성 및 할당 관련 문의는 NxtCloud에 문의해 주세요.
5. 보안
-
보안 그룹(Security Group) 규칙을 직접 관리할 수 있나요?
네. 팀에 보안 그룹이 배정되어 있다면, 대시보드에서 인바운드/아웃바운드 규칙을 추가하거나 삭제할 수 있습니다. SSH(22), HTTP(80), HTTPS(443), Jupyter(8888) 등의 프리셋이 제공됩니다.
-
SSH 키페어는 어떻게 받나요?
관리자가 팀에 키페어(.pem 파일)를 업로드하면, 대시보드에서 다운로드 받을 수 있습니다. 키페어가 없다면 관리자에게 요청하세요.
-
SSH로 인스턴스에 접속하는 방법은?
-
대시보드에서 키페어(.pem)를 다운로드합니다
-
대시보드에서 인스턴스의 퍼블릭 IP를 확인합니다
-
터미널에서 접속합니다:
chmod 400 keypair.pem ssh -i keypair.pem ubuntu@<퍼블릭IP>
-
6. 사용량 / 모니터링
-
사용 내역은 어디서 확인하나요?
팀 대시보드에서 최근 200건의 사용 로그를 확인할 수 있습니다. 인스턴스 시작/중지, 크레딧 차감, 유형 변경 등의 이력이 기록됩니다.
-
크레딧 부족 경고는 언제 표시되나요?
현재 인스턴스 유형 기준으로 잔여 크레딧이 30분 미만의 사용 시간에 해당하면 대시보드에 경고가 표시됩니다. Slack 알림이 설정된 경우 관리자가 지정한 임계값에 도달하면 Slack 알림도 발송됩니다.
-
대시보드 정보는 실시간인가요?
- 팀 대시보드: 10초 간격으로 자동 갱신
- 관리자 대시보드: 30초 간격으로 자동 갱신
7. 관리자
-
관리자 계정은 어떻게 만드나요?
관리자 계정 생성은 시스템 설정 단계에서 이루어집니다. 추가 관리자 계정이 필요하면 NxtCloud에 문의해 주세요.
-
팀을 새로 만들려면 어떻게 하나요?
관리자 대시보드에서 팀 추가 버튼을 클릭하고, 팀 이름, 팀 코드(최소 4자), 크레딧 예산을 입력합니다. 선택적으로 EC2 인스턴스 ID와 인스턴스 유형도 지정할 수 있습니다.
-
팀 계정이 잠겼습니다. 어떻게 해제하나요?
관리자 대시보드에서 해당 팀의 잠금 해제 버튼을 클릭하거나, 크레딧 예산을 증액하면 잔여 크레딧이 생기면서 자동 해제됩니다.
-
팀의 인스턴스를 강제 종료할 수 있나요?
네. 관리자 대시보드에서 해당 팀의 강제 중지 버튼을 사용하면 EC2 인스턴스 중지 및 세션 종료가 즉시 처리됩니다.
-
사용량 로그를 내보낼 수 있나요?
네. 관리자 대시보드에서 사용 로그를 CSV 형식으로 다운로드할 수 있습니다. 팀별 필터링도 가능합니다.
8. 트러블슈팅
-
"크레딧이 부족합니다" 오류가 나요.
잔여 크레딧이 0인 경우 인스턴스를 시작할 수 없습니다. 관리자에게 크레딧 예산 증액을 요청하세요.
-
인스턴스를 시작했는데 바로 꺼져요.
크레딧이 거의 소진된 상태에서 시작하면 다음 차감 주기(10초)에 크레딧이 0이 되어 자동 종료될 수 있습니다. 충분한 크레딧이 있는지 확인해 주세요.
-
인스턴스 유형 변경이 안 돼요.
다음을 확인하세요:
- 인스턴스가 중지(Stopped) 상태인지 확인
- 원하는 유형이 허용된 유형 목록에 포함되어 있는지 확인
- 잔여 크레딧이 0이 아닌지 확인
-
대시보드에 인스턴스 정보가 안 보여요.
팀에 EC2 인스턴스가 아직 배정되지 않았을 수 있습니다. 관리자에게 인스턴스 배정을 요청하세요.
-
서버에 접속할 수 없어요.
서비스 장애가 의심되는 경우 NxtCloud에 문의해 주세요.
9. 기타
-
모바일에서도 사용할 수 있나요?
웹 브라우저 기반이므로 모바일 브라우저에서도 접근 가능합니다. 다만 데스크탑 환경에 최적화되어 있습니다.
-
다크모드/라이트모드를 지원하나요?
네. 테마 스위치를 통해 다크모드와 라이트모드를 전환할 수 있습니다.