아티팩트 버전을 컬렉션에 연결하기

조직에서 아티팩트 버전을 사용 가능하게 하려면, 레지스트리의 컬렉션에 연결하세요. 연결하면 버전이 비공개 프로젝트 수준 범위에서 공유 조직 수준 범위로 이동합니다. W&B Python SDK를 사용하거나 W&B App에서 대화형으로 아티팩트 버전을 연결할 수 있습니다. 아티팩트를 연결하면 W&B는 원본 아티팩트와 컬렉션 항목 사이에 참조를 생성합니다. 연결된 버전은 프로젝트 내 run에 로깅된 원본 아티팩트 버전을 가리킵니다. 컬렉션의 연결된 버전과 로깅된 프로젝트의 원본 버전을 모두 볼 수 있습니다.

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

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

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

컬렉션에서 허용하는 아티팩트 유형. 컬렉션 유형에 대한 자세한 내용은 컬렉션 생성의 “컬렉션 유형”을 참조하세요.
컬렉션이 속한 레지스트리가 이미 존재하는지 여부. 레지스트리가 존재하는지 확인하려면 Registry App으로 이동하여 레지스트리 이름을 검색하세요.

W&B Python SDK
Registry
아티팩트 브라우저

wandb.Run.link_artifact() 또는 wandb.Artifact.link()를 사용하여 프로그래밍 방식으로 아티팩트 버전을 컬렉션에 연결하세요.다음 table은 아티팩트 버전을 컬렉션에 연결하는 데 사용할 수 있는 방법과 각 방법을 사용할 때 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}

wandb.Run.link_artifact()를 사용하여 활성 run 중에 아티팩트 버전을 생성하고 연결하세요. W&B는 초안 아티팩트를 연결하기 전에 run의 출력으로 로깅합니다.아티팩트 버전을 생성하고 연결하려면:

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

꺾쇠괄호(<>)로 묶인 값을 자신의 값으로 바꾸세요:

import wandb

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

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

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

  # artifact object에 파일을 추가합니다. 
  # 로컬 머신의 파일 경로를 지정합니다.
  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)

wandb.Api().artifact()로 가져온 아티팩트에 wandb.Artifact.link()를 사용하면 새 run을 만들지 않고 기존에 커밋된 아티팩트 버전을 연결할 수 있습니다.

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 앱에서 프로젝트의 아티팩트 브라우저로 이동하세요: https://wandb.ai/<entity>/<project>/artifacts
프로젝트 사이드바에서 Artifacts 아이콘을 선택하세요.
레지스트리에 연결할 아티팩트 버전을 클릭하세요.
버전 개요 섹션에서 레지스트리에 연결 버튼을 클릭하세요.
화면 오른쪽에 나타나는 모달에서 등록된 모델 선택 드롭다운 메뉴의 아티팩트를 선택하세요.
다음 단계를 클릭하세요.
(선택) 별칭 드롭다운에서 별칭을 선택하세요.
레지스트리에 연결을 클릭하세요.

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

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

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

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

W&B Python SDK
Registry

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()

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

레지스트리에서 메타데이터, 리니지, 사용 정보와 같은 연결된 아티팩트에 대한 정보를 확인하세요.

https://forge.coreweave.com/registry/ 에서 레지스트리로 이동합니다.
아티팩트를 연결한 레지스트리의 이름을 선택합니다.
컬렉션의 이름을 선택합니다.
컬렉션의 아티팩트가 메트릭을 로깅하는 경우, Show metrics를 클릭하여 버전 간 메트릭을 비교합니다.
아티팩트 버전 목록에서 액세스하려는 버전을 선택합니다. 버전 번호는 연결된 각 아티팩트 버전에 v0부터 점진적으로 부여됩니다.
아티팩트 버전에 대한 세부 정보를 보려면 해당 버전을 클릭합니다. 이 페이지의 탭에서 해당 버전의 메타데이터(로깅된 메트릭 포함), 리니지, 사용 정보를 확인할 수 있습니다.

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

Full name of a linked artifact

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

연결된 아티팩트의 전체 이름을 알아야 아티팩트 버전에 프로그래밍 방식으로 액세스할 수 있습니다.

문제 해결

아티팩트를 연결할 수 없는 경우 확인해야 할 몇 가지 일반적인 사항은 다음과 같습니다.

개인 계정에서 아티팩트 로깅하기

W&B에 개인 entity로 로깅한 아티팩트는 레지스트리에 연결할 수 없습니다. 조직 내 팀 entity를 사용하여 아티팩트를 로깅하세요. 조직의 팀 내에서 로깅한 아티팩트만 조직의 레지스트리에 연결할 수 있습니다.

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

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

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

빈 컬렉션을 생성하여 W&B App UI에서 레지스트리 경로를 확인하세요. 다음 단계를 따르세요:

https://forge.coreweave.com/registry/ 에서 레지스트리로 이동하세요.
아티팩트를 연결할 레지스트리를 클릭하세요.
빈 컬렉션을 클릭하세요. 빈 컬렉션이 없으면 새 컬렉션을 생성하세요.
표시되는 코드 스니펫에서 .link_artifact() 내의 target_path= 필드를 파악하세요.
(선택) 컬렉션을 삭제하세요.

예를 들어, 위 단계를 완료하면 target_path 매개변수가 포함된 코드 블록을 찾을 수 있습니다:

target_path = 
      "wandb-registry-Zoo-Classifier-Registry/Temp Collection"

이를 컴포넌트별로 나누어 보면, 프로그래밍 방식으로 아티팩트를 연결할 경로를 생성하는 데 무엇을 사용해야 하는지 알 수 있습니다.

ORG_ENTITY_NAME = "wandb"
REGISTRY_NAME = "Zoo-Classifier-Registry"
COLLECTION_NAME = "Temp Collection"

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

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

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

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

​문제 해결

​개인 계정에서 아티팩트 로깅하기

​팀 entity 찾기

​팀 entity에서 로깅하기

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

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

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

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

문제 해결

개인 계정에서 아티팩트 로깅하기

팀 entity 찾기

팀 entity에서 로깅하기

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