태그로 버전 정리하기

컬렉션 또는 컬렉션 내 아티팩트 버전을 정리하는 데 태그를 사용합니다. Python SDK 또는 W&B App UI로 태그를 추가, 제거, 편집할 수 있습니다.

레지스트리 내 컬렉션 또는 아티팩트 버전을 정리하기 위해 태그를 생성해 추가합니다. W&B App UI 또는 W&B Python SDK를 사용해 컬렉션이나 아티팩트 버전에 태그를 추가, 수정, 조회, 제거할 수 있습니다.

태그를 사용할 때와 alias를 사용할 때

특정 아티팩트 버전을 고유하게 참조해야 할 때는 alias를 사용합니다. 예를 들어 artifact_name:alias가 항상 하나의 특정 버전을 가리키도록 보장하려면 production 또는 latest와 같은 alias를 사용합니다.

그룹화 또는 검색에서 더 많은 유연성이 필요할 때는 태그를 사용합니다. 여러 버전이나 컬렉션이 동일한 레이블을 공유할 수 있고, 특정 식별자에 오직 하나의 버전만 연결된다는 보장이 필요하지 않을 때 태그가 이상적입니다.

​

컬렉션에 태그 추가하기

W&B App UI 또는 Python SDK를 사용하여 컬렉션에 태그를 추가할 수 있습니다:

W&B App

W&B App UI를 사용하여 컬렉션에 태그를 추가하려면 다음을 수행합니다:

1. W&B Registry로 이동합니다.
2. 레지스트리 카드를 클릭합니다.
3. 컬렉션 이름 옆의 View details를 클릭합니다.
4. 컬렉션 카드에서 Tags 필드 옆의 플러스 아이콘(+)을 클릭한 다음 태그 이름을 입력합니다.
5. 키보드의 Enter 키를 누릅니다.

Python SDK

import wandb

COLLECTION_TYPE = "<collection_type>"
REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"

full_name = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

collection = wandb.Api().artifact_collection(
  type_name = COLLECTION_TYPE, 
  name = full_name
  )

collection.tags = ["your-tag"]
collection.save()

​

컬렉션에 속한 태그 업데이트하기

tags 속성을 재할당하거나 변경(mutate)해서 태그를 프로그래밍 방식으로 업데이트할 수 있습니다. W&B는 인플레이스 변경 대신 tags 속성을 재할당하는 방식을 사용할 것을 권장하며, 이는 Python에서도 좋은 관례입니다.

예를 들어, 다음 코드 스니펫은 재할당으로 리스트를 업데이트하는 일반적인 방법을 보여줍니다. 간단히 하기 위해 컬렉션에 태그 추가하기 섹션의 코드 예제를 계속 사용합니다:

collection.tags = [*collection.tags, "new-tag", "other-tag"]
collection.tags = collection.tags + ["new-tag", "other-tag"]

collection.tags = set(collection.tags) - set(tags_to_delete)
collection.tags = []  # 모든 태그 삭제

다음 코드 스니펫은 in-place mutation을 사용해 아티팩트 버전에 포함된 태그를 업데이트하는 방법을 보여줍니다.

collection.tags += ["new-tag", "other-tag"]
collection.tags.append("new-tag")

collection.tags.extend(["new-tag", "other-tag"])
collection.tags[:] = ["new-tag", "other-tag"]
collection.tags.remove("existing-tag")
collection.tags.pop()
collection.tags.clear()

​

컬렉션에 속한 태그 보기

컬렉션에 추가된 태그를 보려면 W&B App UI를 사용하세요:

1. W&B Registry로 이동합니다.
2. 레지스트리 카드를 클릭합니다.
3. 컬렉션 이름 옆의 View details를 클릭합니다.

컬렉션에 하나 이상의 태그가 있는 경우, 컬렉션 카드의 Tags 필드 옆에서 해당 태그를 확인할 수 있습니다.

컬렉션에 추가된 태그는 해당 컬렉션 이름 옆에도 표시됩니다.

예를 들어, 다음 이미지에서 “tag1”이라는 태그가 “zoo-dataset-tensors” 컬렉션에 추가되었습니다.

​

