Skip to main content

Launch란 무엇인가요

Colab에서 사용해 보기

이 튜토리얼은 ML 실무자와 플랫폼 팀을 위해 W&B Launch를 소개하고, Launch 작업 생성, 큐 설정, 에이전트 연결, 실행할 작업 제출 과정을 안내합니다. 튜토리얼을 마치면 W&B Launch를 통해 컨테이너화된 ML 워크로드를 실행하고, 팀에서 재사용할 수 있는 작동 중인 큐와 에이전트를 갖추게 됩니다. W&B Launch를 사용하면 트레이닝 run을 데스크톱에서 Amazon SageMaker, Kubernetes 등의 컴퓨팅 리소스로 확장할 수 있습니다. Launch를 설정하면 몇 번의 클릭과 명령어로 트레이닝 스크립트와 모델 평가 도구 모음을 실행하고, 프로덕션 추론용 모델을 준비하는 등 다양한 작업을 수행할 수 있습니다.

How it works

Launch는 세 가지 기본 컴포넌트로 구성됩니다: Launch 작업, Launch 큐, 에이전트. Launch 작업은 ML 워크플로에서 작업을 설정하고 실행하기 위한 청사진입니다. Launch 작업이 있으면 이를 Launch 큐에 추가할 수 있습니다. Launch 큐는 FIFO 큐로, Amazon SageMaker 또는 Kubernetes 클러스터와 같은 특정 컴퓨팅 리소스 대상에 작업을 설정하고 제출할 수 있습니다. 작업이 큐에 추가되면 Launch 에이전트가 해당 큐를 폴링하고 큐가 대상으로 하는 시스템에서 작업을 실행합니다.
W&B Launch overview diagram
사용 사례에 따라 본인(또는 팀의 누군가)이 선택한 컴퓨팅 리소스 대상(예: Amazon SageMaker)에 따라 Launch 큐를 설정하고 자체 인프라에 Launch 에이전트를 배포합니다. Launch에 대한 자세한 내용은 Terms and concepts 페이지를 참조하세요.

Get started

사용 사례에 따라 다음 리소스를 탐색하여 W&B Launch를 시작하세요:

워크스루

이 페이지는 W&B Launch 워크플로의 기본 개념을 워크스루합니다.
W&B Launch은 머신 러닝 워크로드를 컨테이너에서 실행합니다. 컨테이너에 대한 지식은 필수가 아니지만 이 워크스루에 도움이 될 수 있습니다. 컨테이너에 대한 입문서는 도커 문서를 참조하세요.

사전 요구 사항

시작하기 전에 다음 사전 요구 사항을 충족했는지 확인하세요. 이 요구 사항은 이 워크스루에서 나중에 명령어를 실행하는 데 필요한 계정, 도구 및 인증을 다룹니다.
  1. https://wandb.ai/site 에서 계정을 등록한 후 W&B 계정에 로그인하세요.
  2. 이 워크스루는 작동하는 도커 CLI와 엔진이 있는 머신에 대한 터미널 액세스가 필요합니다. 자세한 내용은 도커 설치 가이드를 참조하세요.
  3. W&B Python SDK 버전 0.17.1 이상을 설치하세요:
  4. 터미널에서 wandb login을 실행하거나 WANDB_API_KEY 환경 변수를 설정하여 W&B에 인증하세요.
터미널에서 다음을 실행하세요:

Launch 작업 만들기

Launch 작업은 Launch가 실행할 워크로드의 청사진입니다. 따라서 큐에 작업을 제출하기 전에 Launch 작업이 필요합니다. Launch 작업을 Launch 작업 만드는 방법은 세 가지가 있습니다: 도커 이미지를 사용하거나, git 저장소에서 만들거나, 로컬 소스 코드에서 만드는 것입니다:
미리 만들어진 컨테이너를 실행하여 W&B에 메시지를 로깅하려면 터미널을 열고 다음 명령어를 실행하세요:
위 명령어는 컨테이너 이미지 wandb/job_hello_world:main을 다운로드하고 실행합니다.Launch는 wandb로 로깅된 모든 내용을 launch-quickstart 프로젝트에 보고하도록 컨테이너를 설정합니다. 컨테이너는 W&B에 메시지를 로깅하고 W&B의 run 링크를 표시합니다. 링크를 클릭하여 W&B UI에서 run을 확인하세요.

큐 만들기

