Skip to main content
Registry 管理者は、レジストリの設定で、Registry ロールを設定するユーザーを追加する、またはユーザーを削除することができます。

ユーザーの管理

ユーザーまたはチームを追加する

Registry 管理者は、個々のユーザーまたはチーム全体を Registry に追加できます。Registry にユーザーまたはチームを追加するには、次の手順に従います。
  1. W&B Registry にアクセスします。
  2. ユーザーまたはチームを追加する Registry を選択します。
  3. 右上隅にある gear icon をクリックして、Registry 設定にアクセスします。
  4. Registry access セクションで、Add access をクリックします。
  5. Include users and teams フィールドに、1 つ以上のユーザー名、メールアドレス、またはチーム名を入力します。
  6. Add access をクリックします。
Registry でのユーザーロールの設定 または Registry ロールの権限 について詳しくは、こちらを参照してください。

ユーザーまたはチームを削除する

Registry 管理者は、レジストリから個々のユーザーまたは Teams 全体を削除できます。レジストリからユーザーまたはチームを削除するには、次の手順に従います。
  1. https://wandb.ai/registry/ の W&B Registry にアクセスします。
  2. ユーザーを削除する対象のレジストリを選択します。
  3. 右上隅の歯車アイコンをクリックして、Registry 設定にアクセスします。
  4. Registry access セクションに移動し、削除するユーザー名、メールアドレス、またはチームを入力します。
  5. Delete ボタンをクリックします。
チームからユーザーを削除すると、そのユーザーのレジストリへのアクセス権も削除されます。

レジストリの所有者を変更する

Registry 管理者は、Restricted ViewerViewer を含む任意のメンバーをレジストリの所有者に指定できます。レジストリの所有権は主に責任の所在を明確にするためのもので、ユーザーに割り当てられたロールで付与される権限を超える追加の権限は付与されません。 所有者を変更するには:
  1. https://wandb.ai/registry/ の W&B Registry にアクセスします。
  2. 設定するレジストリを選択します。
  3. 右上にある歯車アイコンをクリックします。
  4. Registry members and roles セクションまでスクロールします。
  5. メンバーの行にカーソルを合わせます。
  6. 行の末尾にある action () メニューをクリックし、Make owner をクリックします。

Registry ロールを設定する

このセクションでは、Registry メンバーのロールを設定する方法を説明します。各ロールの機能、優先順位、デフォルトなど、Registry ロールの詳細については、Registry ロールの詳細を参照してください。
  1. https://wandb.ai/registry/ の W&B Registry にアクセスします。
  2. 設定する Registry を選択します。
  3. 右上にある歯車アイコンをクリックします。
  4. Registry members and roles セクションまでスクロールします。
  5. Member フィールドで、権限を編集するユーザーまたはチームを検索します。
  6. Registry role 列で、ユーザーのロールをクリックします。
  7. ドロップダウンから、ユーザーに割り当てるロールを選択します。

Registry ロールの詳細

以下のセクションでは、Registry ロールについて詳しく説明します。
チームのRegistry ロールは、各メンバーのチームロールとは別のものです。Registry に追加されたチームに所属している場合、W&B は有効な Registry ロールを計算する際に、チーム内でのあなたのロールではなく、チームに割り当てられたRegistry ロールを考慮します。

ロールの種類

W&B Registry には、次のロールがあります。
  • Restricted Viewer: Registry artifact のメタデータに対する読み取り専用アクセス権を付与します。Restricted Viewer は artifact の詳細を表示できますが、artifact file の内容にはアクセスできません。また、コレクション、オートメーション、その他の Registry リソースを作成、更新、削除することもできません。このロールは、専用クラウドおよびセルフマネージド Server v0.75.0 以降で利用できます
  • Viewer: Registry artifact に対する読み取り専用アクセス権を付与します。コレクションの詳細やリンクされた artifact の詳細を表示できるほか、artifact をダウンロードし、W&B SDK の wandb.Run.use_artifact() で使用できます。
  • Member: コレクション、オートメーション、その他の Registry リソースを作成、更新、削除する権限を付与します。また、Registry artifact に対する読み取りアクセス権も付与します。
  • Admin: Member が持つすべての権限に加え、Registry 設定とユーザーロールを管理する権限を付与します。
各ロールに付与される権限の詳細については、ロール権限を参照してください。

ロール権限

次の表は、各 Registry ロールと、それぞれのロールに付与される権限を示しています。

デフォルトロール