컬렉션에서 태그 제거하기

W&B App UI를 사용해 컬렉션에서 태그를 제거하려면 다음을 수행하세요:

1. W&B Registry로 이동합니다.
2. 레지스트리 카드를 클릭합니다.
3. 컬렉션 이름 옆의 View details를 클릭합니다.
4. 컬렉션 카드에서 제거하려는 태그 이름 위에 마우스를 올립니다.
5. 취소 버튼(X 아이콘)을 클릭합니다.

​

아티팩트 버전에 태그 추가하기

W&B App UI 또는 Python SDK를 사용해 컬렉션에 연결된 아티팩트 버전에 태그를 추가할 수 있습니다.

W&B App

1. https://wandb.ai/registry 에서 W&B Registry로 이동합니다.
2. 레지스트리 카드를 클릭합니다.
3. 태그를 추가하려는 컬렉션 이름 옆의 View details를 클릭합니다.
4. Versions 섹션으로 스크롤합니다.
5. 아티팩트 버전 옆의 View를 클릭합니다.
6. Version 탭에서 Tags 필드 옆의 플러스 아이콘(+)을 클릭한 후 태그 이름을 입력합니다.
7. 키보드의 Enter 키를 누릅니다.

Python SDK

태그를 추가하거나 업데이트하려는 아티팩트 버전을 먼저 가져옵니다. 아티팩트 버전을 가져온 후, 해당 아티팩트 객체의 tag 속성에 접근해 그 아티팩트에 대한 태그를 추가하거나 수정할 수 있습니다. 하나 이상의 태그를 리스트 형태로 아티팩트의 tag 속성에 전달합니다.

다른 아티팩트와 마찬가지로, 새로운 run을 생성하지 않고도 W&B에서 아티팩트를 가져올 수 있고, run을 생성한 뒤 그 run 안에서 아티팩트를 가져올 수도 있습니다. 두 경우 모두 W&B 서버의 아티팩트를 업데이트하려면 아티팩트 객체의 save 메서드를 호출해야 합니다.

아래 코드 셀 중에서 알맞은 것을 복사해 붙여넣어 아티팩트 버전의 태그를 추가하거나 수정합니다. <> 안의 값을 사용자 환경에 맞게 변경하십시오.

다음 코드 스니펫은 새로운 run을 생성하지 않고 아티팩트를 가져와 태그를 추가하는 방법을 보여줍니다:

Add a tag to an artifact version without creating a new run

import wandb

ARTIFACT_TYPE = "<TYPE>"
REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
VERSION = "<artifact_version>"

artifact_name = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}:v{VERSION}"

artifact = wandb.Api().artifact(name = artifact_name, type = ARTIFACT_TYPE)
artifact.tags = ["tag2"] # 리스트에 하나 이상의 태그를 넣어 전달합니다
artifact.save()

다음 코드 스니펫은 새로운 run을 생성하여 아티팩트를 가져오고 태그를 추가하는 방법을 보여줍니다:

Add a tag to an artifact version during a run

import wandb

REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
VERSION = "<artifact_version>"

with wandb.init(entity = "<entity>", project="<project>") as run:

    artifact_name = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}:v{VERSION}"

    artifact = run.use_artifact(artifact_or_name = artifact_name)
    artifact.tags = ["tag2"] # 리스트에 하나 이상의 태그를 넣어 전달합니다
    artifact.save()

​

아티팩트 버전에 속한 태그 업데이트하기

태그는 tags 속성을 재할당하거나 직접 변경(mutate)해서 프로그래밍 방식으로 업데이트할 수 있습니다. W&B는, 그리고 일반적인 Python 코딩 관례에서도, in-place로 변경하기보다는 tags 속성을 재할당할 것을 권장합니다.

예를 들어, 다음 코드 스니펫은 재할당으로 리스트를 업데이트하는 일반적인 방법을 보여줍니다. 간단히 하기 위해 아티팩트 버전에 태그 추가하기 섹션의 코드 예제를 이어서 사용합니다.

artifact.tags = [*artifact.tags, "new-tag", "other-tag"]
artifact.tags = artifact.tags + ["new-tag", "other-tag"]

