사용설명서

01 · START

처음 시작하기

1. 사용 신청과 계정 준비

   사용 신청 후 관리자 승인과 계정 안내를 확인하세요. 비밀번호 설정 안내를 받았다면 계정을 활성화하고, 발급된 계정으로 접속합니다. 팀 계정은 관리자가 포털에서 발급합니다.

2. 로그인하고 Lab 열기

   내 Lab 열기로 접속하세요. 개인 계정은 학번 또는 s학번, 팀 계정은 team001 같은 발급된 팀 ID로 로그인합니다.

3. 파일을 저장하고 작업 시작

   Lab 파일 탐색기에서 파일을 작성·업로드할 수 있습니다. 중요한 변경은 Ctrl + S로 저장하세요. 새 계정의 홈페이지 폴더는 정상 계정과 홈이 준비된 뒤 최대 5분 안에 자동으로 생성됩니다.

02 · YOUR WEBSITE

내 홈페이지를 공개하세요

각자 만든 HTML·CSS·JavaScript·이미지를 public_html 폴더에 저장하면 자기 주소로 볼 수 있습니다. 웹 서버를 실행하거나 포트를 등록할 필요가 없습니다.

1. public_html 폴더를 엽니다

   개인 페이지는 자신의 계정으로, 팀 페이지는 해당 팀 계정으로 Lab에 로그인합니다. 파일 탐색기에서 public_html을 여세요. 팀원이 개인 계정으로 만든 페이지가 팀 페이지에 자동 합쳐지는 것은 아닙니다.

2. index.html을 만들거나 수정합니다

   처음에는 기본 페이지가 있습니다. index.html을 아래처럼 바꿔 보세요. 새 텍스트 파일을 만들 때는 이름을 정확히 index.html로 지정합니다.

   <!doctype html>
   <html lang="ko">
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>내 홈페이지</title>
   <h1>안녕하세요!</h1>
   <p>나의 첫 홈페이지입니다.</p>
   </html>

3. 저장하고 자기 주소로 접속합니다

   Ctrl + S로 저장한 뒤 브라우저에서 https://cehub.hknu.ac.kr/자기학번/을 엽니다. 팀은 학번 대신 팀 ID를 넣으세요. 개인 홈페이지 주소에는 학번 앞의 s를 붙이지 않습니다.

4. CSS·JS·이미지를 연결합니다

   필요한 파일을 같은 공개 폴더에 올리고 ./로 시작하는 상대 경로를 사용하세요. 예를 들어 이미지 폴더는 public_html/images/에 만들 수 있습니다.

   <link rel="stylesheet" href="./style.css">
   <script src="./app.js" defer></script>
   <img src="./images/logo.png" alt="내 로고">

여러 프로젝트도 가능합니다. public_html/project-a/index.html을 만들면 /자기학번/project-a/로 볼 수 있습니다. 팀도 /team001/project-a/처럼 사용합니다.

03 · WEB BACKEND

로그인·DB 저장이 필요한 웹앱

화면은 public_html에 저장하고, 데이터를 처리하는 Python·Node.js 서버는 cehub-web으로 실행하세요. 개인·팀 계정에 자동으로 연결 주소가 준비되므로 관리자에게 포트를 등록할 필요가 없습니다. 파일을 올리는 것만으로 서버가 자동 실행되지는 않습니다.

예를 들어 개인 계정은 https://cehub.hknu.ac.kr/2022810061/api/, 팀 계정은 https://cehub.hknu.ac.kr/team001/api/로 연결합니다. 백엔드에는 /api/ 앞부분을 제거한 경로가 전달됩니다. /학번/api/messages 요청은 서버의 /messages로 전달됩니다. api는 백엔드 연결용 예약 경로입니다.

1. 게시판 예제를 복사합니다

   Lab에서 터미널을 열고 아래 명령을 실행하세요. 기존 예제 폴더가 있으면 덮어쓰지 않습니다.

   cehub-web example
   cd ~/webapp-example
   cehub-web start -- python3 app.py

   /자기학번/backend-demo/ 또는 /팀ID/backend-demo/에서 예제 계정으로 회원가입·로그인·글 저장을 해볼 수 있습니다. 예제 계정은 CEHUB 계정과 별개입니다. CEHUB 비밀번호를 입력하지 마세요. 작성한 글은 공개됩니다.

2. 상태와 로그를 확인합니다

   cehub-web status
   cehub-web logs
   cehub-web stop

   계정당 백엔드 작업 하나를 관리합니다. 시작 시 Slurm에 제출하므로 자원이 부족하면 대기합니다. 실행 중에는 API 주소로 접속할 수 있고, 작업이 없거나 끝나면 API에 503이 표시됩니다.

3. 자신의 서버로 바꿉니다

   서버 코드는 공개 폴더 밖의 개인 홈에 보관하세요. 서버는 TCP 포트 대신 CEHUB_WEB_SOCKET 환경변수에 지정된 Unix 소켓에서 HTTP 요청을 받아야 합니다. 필요한 패키지는 자신의 가상환경에 설치하세요.

   # FastAPI: 자신의 환경에 uvicorn 설치 후
   cehub-web start -- bash -c 'exec python -m uvicorn app:app --uds "$CEHUB_WEB_SOCKET"'
   
   # Flask: 자신의 환경에 gunicorn 설치 후
   cehub-web start -- bash -c 'exec gunicorn --bind "unix:$CEHUB_WEB_SOCKET" app:app'
   
   # Node.js: server.listen(process.env.CEHUB_WEB_SOCKET) 사용
   cehub-web start -- node server.js

   프런트엔드에서는 자신의 /학번/api/ 또는 /팀ID/api/ 주소에 fetch로 요청하세요. 예제의 HTML과 서버 코드를 참고할 수 있습니다.

Lab과 백엔드의 수명은 다릅니다. Lab을 종료해도 제출한 백엔드 Slurm 작업은 남은 실행 시간 동안 유지됩니다. 시간 초과·작업 취소·서버 오류·노드 재부팅 시 API 제공은 중단됩니다. 정적 홈페이지는 계속 제공됩니다. 계정 만료나 역할 회수 시에는 둘 다 제공이 중단됩니다.

04 · BEFORE YOU USE

꼭 알아둘 것

05 · COMPUTING

계산 작업은 Slurm으로 관리하세요

Lab에서는 파일을 편집하고 작업을 제출합니다. GPU 학습이나 장시간 계산은 Slurm 작업으로 제출하고, CPU·GPU·메모리는 승인된 자원 범위 안에서 요청하세요.

# 내 작업 상태 확인
squeue -u "$USER"

# 준비한 작업 스크립트 제출
sbatch train.sh

# 필요 없는 내 작업 취소: JOB_ID를 실제 작업 번호로 바꿉니다
scancel JOB_ID

작업이 끝나면 할당 자원은 반환됩니다. 필요 없는 작업은 취소하세요. Lab은 약 4시간 동안 사용하지 않으면 회수될 수 있으므로 저장하지 않은 편집 내용을 남겨두지 마세요.

06 · HELP

문제 해결

chmod 644 ~/public_html/index.html

도움이 필요하면 계정명, 발생 시각, 접속 주소와 오류 문구를 관리자에게 알려주세요. 비밀번호·쿠키·인증 토큰은 보내지 마세요.