artifact 버전을 컬렉션에 연결하기

artifact 버전을 조직에서 사용할 수 있게 하려면 W&B Registry의 컬렉션에 연결하세요. 연결하면 버전이 비공개 프로젝트 수준 범위에서 공유 조직 수준 범위로 이동합니다. artifact 버전은 W&B Python SDK를 사용해 프로그래밍 방식으로 연결하거나 W&B App에서 대화형으로 연결할 수 있습니다. artifact를 연결하면 W&B는 소스 artifact와 컬렉션 항목 사이에 레퍼런스를 생성합니다. 연결된 버전은 프로젝트 내 run에 로깅된 소스 artifact 버전을 가리킵니다. 컬렉션의 연결된 버전과 해당 버전이 로깅된 프로젝트의 소스 버전을 모두 볼 수 있습니다.

아티팩트를 컬렉션에 연결하기

run 중에 아티팩트를 생성할지, run 없이 생성할지, 또는 기존 아티팩트 버전을 연결할지에 따라 워크플로를 선택하세요.

시작하기 전에 다음 사항을 확인하세요:

컬렉션에서 허용하는 아티팩트 유형. 컬렉션 유형에 대한 자세한 내용은 컬렉션 만들기의 “컬렉션 유형”을 참조하세요.
컬렉션이 속한 레지스트리가 이미 존재하는지 확인하세요. 레지스트리가 존재하는지 확인하려면 Registry App and search for 레지스트리 이름을 검색하세요.

Python SDK
W&B 레지스트리
아티팩트 브라우저

wandb.Run.link_artifact() 또는 wandb.Artifact.link()을 사용해 아티팩트 버전을 컬렉션에 프로그래밍 방식으로 연결할 수 있습니다.다음 표는 아티팩트 버전을 컬렉션에 연결할 때 사용할 수 있는 메서드와, 각 메서드를 사용할 때 W&B가 무엇을 기록하는지 요약합니다.

사용 사례	방법	W&B가 기록하는 내용
run 중에 아티팩트를 생성하고 컬렉션에 연결	`wandb.Run.link_artifact()`	아티팩트를 활성 run의 출력으로 기록한 다음 연결합니다
run을 명시적으로 시작하지 않고 아티팩트를 생성하고 연결	초안 아티팩트에 `wandb.Artifact.link()` 사용	먼저 아티팩트를 저장합니다. 활성 run이 없으면 자동으로 run을 생성합니다
기존에 커밋된 아티팩트를 연결	`wandb.Api().artifact()`에서 가져온 아티팩트에 `wandb.Artifact.link()` 사용	새 run을 생성하지 않고 아티팩트를 연결합니다

대상 컬렉션 경로를 target_path 매개변수로 전달하세요. 경로는 wandb-registry- 접두사, 레지스트리 이름, 컬렉션 이름으로 구성됩니다:

wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}

run에서 아티팩트 연결하기

활성 상태의 run에서 wandb.Run.link_artifact()를 사용해 아티팩트 버전을 생성하고 연결하세요. W&B는 연결하기 전에 초안 아티팩트를 run의 출력으로 기록합니다.아티팩트 버전을 생성하고 연결하려면 다음 단계를 따르세요.

wandb.init()으로 run을 초기화합니다.
Artifact 객체를 만들고 하나 이상의 파일을 추가합니다.
wandb.Run.link_artifact()를 호출하고 대상 컬렉션을 지정합니다.

꺾쇠괄호(<>)로 묶인 값은 실제 값으로 바꾸세요.

import wandb

entity = "<team_entity>"          # 팀 엔티티
project = "<project_name>"        # 아티팩트가 포함된 프로젝트 이름

# run 초기화
with wandb.init(entity = entity, project = project) as run:

  # 아티팩트 객체 생성
  # type 매개변수는 아티팩트 객체의 유형과 
  # 컬렉션 유형을 모두 지정합니다.
  artifact = wandb.Artifact(name = "<name>", type = "<type>")

  # 아티팩트 객체에 파일을 추가합니다. 
  # 로컬 머신의 파일 경로를 지정합니다.
  artifact.add_file(local_path = "<local_path_to_artifact>")

  # 아티팩트를 연결할 컬렉션과 레지스트리를 지정합니다.
  REGISTRY_NAME = "<registry_name>"  
  COLLECTION_NAME = "<collection_name>"
  target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

  # 아티팩트를 컬렉션에 연결합니다.
  run.link_artifact(artifact = artifact, target_path = target_path)

아티팩트 생성 및 연결

wandb.Artifact.link()를 사용하면 run을 명시적으로 초기화하지 않고도 초안 아티팩트를 생성해 연결할 수 있습니다. 연결하기 전에 아티팩트를 저장해야 하면, W&B가 필요에 따라 자동으로 run을 생성합니다.아티팩트 버전을 생성하고 연결하려면 다음과 같이 하세요.

Artifact 객체를 만들고 파일을 하나 이상 추가합니다.
wandb.Artifact.link()를 호출하고 대상 컬렉션을 지정합니다.

꺾쇠괄호(<>) 안의 값은 사용자 환경에 맞게 바꾸세요.

