본문으로 건너뛰기

수요자 가이드

인스턴스 툴킷 wwctl

요금 · 남은 시간 · 볼륨 확인 · 파일 송수신 · 자체 진단

wwctl 은 모든 템플릿에 들어 있는 명령줄 도구입니다. SSH 로 접속한 셸에서 콘솔로 돌아가지 않고 요금 · 남은 시간 · 볼륨 · 인스턴스 상태를 확인하고 스스로 진단할 수 있습니다.

2. 명령 목록

wwctl status      인스턴스 요약 · 가동 시간 · 서버가 계산한 요금
wwctl gpu         GPU 사용량 · 온도 · 전력
wwctl storage     디스크 사용량. 영구 볼륨과 컨테이너 디스크를 구분해 표시
wwctl port        열려 있는 포트
wwctl doctor      자체 진단 — GPU · 디스크 · 격리가 실제로 막히는지
wwctl logs [N]    초기화 로그

wwctl 만 입력하면 wwctl status 와 같습니다. 도움말은 wwctl help 입니다.

3. 요금과 남은 시간 — wwctl status

wwctl status

인스턴스 라벨 · 템플릿 · 가동 시간과 함께 요금 영역에 상태 · 10분 블록 단가 · 과금 경과 · 누적(예상) · 청구 완료 블록 · 다음 청구 · 자동 종료 시각이 나옵니다.

  • 요금 숫자는 WattWorks 서버가 계산한 값이고, 콘솔 인스턴스 상세의 숫자와 같습니다.
  • 「가동 시간」과 「과금 경과」는 몇 초 다를 수 있습니다. 인스턴스가 준비되는 동안의 시간은 과금하지 않기 때문입니다.
  • 서버에 연결되지 않으면 숫자를 보여 주지 않고 "콘솔에서 확인하세요" 라고 안내합니다. 이때는 콘솔을 이용하세요.

4. 볼륨 확인 — wwctl storage

wwctl storage

컨테이너 디스크(종료 시 사라집니다)와 /workspace 를 나눠 사용량을 보여 줍니다. /workspace 가 영구 볼륨이 아니면 "영구 볼륨이 아닙니다" 경고가 함께 나옵니다.

5. 자체 진단 — wwctl doctor

wwctl doctor
  • 서비스 — 템플릿의 서비스(SSH · Jupyter 등)가 정상인지.
  • GPU · 디스크 — GPU 가 보이는지와 디스크 사용량.
  • 네트워크 — 인터넷으로 나가는 길이 열려 있는지.
  • 격리 — 막혀 있어야 하는 길(사설망 · 클라우드 메타데이터 · 메일 발송 포트 25)이 실제로 막혀 있는지.

마지막 줄이 "확인이 필요한 항목이 있습니다" 이면, 위에 나온 표를 그대로 복사해 문의에 붙여 주세요.

초기화 과정이 궁금하면 wwctl logs 로 로그를 봅니다. 새 줄을 계속 따라가며 보여 주므로 Ctrl+C 로 빠져나옵니다.

6. 아직 동작하지 않는 명령

아래 명령은 준비 중입니다. 실행하면 "아직 구현되지 않았습니다. 콘솔을 이용하세요." 로 끝납니다.

  • wwctl url — Jupyter · vLLM 접속 주소와 토큰 · API 키 확인과 재발급
  • wwctl send · wwctl recv — 파일 송수신. 지금은 scp 를 쓰세요.
  • wwctl stop — 인스턴스 종료. 지금은 콘솔의 인스턴스 상세에서 종료하세요.

가이드 목록으로