- W&B 아티팩트를 생성하고 사용할 수 있습니다.
- W&B Registry에서 Registered Models를 사용하고 생성할 수 있습니다.
- W&B Launch를 사용해 전용 컴퓨팅 리소스에서 트레이닝 작업을 실행할 수 있습니다.
- ops와 asset에서 wandb 클라이언트를 사용할 수 있습니다.
wandb_resource: W&B API에 인증하고 통신하는 데 사용되는 Dagster 리소스입니다.wandb_artifacts_io_manager: W&B 아티팩트를 가져와 사용하는 데 쓰이는 Dagster IO Manager입니다.
시작하기 전에
API 키 설정
- W&B에 로그인합니다. W&B Server를 사용하는 경우 관리자에게 인스턴스 호스트 이름을 문의하세요.
- User Settings에서 API 키를 생성합니다. 프로덕션 환경에서는 해당 키를 service account에서 소유하도록 설정하세요.
- 해당 API 키에 대한 환경 변수를 설정합니다:
export WANDB_API_KEY=<your_api_key>.
wandb_resource를 로드할 때 환경에서 API 키를 읽을 수 있습니다.
다음 예제에서는 Dagster 코드에서 API 키를 어디에 지정해야 하는지 보여줍니다. wandb_config 중첩 딕셔너리 안에 entity와 프로젝트 이름을 지정하세요. 다른 W&B 프로젝트를 사용하려면 서로 다른 op 또는 asset에 서로 다른 wandb_config 값을 전달할 수 있습니다. 전달할 수 있는 키에 대한 자세한 내용은 Configuration 섹션을 참조하세요.
- Config for @job
- Config for @repository using assets
@job용 예시 설정:설정
wandb_resource: W&B API와 통신하는 데 사용하는 Dagster 리소스입니다. 제공된 API 키를 사용해 자동으로 인증합니다. 속성:api_key: (str, required): W&B API와 통신하는 데 필요한 W&B API 키입니다.host: (str, optional): 사용할 API 호스트 서버입니다. W&B Server를 사용하는 경우에만 필요합니다. 기본값은 Public Cloud 호스트인https://api.wandb.ai입니다.
wandb_artifacts_io_manager: W&B 아티팩트를 사용하기 위한 Dagster IO Manager입니다. 속성:base_dir: (int, optional) 로컬 저장소 및 캐싱에 사용하는 기본 디렉터리입니다. W&B 아티팩트와 W&B Run 로그는 이 디렉터리에 기록되고, 이 디렉터리에서 읽어 옵니다. 기본적으로DAGSTER_HOME디렉터리를 사용합니다.cache_duration_in_minutes: (int, optional) W&B 아티팩트와 W&B Run 로그를 로컬 저장소에 얼마나 오래 유지할지 정의합니다. 캐시는 해당 시간 동안 열리지 않은 파일과 디렉터리만 제거합니다. 캐시 정리는 IO Manager 실행이 끝날 때 수행됩니다. 캐싱을 완전히 끄려면 0으로 설정하세요. 캐싱은 동일한 머신에서 실행되는 작업 간에 아티팩트를 재사용할 때 속도를 높여 줍니다. 기본값은 30일입니다.run_id: (str, optional): 재개에 사용되는 이 run의 고유 ID입니다. 프로젝트 내에서 고유해야 하며, run을 삭제하면 해당 ID를 다시 사용할 수 없습니다. 짧은 설명 이름에는 name 필드를 사용하고, runs 간 비교를 위한 하이퍼파라미터 저장에는 config를 사용하세요. ID에는 다음 특수 문자를 포함할 수 없습니다:/\#?%:..Dagster 내에서 실험 추적을 수행하는 경우, IO Manager가 run을 재개할 수 있도록 Run ID를 설정하세요. 기본적으로 Dagster Run ID로 설정되며, 예를 들면7e4df022-1bf2-44b5-a383-bb852df4077e입니다.run_name: (str, optional) UI에서 이 run을 파악하는 데 도움이 되는 짧은 표시 이름입니다. 기본적으로dagster-run-[8 first characters of the Dagster Run ID]형식의 string입니다. 예를 들면dagster-run-7e4df022입니다.run_tags: (list[str], optional): UI에서 이 run의 태그 목록을 채우는 string 목록입니다. 태그는 runs를 함께 구성하거나baseline또는production같은 임시 레이블을 적용하는 데 유용합니다. UI에서 태그를 추가하거나 제거할 수 있으며, 특정 태그가 있는 runs만 필터링할 수도 있습니다. 이 인테그레이션에서 사용하는 모든 W&B Run에는dagster_wandb태그가 포함됩니다.
W&B 아티팩트 사용
@op 또는 @asset에서 W&B 아티팩트를 직접 생성하고 사용할 수 있습니다. 다음 예시는 Python 목록을 포함하는 데이터셋 유형의 W&B 아티팩트를 생성하는 @asset을 보여줍니다.
@op, @asset, @multi_asset에 메타데이터 설정을 지정하여 아티팩트를 기록할 수 있습니다. 마찬가지로 Dagster 외부에서 생성된 W&B 아티팩트도 사용할 수 있습니다.
W&B Artifacts 작성
- Python 객체 (
int,dict,list등) - W&B 객체 (
Table,Image,Graph등) - W&B 아티팩트 객체
@asset)을 사용해 W&B Artifacts를 작성하는 방법을 보여줍니다.
- Python 객체
- W&B Object
- W&B Artifact
pickle 모듈로 직렬화할 수 있는 모든 항목은 피클링되어 인테그레이션이 생성한 아티팩트에 추가됩니다. Dagster 내에서 해당 아티팩트를 조회하면 콘텐츠가 언피클링됩니다(자세한 내용은 Read artifacts를 참조하세요).W&B는 여러 Pickle 기반 직렬화 모듈(pickle, dill, cloudpickle, joblib)을 지원합니다. ONNX나 PMML 같은 더 고급 직렬화 방식도 사용할 수 있습니다. 자세한 내용은 Serialization 섹션을 참조하세요.
설정
wandb_artifact_configuration라는 설정 딕셔너리를 @op, @asset, @multi_asset에 설정할 수 있습니다. 이 딕셔너리를 metadata로 데코레이터 인자에 전달하세요. 이 설정은 W&B Artifacts에 대한 IO Manager의 읽기 및 쓰기를 제어하는 데 필요합니다.
@op의 경우 Out의 metadata 인자를 통해 출력 metadata에 위치합니다.
@asset의 경우 asset의 metadata 인자에 위치합니다.
@multi_asset의 경우 AssetOut의 metadata 인자를 통해 각 출력 metadata에 위치합니다.
다음 코드 예제는 @op, @asset, @multi_asset 컴퓨팅에 딕셔너리를 설정하는 방법을 보여줍니다.
- @op 예제
- @asset 예제
- @multi_asset 예제
@op 예제:name: (str) 이 artifact를 사람이 읽기 쉬운 이름으로, UI에서 이 artifact를 식별하거나use_artifactcalls에서 참조할 때 사용합니다. 이름에는 문자, 숫자, 밑줄, 하이픈, 점을 포함할 수 있습니다. 이름은 프로젝트 전체에서 고유해야 합니다.@op에 필요합니다.type: (str) artifact를 구성하고 구분하는 데 사용하는 artifact의 유형입니다. 일반적인 유형으로는 dataset 또는 model이 있지만, 문자, 숫자, 밑줄, 하이픈, 점을 포함하는 임의의 문자열을 사용할 수 있습니다. 출력이 이미 아티팩트가 아닌 경우 필요합니다.description: (str) artifact를 설명하는 자유 텍스트입니다. 설명은 UI에서 마크다운으로 렌더링되므로 표, 링크 등을 넣기에 적합합니다.aliases: (list[str]) 아티팩트에 적용할 하나 이상의 alias를 포함하는 배열입니다. 설정 여부와 관계없이 인테그레이션은 이 목록에 “latest” 태그도 추가합니다. alias는 모델과 데이터셋의 versioning을 관리하는 데 사용하세요.add_dirs: (list[dict[str, Any]]): 아티팩트에 포함할 각 로컬 디렉터리에 대한 설정을 담은 배열입니다.add_files: (list[dict[str, Any]]): 아티팩트에 포함할 각 로컬 파일에 대한 설정을 담은 배열입니다.add_references: (list[dict[str, Any]]): 아티팩트에 포함할 각 외부 Reference에 대한 설정을 담은 배열입니다.serialization_module: (dict) 사용할 직렬화 모듈의 설정입니다. 자세한 내용은 Serialization 섹션을 참고하세요.name: (str) 직렬화 모듈의 이름입니다. 허용되는 값:pickle,dill,cloudpickle,joblib. 이 모듈은 로컬에서 사용할 수 있어야 합니다.parameters: (dict[str, Any]) 직렬화 함수에 전달되는 선택 인수입니다. 이 모듈의 dump method와 동일한 parameters를 받습니다. 예를 들어{"compress": 3, "protocol": 4}입니다.
- W&B 측: 소스 인테그레이션 이름과 버전, 사용된 Python 버전, pickle 프로토콜 버전 등
- Dagster 측:
- Dagster Run ID
- W&B Run: ID, 이름, 경로, URL
- W&B 아티팩트: ID, 이름, 유형, 버전, 크기, URL
- W&B Entity
- W&B 프로젝트