import wandb

# 아티팩트 객체 생성
# type 파라미터는 아티팩트 객체의 유형과
# 컬렉션 유형을 모두 지정합니다
artifact = wandb.Artifact(name = "<name>", type = "<type>")

# 아티팩트 객체에 파일을 추가합니다.
# 로컬 머신의 파일 경로를 지정하세요.
artifact.add_file(local_path = "<local_path_to_artifact>")

# 아티팩트를 연결할 컬렉션과 레지스트리를 지정합니다
REGISTRY_NAME = "<registry_name>"  
COLLECTION_NAME = "<collection_name>"
target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

# 아티팩트를 컬렉션에 연결합니다
artifact.link(target_path = target_path)

기존 아티팩트 연결하기

새 run을 생성하지 않고 기존에 커밋된 아티팩트 버전을 연결하려면 wandb.Api().artifact()로 가져온 아티팩트에 wandb.Artifact.link()를 사용하세요.

wandb.Api()로 Public API 클라이언트를 생성합니다.
wandb.Api.artifact()로 아티팩트 버전을 가져옵니다.
wandb.Artifact.link()를 호출한 다음 대상 컬렉션을 지정합니다.

import wandb

api = wandb.Api()

artifact = api.artifact(
    "<entity>/<project>/<artifact-name>:<alias-or-version>"
)

artifact.link(
    target_path="wandb-registry-<registry-name>/<collection-name>",
    aliases=["latest"],
)

W&B App에서 프로젝트의 아티팩트 브라우저로 이동하세요: https://wandb.ai/<entity>/<project>/artifacts
프로젝트 사이드바에서 Artifacts 아이콘을 선택하세요.
레지스트리에 연결할 아티팩트 버전을 클릭하세요.
Version overview 섹션에서 Link to registry 버튼을 클릭하세요.
화면 오른쪽에 나타나는 모달에서 Select a registered model 드롭다운 메뉴에서 아티팩트를 선택하세요.
Next step을 클릭하세요.
(선택 사항) Aliases 드롭다운에서 별칭을 선택하세요.
Link to registry를 클릭하세요.

Registry App에서 연결된 아티팩트의 메타데이터, 버전 데이터, 사용 정보, 리니지 정보 보기 등을 확인할 수 있습니다.

컬렉션에서 아티팩트 버전 연결 해제

W&B Python SDK 또는 W&B 레지스트리를 사용하여 컬렉션에서 아티팩트 버전의 연결을 해제합니다. 연결을 해제하면 컬렉션에서 아티팩트 버전이 제거되지만, 소스 아티팩트 버전이나 해당 파일은 삭제되지 않습니다.

아티팩트 버전을 레지스트리 컬렉션에 연결하면 해당 TTL(Time-to-Live) 정책이 비활성화되고 TTL이 None으로 설정됩니다. 이후 버전의 연결을 해제해도 W&B는 이전 TTL을 복원하거나 원래 기간을 유지하지 않습니다. 버전에 여전히 TTL이 필요한 경우 연결을 해제한 후 TTL을 다시 설정하세요.TTL 정책에 대한 자세한 내용은 아티팩트 데이터 보존 관리를 참조하세요.

Python SDK
W&B 레지스트리

W&B Python SDK를 사용하여 아티팩트 버전의 연결을 해제하려면 다음을 수행하세요.

wandb.Api()로 Public API 클라이언트를 생성합니다.
wandb.Api.artifact()로 연결된 아티팩트 버전을 조회합니다.
wandb.Artifact.unlink()를 호출하여 컬렉션에서 아티팩트 버전의 연결을 해제합니다.

wandb-registry-<registry_name>/<collection_name>:<version_or_alias>

자리 표시자 값을 실제 값으로 바꾸세요.

import wandb

registry_name = "your-registry-name"  # 레지스트리 이름으로 바꾸세요
collection_name = "your-collection-name"  # 컬렉션 이름으로 바꾸세요
version = "version-or-alias"  # 연결을 해제할 아티팩트 버전으로 바꾸세요

target_path=f"wandb-registry-{registry_name}/{collection_name}:{version}"

api = wandb.Api()
linked_artifact = api.artifact(name=target_path)

# 컬렉션에서 아티팩트 버전 연결 해제
linked_artifact.unlink()

레지스트리에서 연결된 아티팩트 보기

W&B 레지스트리에서 메타데이터, 리니지, 사용 정보 등 연결된 아티팩트에 대한 정보를 확인합니다.

W&B 레지스트리로 이동합니다.
아티팩트를 연결한 레지스트리의 이름을 선택합니다.
컬렉션 이름을 선택합니다.
컬렉션의 아티팩트가 메트릭을 로깅하는 경우 메트릭 표시를 클릭해 버전 간 메트릭을 비교합니다.
아티팩트 버전 목록에서 액세스하려는 버전을 선택합니다. 버전 번호는 v0부터 시작해 연결된 각 아티팩트 버전에 순차적으로 할당됩니다.
아티팩트 버전의 세부 정보를 보려면 해당 버전을 클릭합니다. 이 페이지의 탭에서 해당 버전의 메타데이터(로깅된 메트릭 포함), 리니지, 사용 정보를 확인할 수 있습니다.

