사용 설명서

랩 GPU 서버(DGX H200, Blackwell)의 실시간 현황 확인 + 예약 + 자동 예약 해제 시스템입니다. 구글 시트 예약의 문제(작업이 끝나도 예약이 안 빠짐)를 해결하기 위해, 시스템이 GPU의 실제 사용을 직접 관측해서 안 쓰는 예약을 자동으로 회수합니다.

1. 화면 읽는 법

표시	의미
사용 가능	예약도 없고 작업도 없음 — 바로 예약해서 쓰면 됩니다
사용 중	예약자가 실제로 작업을 돌리는 중
예약됨 · 유휴	예약은 있는데 GPU가 놀고 있음 — 곧 자동 해제 대상이 될 수 있음
예약 없이 사용 중	예약 없이 작업이 돌아가는 중 — 예약 후 사용해 주세요 (경고 알림 발생)

서버 헤더에는 CPU·RAM·디스크 사용량과, 로그인 시 실행 중인 도커 컨테이너 목록(소유자·자원 사용량)이 보입니다. 카드의 그래프는 최근 3시간 GPU 사용률입니다.

2. 로그인

랩 Slack에서 /gpu login 입력
봇이 DM으로 보내주는 1회용 링크(10분 유효) 클릭 → 로그인 버튼

별도 비밀번호가 없습니다 — 랩 Slack 멤버라는 것 자체가 로그인 자격입니다.

3. 예약하기

지금부터 쓰기: 빈 GPU 카드의 [예약] → 기간(12시간~7일) 클릭 → [예약하기]. 기간 버튼은 항상 "지금부터"입니다.
날짜 지정(사전 예약): 같은 패널에서 시작/종료 날짜·시간을 직접 바꾸면 그 값으로 예약됩니다 (최대 14일 이후까지).
다른 사람 예약과 시간이 겹치면 누구의 몇 시~몇 시 예약과 겹치는지 알려주며 거부됩니다.
한 번에 최대 7일. Slack에서도 가능: /gpu claim dgx:0 1d

4. 연장 · 해제

내 카드에서 [+1일] [+3일]로 연장 — 예약당 최대 3회입니다. 그 이상은 관리자에게 받은 특수 코드가 필요합니다.
연장이 다음 사람 예약을 침범하면 거부됩니다.
[해제]는 확인 절차 없이 즉시 — 작업이 끝나면 바로 눌러주세요. 다 쓴 GPU를 빨리 비우는 게 이 시스템의 핵심 매너입니다.
예약된 GPU를 기다릴 땐 [🔔 비면 알림] — 비는 순간 Slack DM이 옵니다.

5. 자동 해제 (제일 중요)

예약했는데 GPU를 안 쓰면 (프로세스 없음 + 사용률 5% 미만):

유휴 시간	일어나는 일
30분	Slack DM 경고 + [계속 사용 +60분] [지금 해제] 버튼
50분	최종 경고 (10분 후 해제 예고)
60분	예약 자동 해제 (증거 그래프 + [다시 예약] 버튼 포함 DM)

잠깐이라도 GPU 활동이 감지되면 타이머가 완전히 리셋됩니다 (간헐 작업 안전).
[계속 사용] 스누즈는 예약당 2회. 새벽(00~08시)에는 유예가 2배.
실행 중인 프로세스는 절대 죽이지 않습니다. 예약 기록만 해제됩니다.
도커·Slurm 등으로 계정 판별이 안 돼도 "활동 중인 GPU"는 절대 자동 해제되지 않습니다.

6. 계정 연동 (꼭 해주세요)

Slack에서 /gpu link → 봇이 알려주는 touch /tmp/gpuboard-코드 명령을 아무 GPU 서버에서 본인 계정으로 실행하면 연동 완료. 이걸 해야 시스템이 "예약자 본인이 쓰는 중"인지 판별할 수 있습니다 — 안 하면 본인 작업도 "예약자 외 사용" 경고가 뜰 수 있어요. 도커를 쓰는 경우 컨테이너의 마운트 경로(/raid/계정명/…)로 소유자를 추정하므로, 본인 계정 경로를 마운트해서 쓰면 됩니다.

7. 알림 (대시보드 상단 배너 · #server 채널)

시스템이 문제를 감지하면 누구 문제인지 계정·컨테이너 이름과 함께 알려줍니다 — 단, 알려만 주고 작업에 개입하지는 않습니다. 본인 이름이 뜬 항목은 직접 조치해 주세요.

예약 없이 사용 / 예약자 외 사용 → 예약 후 사용해 주세요
디스크 90%↑ / RAM 92%↑ / CPU 과부하 → 정리·조정 필요
좀비 프로세스 다수 → 원인 컨테이너를 --init 옵션으로 재실행
GPU 고온 / 에이전트 오프라인 → 관리자 확인

매일 오전 9시 #server 채널에 요약이 올라옵니다: 사용 가능 현황, 현재/오늘 예약, 조치 필요 항목.

8. Slack 명령어 모음

명령	동작
`/gpu`	전체 현황 + 빈 GPU 예약 버튼
`/gpu claim dgx:0 1d`	예약 (여러 장: `dgx:0,1`)
`/gpu extend 1d`	연장 (3회 초과 시: `/gpu extend 1d 특수코드`)
`/gpu release`	해제
`/gpu watch dgx:0`	비면 DM (`unwatch` 취소)
`/gpu link`	리눅스 계정 연동
`/gpu login`	웹 로그인 링크 받기

9. 자주 묻는 질문

Q. "섀도 모드"가 뭔가요?
도입 초기 시운전 상태입니다. 자동 해제 조건이 충족돼도 실제로 해제하지 않고 "해제될 뻔했다" 알림만 보내며 임계값을 조정합니다. 안정화되면 관리자가 끄고 실제 자동 해제가 시작됩니다.

Q. 급하게 GPU가 대량으로 필요하면?
관리자(서버마스터)에게 요청하세요. 관리자는 긴급 선점으로 일괄 확보할 수 있고, 이 경우 기존 예약은 삭제되지 않고 가장 빠른 다음 시간대로 자동 이동되며 당사자에게 DM이 갑니다.

Q. 내 작업이 자동 해제로 죽나요?
아니요. 어떤 경우에도 프로세스는 건드리지 않습니다. 예약 기록만 해제되며, 잘못 해제됐다면 DM의 [다시 예약] 버튼 한 번으로 복구됩니다.

Q. GPU에 administrator(Xorg)가 보이던데?
서버 화면 출력용 시스템 프로세스입니다. 자원을 거의 안 쓰고 판정에도 영향이 없어 목록에서 숨겼습니다.

문의: 관리자(서버마스터) · 시스템 문제는 #server 채널에