mypy와 같은 정적 유형 검사기를 사용하는 경우, 다음을 사용하여 설정 유형 정의 객체를 임포트하세요:
파티션 사용
DailyPartitionsDefinition을 사용해 파티션을 나눈 예시입니다:
my_daily_partitioned_asset.2023-01-01, my_daily_partitioned_asset.2023-01-02, 또는 my_daily_partitioned_asset.2023-01-03입니다. 여러 차원으로 파티션된 asset은 각 차원을 점(.)으로 구분된 형식으로 표시합니다. 예를 들어 my_asset.car.blue입니다.
고급 활용
W&B Artifacts 조회
wandb_artifact_configuration이라는 설정 딕셔너리를 @op 또는 @asset에 설정할 수 있습니다. 차이점은 출력을 기준으로 설정하는 것이 아니라 입력에 설정해야 한다는 점뿐입니다.
@op의 경우 In metadata argument를 통해 입력 메타데이터에 설정합니다. 아티팩트 이름을
명시적으로 전달해야 합니다.
@asset의 경우 Asset In metadata argument를 통해 입력 메타데이터에 설정합니다. 상위 asset의 이름이 아티팩트 이름과 일치해야 하므로 아티팩트 이름을 전달하면 안 됩니다.
인테그레이션 외부에서 생성된 아티팩트에 대한 종속성을 두려면 SourceAsset을 사용해야 합니다. 이 경우 항상 해당 asset의 최신 버전을 조회합니다.
다음 예제에서는 여러 op에서 아티팩트를 조회하는 방법을 보여줍니다.
- `@op`에서
- 다른 `@asset`이 생성함
- Dagster 외부에서 생성된 Artifact
@op에서 artifact 조회설정
- 아티팩트에 포함된 이름이 지정된 객체를 조회하려면
get을 사용합니다:
- 아티팩트에 포함된 다운로드한 파일의 로컬 경로를 조회하려면
get_path를 사용합니다:
- 콘텐츠가 로컬에 다운로드된 전체 아티팩트 객체를 조회하려면:
get: (str) artifact의 상대 이름에 있는 W&B 객체를 조회합니다.get_path: (str) artifact의 상대 이름에 있는 파일의 경로를 조회합니다.
직렬화 설정
yield를 사용하는 함수는 pickle하려고 하면 오류가 발생합니다.
W&B는 추가적인 Pickle 기반 직렬화 모듈(dill, cloudpickle, joblib)도 지원합니다. 직렬화된 문자열을 반환하거나 Artifact를 직접 생성해 ONNX나 PMML 같은 더 고급 직렬화 방식도 사용할 수 있습니다. 어떤 방식을 선택할지는 사용 사례에 따라 다릅니다. 이 주제에 관한 관련 문헌을 참고하세요.
Pickle 기반 직렬화 모듈
wandb_artifact_configuration의 serialization_module 딕셔너리를 통해 사용할 직렬화 방식을 설정할 수 있습니다. 해당 모듈을 Dagster를 실행하는 머신에서 사용할 수 있는지 반드시 확인하세요.
이 인테그레이션은 해당 아티팩트를 조회할 때 어떤 직렬화 모듈을 사용해야 하는지 자동으로 감지합니다.
지원되는 모듈은 pickle, dill, cloudpickle, joblib입니다.
다음은 joblib으로 직렬화한 “모델”을 만든 다음 이를 inference에 사용하는 간단한 예시입니다.
고급 직렬화 형식(ONNX, PMML)
- 모델을 선택한 형식으로 변환한 다음, 일반적인 Python 객체인 것처럼 해당 형식의 문자열 표현을 반환합니다. 그러면 인테그레이션이 해당 문자열을 pickle합니다. 그런 다음 그 문자열을 사용해 모델을 다시 구성할 수 있습니다.
- 직렬화된 모델이 들어 있는 새 로컬 파일을 만든 다음,
add_file설정을 사용해 해당 파일로 맞춤형 아티팩트를 생성합니다.
파티션 사용
- 모든 파티션 조회
- 특정 파티션 조회
업스트림
@asset의 모든 파티션을 조회하며, 이는 딕셔너리 형태로 제공됩니다. 이 딕셔너리에서 키와 값은 각각 파티션 키와 아티팩트 콘텐츠에 해당합니다.metadata는 프로젝트에서 W&B가 서로 다른 artifact 파티션과 상호작용하는 방식을 정의합니다.
metadata 객체에는 wandb_artifact_configuration라는 키가 있으며, 그 안에 중첩된 partitions 객체가 들어 있습니다.
partitions 객체는 각 파티션 이름을 해당 설정에 매핑합니다. 각 파티션의 설정에서는 해당 파티션에서 데이터를 어떻게 조회할지 지정할 수 있습니다. 이러한 설정에는 각 파티션의 요구 사항에 따라 get, version, alias 등의 키가 포함될 수 있습니다.
설정 키
get:get키는 데이터를 가져올 W&B 객체(Table, Image 등)의 이름을 지정합니다.version:version키는 아티팩트의 특정 버전을 가져오려는 경우에 사용합니다.alias:alias키를 사용하면 별칭으로 아티팩트를 조회할 수 있습니다.
와일드카드 설정
"*"는 설정되지 않은 모든 파티션을 의미합니다. 즉, partitions 객체에 명시적으로 지정되지 않은 파티션에 대한 기본 설정을 제공합니다.
예를 들어:
default_table_name이라는 테이블에서 가져오도록 한다는 뜻입니다.
특정 파티션 설정
yellow라는 이름의 파티션에 대해, 와일드카드 설정을 재정의하여 custom_table_name라는 이름의 테이블에서 데이터를 가져온다는 의미입니다.
버전 관리 및 별칭 지정
version 및 alias 키를 지정할 수 있습니다.
버전의 경우,
orange Artifact 파티션의 v0 버전에서 데이터를 가져옵니다.
별칭의 경우,
special_alias라는 별칭을 가진 Artifact 파티션의 테이블 default_table_name에서 데이터를 가져옵니다 (설정에서는 blue로 지칭됨).
고급 활용
인테그레이션의 고급 활용 방법은 다음 전체 코드 예제를 참고하세요:W&B Launch 사용하기
- Dagster 인스턴스에서 하나 이상의 Launch 에이전트를 실행합니다.
- Dagster 인스턴스 내에서 로컬 Launch 작업을 실행합니다.
- 온프레미스 또는 클라우드에서 원격 Launch 작업을 실행합니다.
Launch 에이전트
@op인 run_launch_agent를 제공합니다. 이 @op는 Launch 에이전트를 시작하고, 수동으로 중지할 때까지 장기 실행 프로세스로 실행합니다.
에이전트는 Launch 큐를 폴링하며, 작업을 순서대로 실행하는 프로세스입니다(또는 외부 서비스가 실행하도록 작업을 디스패치합니다).
Launch 페이지를 참고하세요.
Launchpad에서는 모든 속성에 대한 설명도 확인할 수 있습니다.

