> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Job 이해하기

> VESSL Cloud의 배치 잡이 무엇이고 언제 사용하면 좋은지 알아봐요.

<Tip>
  **Job은 VESSL Cloud나 CLI로 만들 수 있어요.** Jobs 페이지에서 **Create Job**을 누르면 폼으로 만들 수 있고, `vesslctl job` 명령으로 제출, 모니터링, 종료, 태그 관리를 터미널에서 처리할 수도 있어요. 컨테이너 이미지, 볼륨 마운트, 환경 변수까지 한 줄로 지정해요. 한 페이지로 정리된 [CLI 치트 시트](/ko/cli/cheatsheet)나 [vesslctl job](/ko/cli/commands/job) 문서를 참고하세요.
</Tip>

[**Job**](/ko/guides/get-started/glossary#job)은 지정된 GPU 또는 CPU 리소스에서 명령어를 실행하고 완료되면 자동으로 종료돼요. Workspace와 달리 비대화형(non-interactive)이라, 파인튜닝 스크립트나 평가 파이프라인을 제출해 두면 알아서 끝까지 돌아가요.

배치 잡은 이런 작업에 적합해요:

* 모델 학습과 파인튜닝
* 배치 추론과 평가
* 데이터 전처리 파이프라인
* 하이퍼파라미터 스윕(hyperparameter sweep): 여러 Job을 동시에 실행

<div>
  <Frame>
    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/dora/7JB7El29TavR1keb/images/vessl-cloud-jobs-list.jpg?fit=max&auto=format&n=7JB7El29TavR1keb&q=85&s=82c1993637c60f549d0cc1c4d1ccd3de" alt="Job 이름, 상태, 리소스, 소요 시간, 생성자가 보이는 VESSL Cloud Jobs 목록 페이지" width="7680" height="4320" data-path="images/vessl-cloud-jobs-list.jpg" />
  </Frame>

  <small>예시: Jobs 목록 페이지</small>
</div>

## Job vs Workspace

|            | Job             | Workspace                        |
| ---------- | --------------- | -------------------------------- |
| **상호작용**   | 비대화형(명령어 실행)    | 대화형(SSH, JupyterLab)             |
| **생명주기**   | 시작 → 실행 → 자동 완료 | 일시정지 또는 종료할 때까지 실행 유지            |
| **과금**     | 실행 중에만          | 실행 중에는 GPU와 스토리지, 일시정지 중에는 스토리지만 |
| **적합한 용도** | 학습, 배치 처리, 스윕   | 개발, 디버깅, 탐색                      |

## Job 상태

| 상태           | 의미                                                                         |
| ------------ | -------------------------------------------------------------------------- |
| `scheduling` | 리소스가 확보될 때까지 대기하는 상태예요. *Waiting for GPU capacity*처럼 대기열에 들어간 이유가 함께 표시돼요. |
| `running`    | 명령어가 할당된 리소스에서 실제로 실행되고 있어요.                                               |
| `succeeded`  | 명령어가 성공적으로 끝났어요(exit code `0`). 연결된 볼륨에 저장된 결과는 유지돼요.                      |
| `failed`     | 명령어가 0이 아닌 코드로 종료됐거나 컨테이너가 비정상 종료됐어요(예: `OOMKilled`). 로그를 확인해 원인을 파악하세요.   |
| `terminated` | Job이 끝나기 전에 사용자가 직접 취소했어요.                                                 |

## 다음 단계

* [Job 목록 조회하기](/ko/member/job/list): 배치 잡 둘러보기, 필터링, 검색
* [Job 만들기](/ko/member/job/create): VESSL Cloud나 CLI로 만들기
* [Workspace를 Job으로 변환하기](/ko/member/workspace/convert-to-job): Workspace의 이미지, 리소스, 볼륨 재사용하기
* [Job 상세 정보 보기](/ko/member/job/details): 명령어, 이미지, 환경 변수, 볼륨, 태그 확인
* [로그 보기](/ko/member/job/logs): 컨테이너 출력 실시간 스트리밍
* [메트릭 모니터링하기](/ko/member/job/metrics): GPU, VRAM, CPU, 메모리 사용량 추적
* [Job 정리하기](/ko/member/job/cleanup): 실행 중인 Job을 종료하거나 완료된 Job 숨기기
* 전체 CLI 레퍼런스: [`vesslctl job`](/ko/cli/commands/job)
