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

# 작업을 큐에 추가

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

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

<Note>
  본인 또는 팀의 다른 구성원이 이미 launch queue를 설정했는지 확인하세요. 자세한 내용은 [Launch 설정](/ko/platform/launch/set-up-launch/) 페이지를 참조하세요.
</Note>

<div id="add-jobs-to-your-queue">
  ## 큐에 작업 추가
</div>

W\&B App에서 대화형으로 또는 W\&B CLI로 프로그래밍 방식으로 큐에 작업을 추가할 수 있습니다.

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

    1. W\&B 프로젝트 페이지로 이동합니다.
    2. 프로젝트 사이드바에서 **Jobs** 아이콘을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/w-lBKSCruauC3-2f/images/launch/project_jobs_tab_gs.png?fit=max&auto=format&n=w-lBKSCruauC3-2f&q=85&s=7654e23762fa32fbc0d269330d1cca3f" alt="프로젝트 Jobs 탭" width="2177" height="1353" data-path="images/launch/project_jobs_tab_gs.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/mmuC1X8m1VKb0ElQ/images/launch/view_jobs.png?fit=max&auto=format&n=mmuC1X8m1VKb0ElQ&q=85&s=e8cd40f30fbaf24b71f4a4bd696360ad" alt="Jobs 목록" width="2156" height="1058" data-path="images/launch/view_jobs.png" />
    </Frame>

    4. 작업 이름 옆에 있는 **Launch** 버튼을 선택합니다. 그러면 모달이 나타납니다.
    5. **Job version** 드롭다운에서 사용할 Launch 작업 버전을 선택합니다. Launch 작업은 다른 [W\&B artifact](/ko/models/artifacts/create-a-new-artifact-version/)와 마찬가지로 버전 관리됩니다. 작업 실행에 사용된 소프트웨어 의존성이나 소스 코드를 수정하면 W\&B는 동일한 Launch 작업의 새 버전을 생성합니다.
    6. **Overrides** 섹션에서 Launch 작업에 설정된 입력값에 새 값을 지정합니다. 일반적인 override로는 새 entrypoint command, 인수 또는 새 W\&B run의 `wandb.Run.config` 값이 있습니다.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/w-lBKSCruauC3-2f/images/launch/create_starter_queue_gs.png?fit=max&auto=format&n=w-lBKSCruauC3-2f&q=85&s=55cc7a535363d8332976283dc4d16b34" alt="큐 설정" width="1241" height="1038" data-path="images/launch/create_starter_queue_gs.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/w-lBKSCruauC3-2f/images/launch/team_member_use_config_template.png?fit=max&auto=format&n=w-lBKSCruauC3-2f&q=85&s=eb098389caaebde7b42e10a15d3b4f62" alt="설정 템플릿 선택" width="1092" height="1790" data-path="images/launch/team_member_use_config_template.png" />
    </Frame>

    10. 결과 run이 표시될 **Destination project**를 선택합니다. 이 프로젝트는 큐와 동일한 entity에 속해야 합니다.
    11. **Launch now** 버튼을 선택합니다.

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

  <Tab title="W&B CLI">
    `wandb launch` command를 사용하여 큐에 작업을 추가합니다. 예를 들어, [퀵스타트](/ko/platform/launch/walkthrough/) 가이드의 스크립트를 사용해 다음과 같은 하이퍼파라미터 override가 포함된 JSON 파일을 만드세요.

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

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

    큐 설정을 override하려는 경우 또는 launch queue에 설정 리소스가 정의되어 있지 않은 경우에는 `config.json` 파일에 `resource_args` 키를 지정하세요. 예를 들어, 앞의 예시를 계속 사용하면 `config.json` 파일은 다음과 비슷합니다.

    ```json title="config.json" theme={null}
    {
      "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={null}
    wandb launch -j [JOB-NAME] -q [QUEUE-NAME] \
    -e [ENTITY-NAME] -c path/to/config.json
    ```

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

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