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

# Launch 용어 및 개념

> W&B Launch의 주요 개념인 작업, 큐, 대상 리소스, agents, agent environments에 대해 알아보세요.

이 페이지는 W\&B Launch 문서 전체에서 사용되는 핵심 용어와 개념을 정의합니다. 설정 가이드, 튜토리얼 또는 W\&B App에서 익숙하지 않은 용어를 만났을 때 참고하세요.

W\&B Launch를 사용하면 [작업](#launch-job)을 [큐](#launch-queue)에 대기열에 넣어 runs를 생성합니다. 작업은 W\&B로 계측된 Python 스크립트입니다. 큐는 [대상 리소스](#target-resources)에서 실행할 작업 목록을 보관합니다. [Agents](#launch-agent)는 큐에서 작업을 가져와 대상 리소스에서 실행합니다. W\&B는 Launch 작업을 [runs](/ko/products/wandb/runs)를 추적하는 방식과 유사하게 추적합니다.

다음 섹션에서는 이러한 각 개념을 자세히 설명합니다.

<h2 id="launch-job">
  Launch 작업
</h2>

Launch 작업은 완료해야 할 태스크를 나타내는 특정 유형의 [W\&B 아티팩트](/ko/products/wandb/artifacts)입니다. 대표적인 Launch 작업으로는 모델 트레이닝이나 모델 평가 트리거 등이 있습니다. 작업 정의에는 다음 항목이 포함됩니다.

* 실행 가능한 진입점을 하나 이상 포함하는 Python 코드 및 기타 파일 에셋
* 입력(설정 매개변수)과 출력(로깅된 메트릭)에 대한 정보
* 환경에 대한 정보(예: `requirements.txt`, 기본 `Dockerfile`)

작업 정의는 크게 세 가지 유형으로 나뉩니다.

| 작업 유형 | 정의 | 이 작업 유형을 실행하는 방법 |
| - | - | - |
| 아티팩트 기반(또는 코드 기반) 작업 | 코드와 기타 에셋이 W\&B 아티팩트로 저장됩니다. | 아티팩트 기반 작업을 실행하려면 Launch agent에 빌더를 설정해야 합니다. |
| Git 기반 작업 | 코드와 기타 에셋을 git 저장소의 특정 커밋, 브랜치 또는 태그에서 클론합니다. | Git 기반 작업을 실행하려면 Launch agent에 빌더와 git 저장소 자격 증명을 설정해야 합니다. |
| 이미지 기반 작업 | 코드와 기타 에셋이 Docker 이미지에 포함되어 있습니다. | 이미지 기반 작업을 실행하려면 Launch agent에 이미지 저장소 자격 증명을 설정해야 할 수도 있습니다. |

<Note>
  Launch 작업은 모델 트레이닝 외의 작업(예: Triton 추론 서버에 모델 배포)도 수행할 수 있지만, 작업이 성공적으로 완료되려면 반드시 `wandb.init()`을 호출해야 합니다. 이 호출은 W\&B Workspace에 추적용 run을 생성합니다.
</Note>

생성한 작업은 W\&B App의 프로젝트 Workspace에 있는 **Jobs** 탭에서 확인할 수 있습니다. 이 탭에서 작업을 설정한 뒤 [Launch 큐](#launch-queue)로 보내 다양한 [대상 리소스](#target-resources)에서 실행할 수 있습니다.

<h2 id="launch-queue">
  Launch 큐
</h2>

Launch *큐*는 특정 대상 리소스에서 실행할 작업의 정렬된 목록입니다. Launch 큐는 first-in, first-out (FIFO)입니다. 실질적인 제한은 큐 수에 적용되지 않지만, 좋은 지침은 대상 리소스당 하나의 큐입니다. W\&B App UI, W\&B CLI 또는 Python SDK를 사용하여 작업을 큐에 추가할 수 있습니다. 그런 다음 하나 이상의 Launch agents를 구성하여 큐에서 항목을 가져와 큐의 대상 리소스에서 실행할 수 있습니다.

<h2 id="target-resources">
  대상 리소스
</h2>

Launch 큐가 작업을 실행하는 컴퓨팅 환경을 *대상 리소스*라고 합니다.

W\&B Launch는 다음 대상 리소스를 지원합니다.

* [Docker](/ko/products/wandb/platform/launch/setup-launch-docker)
* [Kubernetes](/ko/products/wandb/platform/launch/setup-launch-kubernetes)
* [AWS SageMaker](/ko/products/wandb/platform/launch/setup-launch-sagemaker)
* [Google Cloud Vertex AI](/ko/products/wandb/platform/launch/setup-vertex)

대상 리소스마다 허용하는 설정 매개변수가 다르며, 이를 *리소스 설정*이라고 합니다. 리소스 설정에는 각 Launch 큐에 정의된 기본값이 적용되지만, 작업별로 개별 재정의할 수 있습니다. 자세한 내용은 각 대상 리소스의 문서를 참조하세요.

<h2 id="launch-agent">
  Launch agent
</h2>

Launch agent는 가볍고 지속적으로 실행되는 프로그램으로, Launch 큐를 주기적으로 확인하여 실행할 작업을 찾습니다. Launch agent가 작업을 받으면, 먼저 작업 정의에서 이미지를 빌드하거나 가져온 다음, 대상 리소스에서 실행합니다.

하나의 agent는 여러 큐를 폴링할 수 있습니다. 그러나 폴링하는 각 큐의 백킹 대상 리소스를 모두 지원하도록 agent를 올바르게 구성해야 합니다.

<h2 id="launch-agent-environment">
  Launch agent environment
</h2>

agent environment는 Launch agent가 실행되며 작업을 폴링하는 환경입니다.

<Note>
  agent의 런타임 환경은 큐의 대상 리소스와 독립적입니다. 즉, 필요한 대상 리소스에 충분히 액세스할 수 있도록 구성하기만 하면 어디서든 agent를 배포할 수 있습니다.
</Note>