Launch 작업
run_launch_job이라는 임포트할 수 있는 @op를 제공합니다. 이 @op는 Launch 작업을 실행합니다.
Launch 작업을 실행하려면 큐에 할당되어 있어야 합니다. 큐를 생성하거나 기본 큐를 사용할 수 있습니다. 해당 큐를 모니터링하는 활성 에이전트가 있는지 확인하세요. Dagster 인스턴스 내에서 에이전트를 실행할 수 있으며, Kubernetes에 배포 가능한 에이전트를 사용하는 것도 고려할 수 있습니다.
Launch 페이지를 참고하세요.
Launchpad에서는 모든 속성에 대한 설명도 확인할 수 있습니다.

모범 사례
IO Manager를 사용해 Artifacts를 읽고 쓰세요
Artifact.download() 또는 Run.log_artifact()를 직접 사용하지 마세요. 이러한 방법은 인테그레이션이 처리합니다. 대신 Artifact에 저장할 데이터를 반환하고, 나머지는 인테그레이션이 처리하도록 하세요. 이렇게 하면 Artifact의 리니지를 더 잘 추적할 수 있습니다.
복잡한 사용 사례에서만 Artifact 객체를 직접 빌드하세요
메타데이터를 통해 Artifacts에 파일, 디렉터리, 외부 참조를 추가하세요
wandb_artifact_configuration 객체를 사용하세요. 자세한 내용은 Artifact configuration section의 고급 예제를 참조하세요.