Launch 작업이 준비되면 다음 단계는 작업을 실행할 위치와 방식을 정의하는 큐를 만드는 것입니다. Launch는 팀이 공유 컴퓨트를 중심으로 워크플로를 구축하도록 지원합니다. 지금까지의 예시에서 wandb launch 명령어는 로컬 머신에서 컨테이너를 동기적으로 실행했습니다. Launch 큐와 에이전트를 사용하면 공유 리소스에서 작업을 비동기적으로 실행하고 우선순위 지정, 하이퍼파라미터 최적화 같은 고급 기능을 활용할 수 있습니다. 기본 큐를 만들려면 다음 단계를 따르세요:
  1. https://forge.coreweave.com/wandb/launch로 이동하여 큐 만들기 버튼을 클릭하세요.
  2. 큐를 연결할 entity를 선택하세요.
  3. 큐 이름을 입력하세요.
  4. 리소스로 도커를 선택하세요.
  5. 설정은 비워 두세요.
  6. 큐 만들기를 클릭하세요.
버튼을 클릭하면 브라우저가 큐 뷰의 에이전트 탭으로 이동합니다. 에이전트가 폴링을 시작할 때까지 큐는 비활성 상태로 유지됩니다.
Docker 큐 만들기
고급 큐 설정 옵션은 고급 큐 설정 페이지를 참조하세요.

큐에 에이전트 연결

큐는 에이전트가 폴링할 때까지 유휴 상태로 유지되므로, 작업을 실행하려면 먼저 에이전트를 연결해야 합니다. 큐 뷰는 폴링 에이전트가 없는 경우 화면 상단의 빨간 배너에 에이전트 추가 버튼을 표시합니다. 버튼을 클릭하여 에이전트를 실행하는 명령어를 보고 복사하세요. 명령어는 다음과 같아야 합니다:
[QUEUE-NAME]을 큐 이름으로, [ENTITY-NAME]을 W&B entity로 바꾸세요. 터미널에서 명령어를 실행하여 에이전트를 시작하세요. 에이전트는 지정된 큐에서 실행할 작업을 폴링합니다. 작업을 수신하면 에이전트는 해당 작업을 위한 이미지를 다운로드하거나 구축한 후 실행합니다. 마치 로컬에서 wandb launch 명령어를 실행한 것처럼요. the Launch page로 다시 이동하여 큐가 이제 Active로 표시되는지 확인하세요.

큐에 작업 제출하기

큐와 폴링 에이전트가 준비되었으므로, 앞서 생성한 Launch 작업 중 하나를 제출하고 공유 컴퓨트에서 실행되는 모습을 확인할 수 있습니다. W&B 계정의 launch-quickstart 프로젝트로 이동하고 화면 왼쪽 내비게이션에서 작업 탭을 여세요. Jobs 페이지에는 이전 run에서 생성된 작업 목록이 표시됩니다. Launch 작업을 클릭하면 소스 코드, 의존성, 해당 작업에서 생성된 run을 확인할 수 있습니다. 이 워크스루를 완료하면 목록에 작업 세 개가 포함됩니다. 작업 중 하나를 선택하고 다음 지침에 따라 큐에 제출하세요:
  1. Launch 버튼을 클릭하여 작업을 큐에 제출하세요. Launch 서랍이 나타납니다.
  2. 앞서 생성한 큐를 선택하고 Launch를 클릭하세요.
이렇게 하면 작업이 큐에 제출됩니다. 이 큐를 폴링하는 에이전트가 작업을 가져와 실행합니다. W&B UI에서 또는 터미널에서 에이전트의 출력을 확인하여 작업 진행 상황을 모니터링할 수 있습니다. wandb launch 명령어는 --queue 인수를 지정하여 작업을 큐에 직접 푸시할 수 있습니다. 예를 들어 hello-world 컨테이너 작업을 큐에 제출하려면 다음 명령어를 실행하세요:
[QUEUE-NAME]을 큐 이름으로 바꾸세요. 이제 Launch 작업, 큐, 큐를 폴링하는 에이전트, 공유 컴퓨트에서 비동기적으로 실행되는 작업으로 구성된 완전한 W&B Launch 워크플로가 준비되었습니다. 이 패턴을 자체 트레이닝, 평가 및 추론 워크로드에 재사용할 수 있습니다.
마지막 수정일 2026년 9월 30일