문서 목차
Jupyter·VS Code
웹 브라우저에서 바로 쓰는 Jupyter 노트북과 VS Code 개발 환경을 만들고, CPU·메모리·GPU와 저장 공간을 정해 실행합니다.
QUANTUM C&S
웹 브라우저에서 바로 쓰는 Jupyter 노트북과 VS Code 개발 환경을 만들고, CPU · 메모리 · GPU와 저장 공간을 정해 실행합니다.
메뉴 어플리케이션 > Jupyter(/applications/jupyter)와 어플리케이션 > VS Code(/applications/vscode)에서 엽니다. 두 화면은 구성과 사용법이 같으며, 이 문서에서는 Jupyter를 기준으로 설명합니다.
개요
| 항목 | Jupyter | VS Code |
|---|---|---|
| 화면 제목 | Jupyter Notebooks | VS Code 워크스페이스 |
| 만들기 버튼 | 노트북 생성 | 워크스페이스 생성 |
| 기본 이미지 | Jupyter SciPy, Jupyter PyTorch Full, Jupyter PyTorch CUDA, Jupyter TensorFlow Full, Jupyter TensorFlow CUDA | VS Code Python |
| 작업 폴더 | /home/jovyan (워크스페이스 볼륨) |
/home/jovyan (워크스페이스 볼륨) |
작업 공간은 소속 프로젝트의 네임스페이스에 만들어집니다. 프로젝트에 속하지 않은 사용자는 개인 네임스페이스에 만들어집니다.
참고 이전 주소
/notebooks로 접속하면 Jupyter 화면으로 이동합니다.
화면 구성 — 목록
| 영역 | 설명 |
|---|---|
| 톱니바퀴 | 이미지 빌더를 엽니다. 플랫폼 운영 관리자에게만 보입니다(Jupyter 화면). |
| 새로고침 | 목록을 다시 불러옵니다. |
| 노트북 생성 | 새 노트북을 만듭니다. 생성 권한이 없으면 비활성화되고 사유가 표시됩니다. |
| 목록 | 노트북 이름(아래에 네임스페이스), 리소스(CPU · 메모리 · GPU), 상태, 작성자, 생성일, 작업 |
상태
| 상태 | 설명 |
|---|---|
| 실행중 | 사용할 수 있습니다. |
| 대기중 | 시작하는 중입니다. 자원이 모자라면 오래 대기할 수 있습니다. |
| 중지됨 | 멈춘 상태입니다. 작업 폴더의 파일은 남아 있습니다. |
| 종료중 | 멈추거나 삭제되는 중입니다. |
| 오류 | 시작하지 못했습니다. 상세 화면의 상태 조건에서 원인을 확인하세요. |
작업 버튼
| 버튼 | 동작 |
|---|---|
| 연결(바깥 화살표) | 노트북을 새 탭으로 엽니다. 준비되지 않았으면 누를 수 없습니다. |
| 중지(사각형) | 실행 중이거나 대기 중인 노트북을 멈춥니다. |
| 시작(재생) | 중지된 노트북을 다시 시작합니다. |
| 삭제(휴지통) | 노트북을 삭제합니다. 되돌릴 수 없습니다. |
참고 노트북 연결은 작성자만 할 수 있습니다(운영 관리자 제외). 다른 사람의 노트북에서 연결을 누르면 "작성자만 노트북에 연결할 수 있습니다."가 표시됩니다.
따라 하기: 노트북 만들기
1단계: 만들기 창 열기
노트북 생성을 누릅니다.
2단계: 이름과 이미지 정하기
| 항목 | 설명 | 규칙 |
|---|---|---|
| 노트북 이름 | 예: my-notebook |
필수 · 소문자, 숫자, 하이픈만 |
| 이미지 | 커스텀 이미지(이미지 빌더로 만든 것), Kubeflow Official(기본 이미지), 기타 > 직접 이미지 URL 입력... 중에서 고릅니다. | 직접 입력 시 이미지 주소 필수 |
3단계: 리소스 정하기
프리셋 버튼을 누르거나 값을 직접 입력합니다.
| 프리셋 | CPU | 메모리 | GPU |
|---|---|---|---|
| Small (기본값) | 0.5 | 1Gi | 0 |
| Medium | 1 | 2Gi | 0 |
| Large | 2 | 4Gi | 0 |
| GPU Small | 2 | 4Gi | 1 |
| GPU Large | 4 | 8Gi | 2 |
4단계: 볼륨 설정하기
워크스페이스 크기를 5 GB · 10 GB(기본값) · 20 GB · 50 GB · 100 GB 중에서 고릅니다. 이 볼륨이 /home/jovyan에 연결되어 노트북을 멈췄다 다시 시작해도 파일이 남습니다.
프로젝트에 저장 공간 한도가 있으면 "프로젝트 저장 공간: 사용 … / 한도 … (남음 …)"이 표시되고, 남은 양을 넘는 크기는 고를 수 없습니다. 남은 공간으로 만들 수 없으면 쓰지 않는 볼륨을 정리하거나 팀장 · 운영 관리자에게 쿼터 증설을 요청하세요.
5단계: 버킷 마운트 고르기
버킷 마운트에서 노트북 안에서 파일처럼 쓸 S3 버킷을 고릅니다.
| 구분 | 설명 |
|---|---|
| 개인 버킷 | 내 개인 저장소 |
| 소속 프로젝트 팀 버킷 | 내가 속한 프로젝트의 버킷 |
| 공용 버킷 | 플랫폼 공용 버킷 |
버킷마다 읽기 · 쓰기 또는 읽기 전용 배지가 붙습니다. 읽기 전용 버킷의 경로에는 쓰기 · 삭제가 거부됩니다. 마운트 경로는 /home/jovyan/ 또는 /mnt/ 아래로 정할 수 있습니다. 기본 경로는 개인 /home/jovyan/data, 팀 /home/jovyan/data-team/<버킷>, 공용 /home/jovyan/data-public/<버킷> 형태입니다.
참고 고른 버킷은 노트북 소유자 본인의 접속 키로 마운트됩니다. 키는 화면에 나오지 않고 노트북 안에서도 읽을 수 없습니다. 권한이 회수되면 다음 시작부터 그 버킷은 마운트되지 않습니다.
6단계: 생성하기
생성 버튼을 누르면 목록에 노트북이 대기중으로 나타나고, 준비되면 실행중으로 바뀝니다. 연결 아이콘을 눌러 여세요.
주의 소속 프로젝트가 여러 개이면 어느 네임스페이스에 만들지 정해야 하므로 생성이 거부되고 후보 목록이 표시됩니다. 이 경우 SAMANDA에게 프로젝트를 지정해 만들어 달라고 요청하세요.
화면 구성 — 상세
목록에서 노트북 이름을 누르면 상세 화면이 열립니다.
| 영역 | 설명 |
|---|---|
| 머리글 | 이름, 상태, 새로고침 · 연결 · 중지/시작 · 삭제 버튼 |
| 기본 정보 | 노트북 이름, 네임스페이스, 생성일, 실행 단위 이름 |
| 컨테이너 이미지 | 사용 중인 이미지 |
| 리소스 | CPU · 메모리 · GPU 설정값과 현재 사용량. 30초마다 자동 갱신되며 메트릭 새로고침으로 바로 갱신합니다. |
| 상태 조건 | 시작 과정의 상태(유형 · 상태 · 원인 · 최근 업데이트) |
| 볼륨 | 워크스페이스 볼륨과 마운트된 버킷의 마운트 경로 · 용량 · 사용량 |
리소스 바꾸기
리소스의 수정을 눌러 CPU · 메모리 · GPU를 바꾸고 저장합니다. 변경은 노트북을 다시 시작해야 적용됩니다.
볼륨 확장하기
볼륨 카드의 확장을 눌러 새 크기를 입력하고 적용을 누릅니다. 볼륨은 늘리기만 할 수 있고 줄일 수 없으며, 노트북을 다시 시작해야 적용됩니다.
노트북 안에서 SAMANDA 쓰기
SAMANDA 확장이 들어 있는 이미지로 만든 Jupyter · VS Code에서는 편집기 옆 패널에서 SAMANDA와 대화할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 로그인 | 따로 로그인하지 않습니다. 노트북 소유자 본인의 접근 토큰으로 자동 연결됩니다. |
| 작업 맥락 | Jupyter에서는 지금 열려 있는 노트북과 선택한 셀 정보가 SAMANDA에게 함께 전달됩니다. |
| 권한 | 노트북 소유자 본인의 권한으로 동작하며, 작업 기록도 소유자 이름으로 남습니다. |
참고 기본 이미지 중 어떤 이미지에 SAMANDA 확장이 들어 있는지는 운영 환경에 따라 다릅니다. 확장이 없는 이미지에서는 SAMANDA 패널이 나타나지 않습니다.
이미지 빌더(운영 관리자)
Jupyter 화면의 톱니바퀴를 누르면 필요한 패키지를 넣은 커스텀 Jupyter 이미지를 만들 수 있습니다.
| 항목 | 설명 |
|---|---|
| 이미지 이름 · 태그 | 만들 이미지의 이름과 태그 |
| 베이스 이미지 | 기반이 되는 이미지 |
| pip 패키지 · apt 패키지 | 한 줄에 하나씩 입력합니다. |
| Dockerfile 생성 / Dockerfile 편집 | 빌드 전에 Dockerfile을 확인하고 고칠 수 있습니다. |
| 빌드 목록 | 빌드 상태(빌드 중 · 사용 가능 · 실패)와 로그 |
빌드가 끝나 사용 가능이 된 이미지는 노트북 생성 창의 커스텀 이미지에 나타납니다.
권한
| 작업 | 누가 |
|---|---|
| 만들기 | 노트북 생성 권한이 있는 사용자 |
| 연결 | 작성자, 운영 관리자 |
| 시작 · 중지 · 삭제 · 리소스 변경 | 작성자, 그룹 관리자, 시스템 관리자. 권한이 없으면 "권한이 없습니다. 작성자, 그룹 관리자 또는 시스템 관리자만 이 작업을 수행할 수 있습니다."가 표시됩니다. |
| 이미지 빌더 | 플랫폼 운영 관리자 |