Version 탭의 Full Name 필드를 확인하세요. 연결된 아티팩트의 전체 이름은 레지스트리, 컬렉션 이름, 그리고 아티팩트 버전의 alias 또는 인덱스로 구성됩니다.

Full name of a linked artifact

wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}:v{INTEGER}

코드로 아티팩트 버전에 액세스하려면 연결된 아티팩트의 전체 이름이 필요합니다.

문제 해결

artifact를 연결할 수 없는 경우 아래의 일반적인 항목을 다시 확인하세요.

개인 계정에서 artifact 로깅

개인 entity로 W&B에 로깅한 artifact는 레지스트리에 연결할 수 없습니다. 조직 내 팀 entity를 사용해 artifact를 로깅해야 합니다. 조직의 팀 내에서 로깅한 artifact만 조직의 레지스트리에 연결할 수 있습니다.

artifact를 레지스트리에 연결하려면 팀 entity로 해당 artifact를 로깅해야 합니다.

팀 entity 찾기

W&B에서는 팀 이름을 해당 팀의 entity로 사용합니다. 예를 들어 팀 이름이 team-awesome라면 팀 entity는 team-awesome입니다. 다음과 같은 방법으로 팀 이름을 확인할 수 있습니다:

팀의 W&B 프로필 페이지로 이동합니다.
사이트 URL을 복사합니다. URL 형식은 https://wandb.ai/<team>입니다. 여기서 <team>은 팀 이름이면서 동시에 팀의 entity입니다.

팀 entity에서 로깅하기

wandb.init()으로 run을 초기화할 때 entity로 팀을 지정하세요. run을 초기화할 때 entity를 지정하지 않으면 기본 entity가 사용되며, 이 entity는 팀 entity일 수도 있고 아닐 수도 있습니다.
import wandb with wandb.init(entity='<team_entity>', project='<project_name>') as run: # 여기에 아티팩트를 로깅하세요
wandb.Run.log_artifact()를 사용하거나 Artifact 객체를 만든 다음 파일을 추가하는 방식으로 아티팩트를 run에 로깅합니다.
artifact = wandb.Artifact(name="<artifact_name>", type="<type>")
아티팩트를 로깅하는 방법은 아티팩트 구성을 참조하세요.
아티팩트가 개인 entity에 로깅된 경우, 조직 내 entity에 다시 로깅해야 합니다.

W&B App UI에서 레지스트리 경로 확인

W&B App UI에서 레지스트리의 경로를 확인하려면 빈 컬렉션을 만드세요. 이렇게 하려면 아래 단계를 따르세요:

https://wandb.ai/registry/에서 W&B 레지스트리로 이동합니다.
아티팩트를 연결할 레지스트리를 클릭합니다.
빈 컬렉션을 클릭합니다. 빈 컬렉션이 없으면 새 컬렉션을 만듭니다.
표시되는 코드 스니펫에서 .link_artifact()의 target_path 필드를 확인합니다.
(선택) 컬렉션을 삭제합니다.

예를 들어, 위 단계를 완료하면 target_path 매개변수가 있는 코드 블록을 확인할 수 있습니다:

target_path = 
      "smle-registries-bug-bash/wandb-registry-Golden Datasets/raw_images"

이를 컴포넌트로 나누어 보면, 아티팩트를 프로그래밍 방식으로 연결하는 경로를 만드는 데 필요한 항목을 확인할 수 있습니다.

ORG_ENTITY_NAME = "smle-registries-bug-bash"
REGISTRY_NAME = "Golden Datasets"
COLLECTION_NAME = "raw_images"

임시 컬렉션의 이름을 아티팩트를 연결하려는 컬렉션의 이름으로 바꾸세요.

가이드

인테그레이션

레퍼런스

아티팩트를 컬렉션에 연결하기

run에서 아티팩트 연결하기

아티팩트 생성 및 연결

기존 아티팩트 연결하기

컬렉션에서 아티팩트 버전 연결 해제

레지스트리에서 연결된 아티팩트 보기

문제 해결

개인 계정에서 artifact 로깅

팀 entity 찾기

팀 entity에서 로깅하기

W&B App UI에서 레지스트리 경로 확인

​아티팩트를 컬렉션에 연결하기

run에서 아티팩트 연결하기

아티팩트 생성 및 연결

기존 아티팩트 연결하기

​컬렉션에서 아티팩트 버전 연결 해제

​레지스트리에서 연결된 아티팩트 보기

​문제 해결

​개인 계정에서 artifact 로깅

​팀 entity 찾기

​팀 entity에서 로깅하기

​W&B App UI에서 레지스트리 경로 확인

아티팩트를 컬렉션에 연결하기

컬렉션에서 아티팩트 버전 연결 해제

레지스트리에서 연결된 아티팩트 보기

문제 해결

개인 계정에서 artifact 로깅

팀 entity 찾기

팀 entity에서 로깅하기

W&B App UI에서 레지스트리 경로 확인