W&B では、ユーザーまたはチームが Registry に追加されると、自動的にデフォルトのRegistry ロールが割り当てられます。デフォルトロールは、Registry のロールのドロップダウンに最初に表示されるロールです。必ずしもユーザーに最終的に適用されるロールとは限りません。 デフォルトロールは、デプロイメントタイプとエンティティタイプによって異なります。 1: サービスアカウントには Viewer または Restricted Viewer ロールを割り当てることはできません。サービスアカウントのアクセスがどのように決定されるかについては、サービスアカウントのアクセス を参照してください。 Registry 管理者は、Registry 内の Users および チーム のロールを割り当てたり変更したりできます。 詳細については、Registry でユーザーロールを設定する を参照してください。

有効な Registry ロールと継承された Registry ロール

ユーザーの有効な Registry ロールとは、Registry 内で実際に実行できる操作を決定するロールです。Registry のメンバー一覧では、ユーザーの行にあるロールのドロップダウンの横に、このロールが薄いグレーで表示されます。
ユーザーの有効な Registry ロールを示す Registry メンバー一覧
W&B は、次のソースのうちユーザーに適用される最も上位のロールを選択して、有効なロールを決定します。
  • 制限付き Registry でない場合は、組織のデフォルト Registry ロール。
  • Registry でユーザーに割り当てられたロール。
  • ユーザーが所属するチームに対して Registry で割り当てられたロール。
組織のデフォルト Registry ロール、または Registry に追加されたチームからより上位のロールが適用される場合、ユーザーはその上位ロールを継承します。例:
  • Registry で Viewer ロールを持つユーザーが、その Registry で Admin ロールを持つチームに所属している場合、有効なロールは Admin になります。
  • Registry で Viewer ロールを持つユーザーが、その Registry で Member ロールを持つチームに所属している場合、有効なロールは Member になります。
  • Registry で Member ロールを持つユーザーは、その Registry で Viewer ロールを持つチームに所属していても、有効なロールは Member のままです。
つまり、デフォルトまたは割り当てられた Registry ロールは、ユーザーの有効なロールより下位になる場合があります。
サービスアカウントは、チームから上位の Registry 権限を継承しません。詳細については、サービスアカウントのアクセスを参照してください。

サービスアカウントのアクセス

サービスアカウントは、Registry ロールの継承における例外です。サービスアカウントは、所属チームの上位 Registry 権限を継承しません。たとえば、チームが Registry に対する Admin アクセス権を持っている場合でも、そのチームのサービスアカウントには Admin アクセスではなく、自動的に付与されるサービスアカウントのアクセスレベルのみが付与されます。 Registry 管理者は、サービスアカウントを Member または Admin ロールで Registry に追加することで、サービスアカウントにより高いアクセス権を明示的に付与できます。 サービスアカウントに自動的に付与されるアクセスは、Registry の可視性によって異なります。
  • 組織の可視性: サービスアカウントには自動的に Member アクセスが付与されます。
  • 制限付きの可視性: サービスアカウントのいずれかのチームが Registry に対して Member または Admin アクセスを持つ場合にのみ、サービスアカウントには自動的に Member アクセスが付与されます。サービスアカウントが所属するすべてのチームが Viewer または Restricted Viewer アクセスを持つ場合、サービスアカウントにはアクセスが自動的に付与されません。
Registry の可視性タイプの詳細については、可視性タイプを参照してください。

Restricted Viewer ロールの詳細

Restricted Viewer ロールは一般提供 (GA) です。専用クラウドおよびセルフマネージドでは、Server v0.75.0 以降が必須です。 このロールでは、コレクション、自動化、その他の Registry リソースを作成、更新、削除することはできず、Registry 内の Artifacts に読み取り専用でアクセスできます。 Viewer とは異なり、Restricted Viewer では次のことはできません:
  • artifact ファイルをダウンロードしたり、ファイルの内容にアクセスしたりできません。
  • W&B SDK で wandb.Run.use_artifact() を使用して artifact を利用できません。

SDK の互換性

SDK バージョン要件Restricted Viewer として W&B SDK を使用して artifact にアクセスするには、W&B SDK バージョン 0.19.9 以降を使用する必要があります。そうしないと、一部の SDK コマンドで権限エラーが発生します。
Restricted Viewer が SDK を使用する場合、特定の function は利用できないか、動作が異なります。 次の method は利用できず、権限エラーが発生します。 次の method でアクセスできるのは artifact のメタデータのみです。

Registry 間の権限

1 人のユーザーが、複数の Registry でそれぞれ異なるロールを持つことがあります。たとえば、あるユーザーは Registry A では Restricted Viewer で、Registry B では Viewer である場合があります。この場合:
  • 両方の Registry にリンクされている同じ artifact でも、アクセスレベルは異なります
  • Registry A では、そのユーザーは Restricted Viewer であるため、ファイルをダウンロードしたり artifact を使用したりできません
  • Registry B では、そのユーザーは Viewer であるため、ファイルをダウンロードして artifact を使用できます
  • つまり、アクセス権は artifact にアクセスした Registry によって決まります