> ## 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.

# 레지스트리 개요

> 레지스트리를 사용하여 조직 전체에서 아티팩트 버전을 관리하고 공유하세요

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Try in Colab
  </a>;

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/wandb_registry/zoo_wandb.ipynb" />

레지스트리는 조직 내 [W\&B 아티팩트 버전](/ko/products/wandb/artifacts/create-a-new-artifact-version)을 선별하여 관리하는 중앙 저장소입니다. 조직 내에서 [권한이 있는](/ko/products/registry/configure_registry) 사용자는 소속 팀과 관계없이 모든 아티팩트를 [다운로드하여 사용](/ko/products/registry/download_use_artifact)하고, 공유하며, 아티팩트의 라이프사이클을 공동으로 관리할 수 있습니다.

레지스트리를 사용하여 아티팩트 버전을 추적하고, 아티팩트의 사용 및 변경 이력을 감사하고, 아티팩트의 거버넌스와 규정 준수를 보장하며, [모델 CI/CD와 같은 다운스트림 프로세스를 자동화](/ko/products/wandb/automations)하세요.

요약하면, 레지스트리로 다음 작업을 할 수 있습니다.

* 머신러닝 작업 요건을 충족하는 아티팩트 버전을 조직 내 다른 사용자에게 [승격](/ko/products/registry/link_version)합니다.
* [태그로 아티팩트](/ko/products/registry/organize-with-tags)를 정리하여 특정 아티팩트를 쉽게 찾거나 참조합니다.
* [아티팩트의 리니지](/ko/products/registry/lineage)를 추적하고 변경 이력을 감사합니다.
* 모델 CI/CD와 같은 다운스트림 프로세스를 [자동화](/ko/products/wandb/automations)합니다.
* 각 레지스트리의 아티팩트에 액세스할 수 있는 [조직 내 사용자를 관리](/ko/products/registry/configure_registry)합니다.

다음 이미지는 Registry 시작 페이지를 보여줍니다.

이미지에는 위에서 아래로 즐겨찾기에 추가한 레지스트리와 가장 최근에 업데이트된 레지스트리 및 컬렉션이 표시됩니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/registry/_media/registry_landing_page.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=7395409684b38116afe02734bb13a66d" alt="Registry" width="3456" height="1996" data-path="products/registry/_media/registry_landing_page.png" />
</Frame>

<h2 id="learn-the-basics">
  기본 개념 알아보기
</h2>

각 조직에는 처음에 모델과 데이터셋 아티팩트를 정리하는 데 사용할 수 있는 **Models**와 **Datasets**라는 두 개의 레지스트리가 포함되어 있습니다. [조직의 요구 사항에 따라 다른 아티팩트 유형을 정리할 추가 레지스트리를 생성](/ko/products/registry/create_registry)할 수 있습니다.

각 [*레지스트리*](/ko/products/registry/configure_registry)는 하나 이상의 [*컬렉션*](/ko/products/registry/create_collection)으로 구성됩니다. 각 컬렉션은 서로 다른 작업이나 사용 사례를 나타냅니다.

아티팩트를 레지스트리에 추가하려면 먼저 [특정 아티팩트 버전을 W\&B에 로깅](/ko/products/wandb/artifacts/create-a-new-artifact-version)하세요. 아티팩트를 로깅할 때마다 W\&B가 해당 아티팩트에 버전을 자동으로 부여합니다. 아티팩트 버전은 0부터 시작하므로 첫 번째 버전은 `v0`, 두 번째 버전은 `v1`이며, 이후에도 같은 방식으로 이어집니다.

아티팩트를 W\&B에 로깅한 후에는 해당 아티팩트 버전을 레지스트리의 컬렉션에 연결할 수 있습니다.

<Note>
  "연결"이라는 용어는 W\&B가 아티팩트를 저장하는 위치와 레지스트리에서 아티팩트에 액세스할 수 있는 위치를 연결하는 포인터를 뜻합니다. 아티팩트를 컬렉션에 연결해도 W\&B는 아티팩트를 복제하지 않습니다.
</Note>

다음 코드 예시는 `"my_model.txt"`라는 모델 아티팩트를 로깅하고, `"model"`이라는 레지스트리 내의 `"first-collection"`이라는 컬렉션에 연결합니다.

1. `wandb.init()`으로 W\&B run을 초기화하세요.
2. `wandb.Run.log()`로 아티팩트를 W\&B에 로깅하세요.
3. 레지스트리가 있는지 확인하세요.
4. 아티팩트 버전을 연결할 컬렉션과 레지스트리의 이름을 지정하세요.
5. `wandb.Run.link_artifact()`를 사용하여 아티팩트를 컬렉션에 연결하세요.

