> ## 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.

# 큐에 작업 추가

> App UI 또는 CLI를 사용하여 W&B Launch 큐에 Launch 작업을 추가하고, 대상 리소스에서 ML 워크로드를 예약하세요.

이 페이지에서는 Launch 큐에 Launch 작업을 추가하는 방법을 설명합니다. 큐에 작업을 추가하면 해당 작업이 큐의 대상 리소스에서 실행되도록 제출됩니다. 이를 통해 팀에서 설정한 컴퓨팅 환경에 ML 워크로드를 예약할 수 있습니다.

<Note>
  본인 또는 팀원이 Launch 큐를 미리 설정해 두었는지 확인하세요. 자세한 내용은 [Launch 설정](/ko/products/wandb/platform/launch/set-up-launch)을 참조하세요.
</Note>

<h2 id="add-jobs-to-your-queue">
  큐에 작업 추가하기
</h2>

W\&B App에서 대화형으로 추가하거나, W\&B CLI를 사용해 프로그래밍 방식으로 큐에 작업을 추가할 수 있습니다.

<Tabs>
  <Tab title="W&B App">
    W\&B App에서 대화형으로 큐에 작업을 추가하려면 다음 단계를 따르세요.

    1. W\&B 프로젝트 페이지로 이동하세요.
    2. 프로젝트 사이드바에서 **Jobs**를 클릭하세요. 사이드바에 표시되지 않으면 사이드바에서 \*\*More (<Icon icon="ellipsis" iconType="solid" />)\*\*를 클릭한 다음 **Jobs**를 클릭하세요.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/platform/_media/project_jobs_tab_gs.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=3cb6a60a1453719bf3ea6ab6bb1c5026" alt="Forge의 프로젝트 사이드바에서 Jobs 아이콘이 강조 표시되고 툴팁이 표시된 모습" width="542" height="543" data-path="products/wandb/platform/_media/project_jobs_tab_gs.png" />
    </Frame>

    3. **Jobs** 페이지에는 이전에 실행한 W\&B run에서 생성된 W\&B Launch 작업 목록이 표시됩니다.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/platform/_media/view_jobs.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=7b24a4a1828bda284d47ea7a081b57ad" alt="작업 목록" width="2044" height="944" data-path="products/wandb/platform/_media/view_jobs.png" />
    </Frame>

    4. 작업 이름 옆에 있는 **Launch** 버튼을 선택하세요. 모달이 표시됩니다.
    5. **Job version** 드롭다운에서 사용할 Launch 작업 버전을 선택하세요. Launch 작업은 다른 [W\&B 아티팩트](/ko/products/wandb/artifacts/create-a-new-artifact-version)와 마찬가지로 버전별로 관리됩니다. 작업 실행에 사용하는 소프트웨어 의존성이나 소스 코드를 수정하면 W\&B가 같은 Launch 작업의 새 버전을 생성합니다.
    6. **Overrides** 섹션에서 Launch 작업에 설정된 입력값에 새 값을 지정하세요. 주로 재정의하는 항목으로는 새 엔트리포인트 명령, 인수, 새 W\&B run의 `wandb.Run.config` 값 등이 있습니다.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/platform/_media/create_starter_queue_gs.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=7382ccec137b1bbb3f26bbc72eb57abf" alt="큐 설정" width="1241" height="1038" data-path="products/wandb/platform/_media/create_starter_queue_gs.png" />
    </Frame>

    해당 Launch 작업을 사용한 다른 W\&B run의 값을 복사해 붙여 넣으려면 **Paste from...** 버튼을 선택하세요.
    7\. **Queue** 드롭다운에서 Launch 작업을 추가할 Launch 큐의 이름을 선택하세요.
    8\. **Job Priority** 드롭다운에서 Launch 작업의 우선순위를 지정하세요. Launch 큐가 우선순위 지정을 지원하지 않으면 W\&B가 우선순위를 `Medium`으로 설정합니다.
    9\. 선택: 이 단계는 팀 관리자가 큐 설정 템플릿을 만든 경우에만 수행하세요. **Queue Configurations** 필드에서 팀 관리자가 만든 설정 옵션의 값을 지정하세요. 예를 들어 다음 이미지는 팀 관리자가 팀에서 사용할 수 있는 AWS 인스턴스 유형을 설정한 모습입니다. 이 경우 팀 구성원은 모델 학습에 사용할 컴퓨팅 인스턴스 유형으로 `ml.m4.xlarge` 또는 `ml.p3.xlarge` 중 하나를 선택할 수 있습니다.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/platform/_media/team_member_use_config_template.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=98a9dcce0c8d03895051fef7bbd7c0f9" alt="설정 템플릿 선택" width="1092" height="1790" data-path="products/wandb/platform/_media/team_member_use_config_template.png" />
    </Frame>

    10. 실행 결과 run이 표시될 **Destination project**를 선택하세요. 이 프로젝트는 큐와 같은 entity에 속해야 합니다.
    11. **Launch now** 버튼을 선택하세요.

    이제 작업이 큐에 추가되어 큐의 대상 리소스에서 실행됩니다. 실행 결과 run은 선택한 대상 프로젝트에 표시됩니다.
  </Tab>

  <Tab title="W&B CLI">
    `wandb launch` 명령을 사용하여 큐에 작업을 추가하세요. 예를 들어 [퀵스타트](/ko/products/wandb/platform/launch/walkthrough) 가이드의 스크립트를 사용한다면, 다음과 같이 재정의할 하이퍼파라미터 값을 담은 JSON 파일을 만드세요.

    ```json title="config.json" theme={"system"}
    {
      "overrides": {
          "args": [],
          "run_config": {
              "learning_rate": 0,
              "epochs": 0
          },   
          "entry_point": []
      }
    }
    ```

    <Note>
      JSON 설정 파일을 제공하지 않으면 W\&B Launch는 기본 매개변수를 사용합니다.
    </Note>

    큐 설정을 재정의하려면, 또는 launch 큐에 설정 리소스가 정의되어 있지 않다면 `config.json` 파일에 `resource_args` 키를 지정하세요. 예를 들어 앞의 예시를 이어 가면 `config.json` 파일은 다음과 비슷한 형태가 됩니다.

    ```json title="config.json" theme={"system"}
    {
      "overrides": {
          "args": [],
          "run_config": {
              "learning_rate": 0,
              "epochs": 0
          },
          "entry_point": []
      },
      "resource_args": {
            "[RESOURCE-TYPE]" : {
                "[KEY]": "[VALUE]"
            }
      }
    }
    ```

    대괄호로 묶인 자리 표시자를 실제 값으로 바꾸세요.

    `queue` (`-q`) 플래그에는 큐 이름을, `job` (`-j`) 플래그에는 작업 이름을, `config` (`-c`) 플래그에는 설정 파일 경로를 지정하세요.

    ```bash theme={"system"}
    wandb launch -j [JOB-NAME] -q [QUEUE-NAME] \
    -e [ENTITY-NAME] -c path/to/config.json
    ```

    W\&B 팀에서 작업하는 경우 `entity` 플래그(`-e`)를 사용하여 큐가 사용할 entity를 지정하세요.

    명령이 성공하면 작업이 지정한 큐에 추가되고, 큐의 대상 리소스에서 실행됩니다.
  </Tab>
</Tabs>
