> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 별칭으로 아티팩트 버전 참조하기

> 기본 별칭, 맞춤형 별칭, 보호된 별칭을 사용하여 레지스트리에서 특정 아티팩트 버전을 참조합니다.

하나 이상의 별칭으로 특정 [아티팩트 버전](/ko/products/wandb/artifacts/create-a-new-artifact-version)을 참조할 수 있습니다. 같은 이름으로 연결하는 각 아티팩트에는 [W\&B가 자동으로 별칭을 부여합니다](/ko/products/registry/aliases#default-aliases). 특정 아티팩트 버전을 참조하기 위해 [하나 이상의 맞춤형 별칭을 생성](/ko/products/registry/aliases#custom-aliases)할 수도 있습니다.

Registry UI에서 별칭은 사각형 안에 해당 별칭의 이름이 적힌 형태로 표시됩니다. [보호된 별칭](/ko/products/registry/aliases#protected-aliases)은 자물쇠 아이콘이 있는 회색 사각형으로 표시되고, 그 외의 별칭은 주황색 사각형으로 표시됩니다. 별칭은 레지스트리 간에 공유되지 않습니다.

<Note>
  **별칭과 태그는 각각 언제 사용하나요?**

  특정 아티팩트 버전을 참조하려면 별칭을 사용하세요. 각 별칭은 컬렉션 내에서 고유하며, 특정 별칭은 한 번에 하나의 아티팩트 버전에만 지정할 수 있습니다.

  공통 주제를 기준으로 아티팩트 버전이나 컬렉션을 정리하고 그룹화하려면 태그를 사용하세요. 여러 아티팩트 버전과 컬렉션이 같은 태그를 공유할 수 있습니다.
</Note>

아티팩트 버전에 별칭을 추가할 때 [레지스트리 자동화](/ko/products/wandb/automations/automation-events#registry)를 시작하여 Slack 채널로 알림을 보내거나 웹훅을 트리거하도록 선택할 수 있습니다. 자동화가 호출하는 웹훅의 요청에 액세스 토큰이나 기타 민감한 값이 필요하다면, 해당 문자열을 [팀 시크릿](/ko/products/wandb/platform/secrets)으로 저장해 두고 자동화용 웹훅을 설정할 때 선택하세요.

<h2 id="default-aliases">
  기본 별칭
</h2>

W\&B는 같은 이름으로 연결하는 각 아티팩트 버전에 다음 별칭을 자동으로 부여합니다.

* `latest` 별칭: 컬렉션에 가장 최근에 연결한 아티팩트 버전에 부여됩니다.
* 고유한 버전 번호: W\&B는 연결되는 아티팩트 버전을 0부터 세어, 그 숫자를 바탕으로 각 아티팩트에 고유한 버전 번호를 부여합니다.

예를 들어 `zoo_model`이라는 아티팩트를 세 번 연결하면 W\&B는 `v0`, `v1`, `v2` 별칭을 차례로 생성합니다. 이때 `v2`에는 `latest` 별칭도 함께 부여됩니다.

<h2 id="custom-aliases">
  맞춤형 별칭
</h2>

사용 사례에 맞게 특정 아티팩트 버전에 맞춤형 별칭을 하나 이상 만들 수 있습니다. 예를 들면 다음과 같습니다.

* `dataset_version_v0`, `dataset_version_v1`, `dataset_version_v2` 같은 별칭을 사용하여 모델이 어떤 데이터셋으로 트레이닝되었는지 파악할 수 있습니다.
* `best_model` 별칭을 사용하여 성능이 가장 좋은 아티팩트 모델 버전을 추적할 수 있습니다.

레지스트리에서 [**Member** 또는 **Admin** 레지스트리 역할](/ko/products/registry/configure_registry#role-types)을 가진 사용자는 누구나 해당 레지스트리에 연결된 아티팩트의 맞춤형 별칭을 추가하거나 제거할 수 있습니다. [**Restricted Viewer** 또는 **Viewer** 역할](/ko/products/registry/configure_registry#role-types)을 가진 사용자는 별칭을 추가하거나 제거할 수 없습니다.

<Note>
  [보호된 별칭](/ko/products/registry/aliases#protected-aliases)을 사용하면 수정이나 삭제되지 않도록 보호할 아티팩트 버전에 레이블을 지정하고 이를 파악할 수 있습니다.
</Note>

맞춤형 별칭은 레지스트리 또는 W\&B Python SDK로 만들 수 있습니다. 아래에서 사용 사례에 가장 적합한 탭을 클릭하세요.

<Tabs>
  <Tab title="Registry">
    1. 레지스트리로 이동합니다.
    2. 컬렉션에서 **View details** 버튼을 클릭합니다.
    3. **Versions** 섹션에서 아티팩트 버전 옆의 **View**를 클릭합니다.
    4. **Aliases** 필드 옆의 **+** 버튼을 클릭하여 별칭을 하나 이상 추가합니다.
  </Tab>

  <Tab title="W&B Python SDK">
    Python SDK로 아티팩트 버전을 컬렉션에 연결할 때 [`wandb.Run.link_artifact()`](/ko/products/wandb/ref/python/experiments/run#method-run-link_artifact)의 `alias` 매개변수에 하나 이상의 별칭 목록을 인수로 전달할 수 있습니다(선택 사항). 전달한 별칭이 아직 없으면 W\&B가 해당 별칭(보호되지 않은 별칭)을 자동으로 만듭니다.

    다음 코드 스니펫은 W\&B Python SDK로 아티팩트 버전을 컬렉션에 연결하고 해당 아티팩트 버전에 별칭을 추가하는 방법을 보여줍니다. `<>` 안의 값을 실제 값으로 바꾸세요.

    ```python theme={"system"}
    import wandb

    # run 초기화
    with wandb.init(entity = "<team_entity>", project = "<project_name>") 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, 
            aliases = ["<alias_1>", "<alias_2>"]
            )
    ```
  </Tab>
</Tabs>

<h3 id="protected-aliases">
  보호된 별칭
</h3>

수정하거나 삭제하면 안 되는 아티팩트 버전에 레이블을 지정하고 이를 파악하려면 [보호된 별칭](/ko/products/registry/aliases#protected-aliases)을 사용하세요. 예를 들어, 조직의 머신러닝 프로덕션 파이프라인에서 사용 중인 아티팩트 버전에 레이블을 지정하고 파악할 때 `production` 보호된 별칭을 사용할 수 있습니다.

**Admin** 역할이 있는 [레지스트리 관리자](/ko/products/registry/configure_registry#role-types) 사용자와 [서비스 계정](/ko/support/models/articles/what-is-a-service-account-and-why-is-it-)은 보호된 별칭을 생성하고, 아티팩트 버전에 보호된 별칭을 추가하거나 제거할 수 있습니다. **Member**, **Viewer**, **Restricted Viewer** 역할이 있는 사용자와 서비스 계정은 보호된 버전의 연결을 해제하거나 보호된 별칭이 포함된 컬렉션을 삭제할 수 없습니다. 자세한 내용은 [레지스트리 액세스 설정](/ko/products/registry/configure_registry)을 참조하세요.

자주 사용하는 보호된 별칭은 다음과 같습니다.

* **Production**: 프로덕션에서 사용할 준비가 된 아티팩트 버전입니다.
* **Staging**: 테스트할 준비가 된 아티팩트 버전입니다.

<h4 id="create-a-protected-alias">
  보호된 별칭 만들기
</h4>

Registry UI에서 보호된 별칭을 만드는 방법은 다음과 같습니다.

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) 에서 Registry로 이동하세요.
2. 레지스트리를 선택하세요.
3. 페이지 오른쪽 상단의 톱니바퀴 버튼을 클릭하여 레지스트리 설정을 여세요.
4. **Protected Aliases** 섹션에서 **+** 버튼을 클릭하여 보호된 별칭을 하나 이상 추가하세요.

생성된 보호된 별칭은 **Protected Aliases** 섹션에 자물쇠 아이콘이 있는 회색 사각형으로 각각 표시됩니다.

<Note>
  보호되지 않은 맞춤형 별칭과 달리, 보호된 별칭은 Registry UI에서만 만들 수 있으며 Python SDK를 사용해 프로그래밍 방식으로는 만들 수 없습니다. 반면 아티팩트 버전에 보호된 별칭을 추가할 때는 Registry UI와 Python SDK를 모두 사용할 수 있습니다.
</Note>

Registry UI에서 아티팩트 버전에 보호된 별칭을 추가하는 방법은 다음과 같습니다.

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) 에서 Registry로 이동하세요.
2. 컬렉션에서 **View details** 버튼을 클릭하세요.
3. **Versions** 섹션에서 원하는 아티팩트 버전의 **View** 버튼을 선택하세요.
4. **Aliases** 필드 옆의 **+** 버튼을 클릭하여 보호된 별칭을 하나 이상 추가하세요.

보호된 별칭을 생성한 후에는 Admin이 W\&B Python SDK를 사용해 프로그래밍 방식으로 해당 별칭을 아티팩트 버전에 추가할 수 있습니다. 아티팩트 버전에 보호된 별칭을 추가하는 예시는 위의 [맞춤형 별칭 만들기](#custom-aliases) 섹션에 있는 Registry 및 Python SDK 탭을 참조하세요.

<h2 id="find-existing-aliases">
  기존 별칭 찾기
</h2>

레지스트리의 [전역 검색 창](/ko/products/registry/search_registry#search-for-registry-items)에서 기존 별칭을 찾을 수 있습니다. 보호된 별칭을 찾으려면 다음 단계를 따르세요.

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) 에서 Registry로 이동하세요.
2. 페이지 상단의 검색 창에 검색어를 입력한 다음 Enter 키를 눌러 검색하세요.

입력한 검색어가 기존 레지스트리, 컬렉션 이름, 아티팩트 버전 태그, 컬렉션 태그 또는 별칭과 일치하면 검색 창 아래에 검색 결과가 표시됩니다.

<h2 id="example">
  예시
</h2>

<Note>
  다음 코드 예시는 [Registry Tutorial notebook](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/wandb_registry/zoo_wandb.ipynb)에서 이어지는 내용입니다. 다음 코드를 사용하려면 먼저 [노트북의 설명에 따라 Zoo 데이터셋을 가져와 처리](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/wandb_registry/zoo_wandb.ipynb#scrollTo=87fecd29-8146-41e2-86fb-0bb4e3e3350a)해야 합니다. Zoo 데이터셋이 준비되면 아티팩트 버전을 생성하고 맞춤형 별칭을 추가할 수 있습니다.
</Note>

다음 코드 스니펫은 아티팩트 버전을 생성하고 맞춤형 별칭을 추가하는 방법을 보여 줍니다. 이 예시에서는 [UCI Machine Learning Repository](https://archive.ics.uci.edu/dataset/111/zoo)의 Zoo 데이터셋과 `Zoo_Classifier_Models` 레지스트리의 `Model` 컬렉션을 사용합니다.

```python theme={"system"}
import wandb

# run 초기화
with wandb.init(entity = "smle-reg-team-2", project = "zoo_experiment") as run:

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

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

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

    # 아티팩트 버전을 컬렉션에 연결합니다
    # 이 아티팩트 버전에 별칭을 하나 이상 추가합니다
    run.link_artifact(
        artifact = artifact,
        target_path = target_path,
        aliases = ["production-us", "production-eu"]
        )
```

1. 먼저 아티팩트 객체(`wandb.Artifact()`)를 생성합니다.
2. 다음으로 `wandb.Artifact.add_file()`을 사용하여 데이터셋 PyTorch 텐서 두 개를 아티팩트 객체에 추가합니다.
3. 마지막으로 `link_artifact()`를 사용하여 아티팩트 버전을 `Zoo_Classifier_Models` 레지스트리의 `Model` 컬렉션에 연결합니다. 이때 `aliases` 매개변수에 `production-us`와 `production-eu`를 인수로 전달하여 아티팩트 버전에 맞춤형 별칭 두 개도 추가합니다.


## Related topics

- [예시 코드 및 노트북](/ko/products/wandb/examples.md)