artifact.tags = set(artifact.tags) - set(tags_to_delete)
artifact.tags = []  # 모든 태그 삭제

다음 코드 스니펫은 인플레이스(in-place) 변경을 사용해 아티팩트 버전에 속한 태그를 업데이트하는 방법을 보여줍니다.

artifact.tags += ["new-tag", "other-tag"]
artifact.tags.append("new-tag")

artifact.tags.extend(["new-tag", "other-tag"])
artifact.tags[:] = ["new-tag", "other-tag"]
artifact.tags.remove("existing-tag")
artifact.tags.pop()
artifact.tags.clear()

​

아티팩트 버전에 속한 태그 보기

W&B Registry에 연결된 아티팩트 버전에 속한 태그를 W&B App UI 또는 Python SDK를 사용해 확인할 수 있습니다.

W&B App

1. W&B Registry로 이동합니다.
2. 레지스트리 카드를 클릭합니다.
3. 태그를 추가하려는 컬렉션 이름 옆의 View details 를 클릭합니다.
4. 아래로 스크롤하여 Versions 섹션으로 이동합니다.

아티팩트 버전에 하나 이상의 태그가 있는 경우 Tags 열에서 해당 태그를 확인할 수 있습니다.

Python SDK

태그를 확인하려면 아티팩트 버전을 먼저 가져옵니다. 아티팩트 버전을 가져온 후에는 아티팩트 객체의 tag 속성을 확인하여 해당 아티팩트에 속한 태그를 볼 수 있습니다.

다른 아티팩트와 마찬가지로, 새 run을 생성하지 않고도 W&B에서 아티팩트를 가져올 수 있고, run을 생성한 뒤 그 run 안에서 아티팩트를 가져올 수도 있습니다.

아래에서 적절한 코드 셀을 복사해 붙여넣어 아티팩트 버전의 태그를 추가하거나 수정하세요. <> 안의 값을 사용자 값으로 교체합니다.

다음 코드 스니펫은 새 run을 생성하지 않고 아티팩트 버전의 태그를 가져와서 확인하는 방법을 보여줍니다:

Add a tag to an artifact version without creating a new run

import wandb

ARTIFACT_TYPE = "<TYPE>"
REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
VERSION = "<artifact_version>"

artifact_name = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}:v{VERSION}"

artifact = wandb.Api().artifact(name = artifact_name, type = artifact_type)
print(artifact.tags)

다음 코드 스니펫은 새 run을 생성하여 아티팩트 버전의 태그를 가져와서 확인하는 방법을 보여줍니다:

Add a tag to an artifact version during a run

import wandb

REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
VERSION = "<artifact_version>"

with wandb.init(entity = "<entity>", project="<project>") as run:

    artifact_name = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}:v{VERSION}"

    artifact = run.use_artifact(artifact_or_name = artifact_name)
    print(artifact.tags)

​

아티팩트 버전에서 태그 제거하기

1. W&B Registry로 이동합니다.
2. 레지스트리 카드를 클릭합니다.
3. 태그를 제거하려는 컬렉션 이름 옆의 View details를 클릭합니다.
4. 아래로 스크롤하여 Versions 섹션으로 이동합니다.
5. 아티팩트 버전 옆의 View를 클릭합니다.
6. Version 탭에서 태그 이름 위에 마우스를 올립니다.
7. 취소 버튼(X 아이콘)을 클릭합니다.

​

기존 태그 검색

W&B App UI를 사용하여 컬렉션과 아티팩트 버전에서 기존 태그를 검색합니다.

1. W&B Registry로 이동합니다.
2. 레지스트리 카드 하나를 클릭합니다.
3. 검색창에 태그 이름을 입력합니다.

​

특정 태그가 있는 아티팩트 버전 찾기

W&B Python SDK를 사용하여 지정된 태그 집합이 달린 아티팩트 버전을 검색합니다.

import wandb

api = wandb.Api()
tagged_artifact_versions = api.artifacts(
    type_name = "<artifact_type>",
    name = "<artifact_name>",
    tags = ["<tag_1>", "<tag_2>"]
)

for artifact_version in tagged_artifact_versions:
    print(artifact_version.tags)