> ## 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.
# Reference an artifact version with aliases
> Use default, custom, and protected aliases to reference specific artifact versions in Registry.
1 つ以上のエイリアスで特定の[アーティファクトのバージョン](/ja/products/wandb/artifacts/create-a-new-artifact-version)を参照します。同じ名でリンクする各アーティファクトに、[W\&B が自動的にエイリアスを割り当てます](/ja/products/registry/aliases#default-aliases)。[1 つ以上のカスタムエイリアスを作成](/ja/products/registry/aliases#custom-aliases)して、特定のアーティファクトのバージョンを参照することもできます。
Registry UI では、エイリアスはその名が表示された長方形として表示されます。[エイリアスが保護されている](/ja/products/registry/aliases#protected-aliases)場合は、ロックアイコン付きの灰色の長方形として表示されます。それ以外の場合は、オレンジ色の長方形として表示されます。エイリアスはレジストリ間で共有されません。
**エイリアスとタグの使い分け**
特定のアーティファクトのバージョンを参照するには、エイリアスを使用します。コレクション内の各エイリアスは一意です。特定のエイリアスを持てるアーティファクトのバージョンは、一度に 1 つだけです。
共通のテーマに基づいてアーティファクトのバージョンやコレクションを整理、グループ化するには、タグを使用します。複数のアーティファクトのバージョンやコレクションで同じタグを共有できます。
アーティファクトのバージョンにエイリアスを追加するときに、必要に応じて [Registry オートメーション](/ja/products/wandb/automations/automation-events#registry)を開始して、Slack チャンネルに通知したり、webhook をトリガーしたりできます。オートメーションが呼び出す webhook のリクエストにアクセストークンやその他の機密値が必要な場合は、それらの文字列を[チームシークレット](/ja/products/wandb/platform/secrets)として保存し、オートメーションの webhook を設定するときに選択します。
デフォルトのエイリアス
W\&B は、同じ名でリンクする各アーティファクトのバージョンに、以下のエイリアスを自動的に割り当てます。
* コレクションにリンクした最新のアーティファクトのバージョンには、`latest` エイリアスを割り当てます。
* 一意のバージョン番号を割り当てます。W\&B は、リンクしたアーティファクトのバージョンをゼロから数えます。W\&B は、この数値を使用して、そのアーティファクトに一意のバージョン番号を割り当てます。
例えば、`zoo_model` という名のアーティファクトを 3 回リンクすると、W\&B はそれぞれ `v0`、`v1`、`v2` という 3 つのエイリアスを作成します。`v2` には `latest` エイリアスも付与されます。
カスタムエイリアス
独自のユースケースに基づいて、特定の アーティファクトのバージョン に 1 つ以上のカスタムエイリアスを作成します。例:
* `dataset_version_v0`、`dataset_version_v1`、`dataset_version_v2` などのエイリアスを使用して、モデルがどのデータセットでトレーニングされたかを特定できます。
* `best_model` エイリアスを使用して、最もパフォーマンスの高いアーティファクトのモデルバージョンを追跡できます。
registry で [**Member** または **Admin** Registry ロール](/ja/products/registry/configure_registry#role-types) を持つユーザーは、その registry 内のリンクされたアーティファクトからカスタムエイリアスを追加または削除できます。[**Restricted Viewer** または **Viewer** ロール](/ja/products/registry/configure_registry#role-types) を持つユーザーは、エイリアスを追加または削除できません。
[保護されたエイリアス](/ja/products/registry/aliases#protected-aliases) は、変更または削除から保護する アーティファクトのバージョン にラベルを付けて特定する方法を提供します。
Registry または W\&B Python SDK を使用してカスタムエイリアスを作成できます。ユースケースに基づいて、ニーズに最も適したタブをクリックしてください。
1. Registry にアクセスします。
2. コレクション内の **View details** ボタンをクリックします。
3. **Versions** セクション内で、アーティファクトのバージョンの横にある **View** をクリックします。
4. **Aliases** フィールドの横にある **+** ボタンをクリックして、1 つ以上のエイリアスを追加します。
Python SDK を使用して アーティファクトのバージョン をコレクションにリンクするときに、[`wandb.Run.link_artifact()`](/ja/products/wandb/ref/python/experiments/run#method-run-link_artifact) の `alias` パラメーターの引数として、1 つ以上のエイリアスのリストをオプションで指定できます。指定したエイリアスがまだ存在しない場合、W\&B は (保護されていない) エイリアスを作成します。
次のコードスニペットは、W\&B Python SDK を使用して アーティファクトのバージョン をコレクションにリンクし、その アーティファクトのバージョン にエイリアスを追加する方法を示しています。`<>` 内の値を独自の値に置き換えてください:
```python theme={"system"}
import wandb
# run を初期化します
with wandb.init(entity = "", project = "") as run:
# アーティファクト オブジェクトを作成します
# type パラメーターはアーティファクト オブジェクトのタイプと
# コレクションのタイプの両方を指定します
artifact = wandb.Artifact(name = "", type = "")
# アーティファクト オブジェクトにファイルを追加します。
# ローカルマシン上のファイルへのパスを指定します。
artifact.add_file(local_path = "")
# アーティファクトをリンクするコレクションと registry を指定します
REGISTRY_NAME = ""
COLLECTION_NAME = ""
target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"
# artifact version をコレクションにリンクします
# この artifact version に 1 つ以上のエイリアスを追加します
run.link_artifact(
artifact = artifact,
target_path = target_path,
aliases = ["", ""]
)
```
保護されたエイリアス
変更や削除を防ぐ必要があるアーティファクトのバージョンにラベルを付けて識別するには、[保護されたエイリアス](/ja/products/registry/aliases#protected-aliases)を使用します。例えば、組織の機械学習の本番パイプラインで使用されているアーティファクトのバージョンにラベルを付けて識別するには、`production` という保護されたエイリアスの使用を検討してください。
[Registry 管理者](/ja/products/registry/configure_registry#role-types)ユーザーと **Admin** ロールを持つ[サービスアカウント](/ja/support/models/articles/what-is-a-service-account-and-why-is-it-)は、保護されたエイリアスを作成し、アーティファクトのバージョンに保護されたエイリアスを追加したり、削除したりできます。**Member**、**Viewer**、**Restricted Viewer** ロールを持つユーザーとサービスアカウントは、保護されたバージョンのリンクを解除したり、保護されたエイリアスを含むコレクションを削除したりすることはできません。詳細は[Registry アクセスの設定](/ja/products/registry/configure_registry)を参照してください。
よく使用される保護されたエイリアスは次のとおりです。
* **本番**: アーティファクトのバージョンが本番で使用できる準備完了の状態です。
* **ステージング**: アーティファクトのバージョンがテストできる準備完了の状態です。
保護されたエイリアスを作成する
以下の手順では、Registry UI で保護されたエイリアスを作成する方法を説明します。
1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) の Registry にアクセスします。
2. Registry を選択します。
3. ページの右上にある歯車ボタンをクリックして、Registry の設定を表示します。
4. **Protected Aliases** セクションで、**+** ボタンをクリックして、保護されたエイリアスを 1 つ以上追加します。
作成後、各保護されたエイリアスは、**Protected Aliases** セクションにロックアイコン付きの灰色の長方形として表示されます。
保護されていないカスタムエイリアスとは異なり、保護されたエイリアスの作成は Registry UI でのみ可能で、Python SDK を使用してプログラムから作成することはできません。アーティファクトのバージョンに保護されたエイリアスを追加するには、Registry UI または Python SDK を使用できます。
以下の手順では、Registry UI でアーティファクトのバージョンに保護されたエイリアスを追加する方法を説明します。
1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) の Registry にアクセスします。
2. コレクションの **View details** ボタンをクリックします。
3. **Versions** セクションで、特定のアーティファクトのバージョンの **View** ボタンを選択します。
4. **Aliases** フィールドの横にある **+** ボタンをクリックして、保護されたエイリアスを 1 つ以上追加します。
保護されたエイリアスを作成すると、管理者は W\&B Python SDK を使用して、プログラムからアーティファクトのバージョンに追加できます。アーティファクトのバージョンに保護されたエイリアスを追加する例については、上記の[カスタムエイリアスを作成する](#custom-aliases)セクションの Registry タブと Python SDK タブを参照してください。
既存のエイリアスを検索する
Registry の[グローバル検索バー](/ja/products/registry/search_registry#search-for-registry-items)で既存のエイリアスを検索できます。保護されたエイリアスを検索するには、次の手順に従います。
1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) の Registry にアクセスします。
2. ページ上部の検索バーに検索語を入力します。Enter キーを押して検索します。
指定した検索語が既存の registry、コレクション名、アーティファクトのバージョンのタグ、コレクションのタグ、またはエイリアスと一致すると、検索バーの下に検索結果が表示されます。
例
次のコード例は、[Registry Tutorial ノートブック](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 データセットを取得したら、アーティファクトのバージョンを作成し、カスタムエイリアスを追加できます。
次のコードスニペットは、アーティファクトのバージョンを作成し、カスタムエイリアスを追加する方法を示します。この例では、[UCI Machine Learning Repository](https://archive.ics.uci.edu/dataset/111/zoo) の Zoo データセットと、`Zoo_Classifier_Models` Registry の `Model` コレクションを使用します。
```python theme={"system"}
import wandb
# 実行を初期化します
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 を指定します
REGISTRY_NAME = "Model"
COLLECTION_NAME = "Zoo_Classifier_Models"
target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"
# アーティファクトバージョンをコレクションにリンクします
# このアーティファクトバージョンに1つ以上のエイリアスを追加します
run.link_artifact(
artifact = artifact,
target_path = target_path,
aliases = ["production-us", "production-eu"]
)
```
1. まず、アーティファクト オブジェクト (`wandb.Artifact()`) を作成します。
2. 次に、`wandb.Artifact.add_file()` を使用して、2 つのデータセット PyTorch テンソルをアーティファクト オブジェクトに追加します。
3. 最後に、`link_artifact()` を使用して、アーティファクトのバージョンを `Zoo_Classifier_Models` Registry 内の `Model` コレクションにリンクします。また、`aliases` パラメーターに `production-us` と `production-eu` を引数として渡し、アーティファクトのバージョンに 2 つのカスタム エイリアスを追加します。