JupyterLab

이 페이지는 미리 구성된 Apptainer 컨테이너를 사용하여 HPC 클러스터에서 대화형 작업으로 JupyterLab 인스턴스를 시작하는 방법을 설명합니다.

작업 제출 탭

일반 작업과 유사하게, 양식에는 “새 작업”, “배치 스크립트”, “설정”과 같은 탭이 포함됩니다. 이 가이드는 JupyterLab을 시작하기 위한 “새 작업” 탭에 중점을 둡니다.

새 작업 탭

1. 작업 스케줄러 옵션

JupyterLab 세션에 필요한 리소스를 구성합니다:

• 파티션(Partition): 적절한 파티션을 선택합니다 (예: hpc).
• 작업 이름(Job Name): 이름을 할당합니다 (예: My_Test_Job).
• 노드 수(Number of Nodes): 일반적으로 단일 JupyterLab 인스턴스에는 1로 설정합니다.
• 작업당 CPU 수(CPUs per Task): 세션에 필요한 CPU 코어 수를 지정합니다 (예: 1).
• GPU 모델(GPU Model): 노트북에서 필요한 경우 GPU를 선택합니다.
• 노드당 GPU 수(GPUs per Node): 필요한 GPU 수를 지정합니다 (예: 0 또는 1).
• 작업 디렉토리(Working Directory): JupyterLab이 시작되고 기본적으로 노트북을 저장할 디렉토리입니다.

2. Apptainer 컨테이너 설정

이 설정들은 일반적으로 표준 JupyterLab 환경에 대해 미리 채워져 있습니다:

• 컨테이너 경로 (접두사: jupyter): JupyterLab 환경을 포함하는 Apptainer 이미지의 경로입니다 (예: /home/Containers/jupyter-pytorch_24.12.sif). 이 경로는 중요하며 일반적으로 시스템 관리자가 관리합니다.
• 새 환경 변수(New Environment Variable): 컨테이너 내에서 Jupyter 세션에 필요한 특정 환경 변수를 추가합니다.

3. 제출

• 제출 후 작업 모니터로 리디렉션(Redirect to Job Monitor after submission): 선택하면 제출 후 자동으로 작업 모니터링 페이지로 이동합니다.
• 제출(Submit) 버튼: JupyterLab 세션을 Slurm 작업으로 시작합니다.

작업이 실행되기 시작하면 일반적으로 작업 로그 페이지를 통해 접근할 수 있는 작업 로그 파일에서 연결 정보(토큰이 포함된 URL 등)를 받게 됩니다.

브라우저를 통한 JupyterLab 접근

JupyterLab 작업이 실행되기 시작하면 다음 단계에 따라 웹 브라우저를 통해 직접 접근할 수 있습니다:

1. 작업 모니터에서 작업 상세 페이지로 이동
2. 작업이 실행 중일 때 나타나는 “Open JupyterLab” 버튼을 클릭

3. JupyterLab 로그인 페이지로 리디렉션되며, 여기서 인증이 필요합니다

인증 토큰 사용하기

JupyterLab은 세션을 보호하기 위해 토큰 기반 인증을 사용합니다. 로그인하려면:

1. 작업 상세 페이지에서 “Copy Token” 버튼을 클릭하여 인증 토큰을 클립보드에 복사
2. JupyterLab 로그인 페이지에서 “Password or token” 필드에 토큰을 붙여넣기
3. “Log in” 버튼을 클릭하여 JupyterLab 환경에 접근

노트

토큰은 각 JupyterLab 세션마다 고유하며 영구 비밀번호 없이도 안전하게 인증할 수 있는 방법입니다. 이 토큰을 항상 비공개로 유지하세요.

주의

브라우저 탭을 닫거나 토큰을 분실한 경우, 언제든지 작업 상세 페이지로 돌아가 토큰을 다시 복사할 수 있습니다.

JupyterLab 사용하기

로그인하면 지정한 클러스터 리소스에서 실행되는 완전한 JupyterLab 인터페이스에 접근할 수 있습니다. 다음과 같은 작업이 가능합니다:

• 새 노트북, 텍스트 파일, 터미널 등 생성
• 작업 디렉토리의 파일 접근
• Python 패키지 설치(컨테이너가 허용하는 경우)
• 할당된 CPU/GPU 리소스를 사용한 계산 실행

모든 계산은 작업 제출 시 지정한 리소스를 활용하여 클러스터에서 이루어지며, 인터페이스는 웹 브라우저로 전달됩니다.