이 Python 코드를 스크립트로 저장하고 실행하세요. W\&B Python SDK 버전 0.18.6 이상이 필요합니다.

```python title="hello_collection.py" theme={"system"}
import wandb
import random

# 아티팩트를 추적할 W&B run을 초기화합니다
with wandb.init(project="registry_quickstart") as run:
    # 로깅할 수 있도록 모의 모델 파일을 생성합니다
    with open("my_model.txt", "w") as f:
        f.write("Model: " + str(random.random()))

    # 아티팩트를 W&B에 로깅합니다
    logged_artifact = run.log_artifact(
        artifact_or_path="./my_model.txt", 
        name="mnist_model", 
        type="model" # 아티팩트 유형을 지정합니다
    )

    # 아티팩트를 게시할 컬렉션과 레지스트리의
    # 이름을 지정합니다
    COLLECTION_NAME = "first-collection"
    REGISTRY_NAME = "model"

    # 아티팩트를 레지스트리에 연결합니다
    run.link_artifact(
        artifact=logged_artifact, 
        target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"
    )
```

반환된 run 객체'의 `wandb.Run.link_artifact(target_path = "")` 방법에서 지정한 컬렉션이 지정한 레지스트리에 없으면 W\&B가 자동으로 컬렉션을 생성합니다.

이전 예시에 이어 스크립트를 실행한 후 Registry로 이동하여 본인과 조직의 다른 구성원이 게시한 아티팩트 버전을 확인하세요. 프로젝트 사이드바에서 **Applications** 아래의 **Registry**를 선택하세요. `"Model"` 레지스트리를 선택하세요. 레지스트리 내에서 연결한 아티팩트 버전이 포함된 `"first-collection"` 컬렉션을 확인할 수 있습니다.

아티팩트 버전을 레지스트리 내 컬렉션에 연결하면 적절한 권한이 있는 조직 구성원이 아티팩트 버전을 [확인](/ko/products/registry/lineage), [다운로드](/ko/products/registry/download_use_artifact), [정리](/ko/products/registry/organize-with-tags) 및 관리하고, 다운스트림 자동화를 생성하는 등의 작업을 수행할 수 있습니다.

<Note>
  아티팩트 버전이 메트릭을 로깅하는 경우(예: `wandb.Run.log_artifact()` 사용), 해당 버전의 상세 페이지에서 메트릭을 확인하고 컬렉션'의 페이지에서 아티팩트 버전 간 메트릭을 비교할 수 있습니다. [레지스트리에서 연결된 아티팩트 확인](/ko/products/registry/link_version#view-linked-artifacts-in-a-registry)을 참고하세요.
</Note>

<h2 id="enable-registry">
  레지스트리 활성화
</h2>

배포 유형에 따라 다음 조건을 충족하여 레지스트리를 활성화하세요:

| 배포 유형 | 활성화 방법 |
| - | - |
| Multi-tenant Cloud | 별도의 액션이 필요하지 않습니다. W\&B App에서 레지스트리를 사용할 수 있습니다. |
| Dedicated Cloud | 계정 담당 팀에 문의하여 배포 환경에서 레지스트리를 활성화하세요. |
| Self-Managed | Server v0.71.0 이상에서는 별도의 액션이 필요하지 않습니다. 레지스트리는 기본적으로 활성화됩니다. 지원되는 이전 Server 버전에서는 W\&B 계정 담당 팀에 문의하여 레지스트리를 활성화하세요. |

<h2 id="resources-to-get-started">
  시작하기 위한 자료
</h2>

사용 사례에 따라 다음 자료를 살펴보고 W\&B 레지스트리를 시작하세요:

* 튜토리얼 비디오를 확인하세요:
  * [W\&B 레지스트리 시작하기](https://www.youtube.com/watch?v=p4XkVOsjIeM)
* W\&B [모델 CI/CD](https://www.youtube.com/watch?v=VWdRQL0CsAk\&list=PLD80i8An1OEGECFPgY-HPCNjXgGu-qGO6) 과정을 수강하고 다음 방법을 알아보세요:
  * 레지스트리를 사용하여 아티팩트를 관리하고 버전을 지정하며, 리니지를 추적하고, 모델을 다양한 라이프사이클 단계로 승격합니다.
  * 웹훅을 사용하여 모델 관리 워크플로를 자동화합니다.
  * 모델 평가, 모니터링, 배포를 위해 레지스트리를 외부 ML 시스템 및 도구와 통합합니다.


## Related topics

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