Skip to content

Commit 66811d7

Browse files
committed
docs(admin): bundle CSV export move, Container Registry ssl_verify, model card bulk vfolder trash, admin deployment route
Part of the recent main-branch docs catch-up plan (Work Items 3 + 4 + 12). Source PRs: - FR-2824 (#7366) move CSV export to BAITable bottom-right for Keypair/User/Project resource policy lists - FR-621 (#7354) add ssl_verify checkbox to Container Registry Editor - FR-2622 family (#6881, #6883, #7135, #7250) Also-delete-model-folder option + trash notification on model card delete (single + bulk), with cascade warning - FR-2847 (#7312) split admin deployment detail route under /admin-deployments/:id Changes in admin_menu.md across all 4 languages: - Manage Resource Policies: CSV export now in BAITable bottom-right slot (was header) for all three policy tabs. - Manage docker registry: new SSL Verification field with default-enabled note and MITM security tradeoff. - Manage Model Cards: Also-delete-model-folder checkbox documented (single + bulk) using real i18n labels; cascade warning for folders referenced by other model cards; restore path via Data > Trash. New :::note for /admin-deployments/:id admin-only route. - Stable English anchor <a id="manage-model-cards"></a> added so vfolder.md (PR F) cross-reference resolves in all locales. 3 screenshot TODOs (resource_policy_list_csv.png, container_registry_editor_modal.png, model_card_delete_with_folder.png).
1 parent 9f5d1a8 commit 66811d7

4 files changed

Lines changed: 96 additions & 4 deletions

File tree

packages/backend.ai-webui-docs/src/en/admin_menu/admin_menu.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -246,6 +246,8 @@ also displayed in the Permission panel.
246246

247247
<a id="manage-models-cards"></a>
248248

249+
<a id="manage-model-cards"></a>
250+
249251
## Manage Model Cards
250252

251253
Model cards in the Model Store are created and managed through the [Admin Model Store Management](#admin-model-store-management) interface. Each model card is linked to a storage folder (vfolder) that contains the actual model files.
@@ -404,6 +406,20 @@ Click the edit icon next to the model card name to modify an existing model card
404406

405407
You can delete an individual model card by clicking the delete icon next to its name, or perform bulk deletion by selecting multiple model cards with the row checkboxes and clicking the red trash-bin button next to the selection count.
406408

409+
![](../images/model_card_delete_with_folder.png)
410+
<!-- TODO: Recapture screenshot of the model card delete dialog showing the "Also delete the associated model folder" option -->
411+
412+
The deletion confirmation dialog includes an **Also delete the associated model folder** option:
413+
414+
- When this option is checked, the storage folder (vfolder) linked to the model card is moved to the trash at the same time the model card is removed. A trash notification appears so superadmins can confirm that the linked folder was sent to the trash, and the folder can be restored permanently from **Data > Trash** if needed. Note that deleting the associated folder also removes every other model card that references the same folder.
415+
- When this option is unchecked, only the model card record is removed; the linked storage folder remains untouched and can be reused for another model card.
416+
417+
The same behavior applies to **bulk deletion** (the label becomes **Also delete all associated model folders**): each selected model card's linked storage folder is moved to the trash when the option is checked, and a trash notification is shown for each folder that was moved.
418+
419+
:::note
420+
Each individual admin deployment now has its own dedicated route at `/admin-deployments/:id`. When you open a deployment from the Admin Serving page, the URL changes to this path so that the deployment detail can be linked to or bookmarked directly.
421+
:::
422+
407423
<a id="prometheus-query-presets"></a>
408424

409425
## Prometheus Query Presets
@@ -678,7 +694,10 @@ so use it with caution.
678694
You can select and display only the columns you want by clicking the `Setting (Gear)` button at the
679695
bottom right of the table.
680696

681-
To save the current resource policy as a file, click the 'more' button in the upper right of each tab and select the 'Export CSV' menu item.
697+
To save the current resource policy list as a CSV file, use the **Export CSV** action in the **bottom-right slot of the table**. This applies to the Keypair, User, and Project resource policy tabs alike — the CSV export control has been moved from the header area to the table's bottom-right toolbar for consistency with other admin lists.
698+
699+
![](../images/resource_policy_list_csv.png)
700+
<!-- TODO: Recapture screenshot of the resource policy list showing the CSV export control at the BAITable bottom-right -->
682701

683702
![](../images/keypair_export.png)
684703

@@ -973,6 +992,10 @@ button. The registry creation dialog contains the following fields:
973992
- **Registry Type**: Select the type of registry. Supported types include: `docker`, `harbor`, `harbor2`, `github`, `gitlab`, `ecr`, and `ecr-public`.
974993
- **Project Name**: The project or namespace in the registry (required). Use the full path including namespace and project name for GitLab registries.
975994
- **Extra Information**: A JSON string for additional configuration needed for each registry type. This field is available from version 24.09.3.
995+
- **SSL Verification**: Toggles whether Backend.AI verifies the registry's SSL certificate when connecting. **Enabled by default**, which is the recommended setting for any registry reachable over the public internet. Disable this only for a registry served with a self-signed certificate inside a trusted internal environment where you have already verified the network path; turning it off makes the connection vulnerable to man-in-the-middle attacks.
996+
997+
![](../images/container_registry_editor_modal.png)
998+
<!-- TODO: Recapture screenshot of the Container Registry Editor modal including the SSL Verification checkbox -->
976999

9771000
![](../images/add_registry_dialog.png)
9781001

packages/backend.ai-webui-docs/src/ja/admin_menu/admin_menu.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -226,6 +226,8 @@ Storageページに招待手続きなしで作成したばかりのプロジェ
226226

227227
<a id="manage-models-cards"></a>
228228

229+
<a id="manage-model-cards"></a>
230+
229231
## モデルカードの管理
230232

231233
モデルストアのモデルカードは、[管理者モデルストア管理](#admin-model-store-management) インターフェースを通じて作成・管理します。各モデルカードは、実際のモデルファイルが格納されたストレージフォルダー(vfolder)と紐づけられます。
@@ -384,6 +386,20 @@ models:
384386

385387
モデルカード名の横にある削除アイコンをクリックして個別のモデルカードを削除するか、行のチェックボックスで複数のモデルカードを選択したうえで、選択件数の横にある赤色のゴミ箱ボタンをクリックして一括削除を実行できます。
386388

389+
![](../images/model_card_delete_with_folder.png)
390+
<!-- TODO: Recapture screenshot of the model card delete dialog showing the "Also delete the associated model folder" option -->
391+
392+
削除確認ダイアログには **関連するモデルフォルダも削除する** オプションが含まれています:
393+
394+
- このオプションをチェックすると、モデルカードが削除されると同時に、そのモデルカードに紐づくストレージフォルダ(vfolder)がゴミ箱に移動されます。ゴミ箱通知が併せて表示されるため、スーパー管理者は紐づくフォルダがゴミ箱に送られたことを確認でき、必要に応じて **データ > ゴミ箱** からフォルダを復元できます。関連するフォルダを削除すると、そのフォルダを参照している他のすべてのモデルカードも一緒に削除される点にご注意ください。
395+
- このオプションのチェックを外した場合は、モデルカードのレコードのみが削除され、紐づくストレージフォルダはそのまま残るため、別のモデルカードに再利用できます。
396+
397+
**一括削除** でも同じ挙動になります(ラベルは **関連するモデルフォルダをすべて削除する** に変わります)。オプションをチェックすると、選択した各モデルカードに紐づくストレージフォルダがゴミ箱に移動され、移動されたフォルダごとにゴミ箱通知が表示されます。
398+
399+
:::note
400+
各管理者向けデプロイメントには `/admin-deployments/:id` 専用のルートが用意されました。管理者サービングページからデプロイメントを開くと URL がこのパスに切り替わるため、デプロイメント詳細ページを直接リンクしたりブックマークしたりできます。
401+
:::
402+
387403
<a id="prometheus-query-presets"></a>
388404

389405
## Prometheusプリセット
@@ -643,7 +659,10 @@ Backend.AIでは、管理者は各キーペア、ユーザー、プロジェク
643659

644660
テーブルの右下にある「設定」ボタンをクリックして、表示するカラムのみを選択できます。
645661

646-
現在のリソースポリシーをファイルとして保存するには、各タブ右上の「もっと見る」ボタンをクリックし、「CSVをエクスポート」メニューを選択します。
662+
現在のリソースポリシー一覧を CSV ファイルとして保存するには、**テーブル右下** の **CSVをエクスポート(Export CSV)** アクションを使用します。これは Keypair、User、Project のいずれのリソースポリシータブでも同様です。他の管理者向け一覧との一貫性を保つため、CSV エクスポートのコントロールはヘッダー領域からテーブル右下のツールバーに移動されました。
663+
664+
![](../images/resource_policy_list_csv.png)
665+
<!-- TODO: Recapture screenshot of the resource policy list showing the CSV export control at the BAITable bottom-right -->
647666

648667
![](../images/keypair_export.png)
649668

@@ -939,6 +958,10 @@ Harborが提供するレジストリです。
939958
- **レジストリタイプ**: レジストリの種類を選択します。サポートされる種類:`docker`、`harbor`、`harbor2`、`github`、`gitlab`、`ecr`、`ecr-public`。
940959
- **プロジェクト名**: レジストリのプロジェクトまたはネームスペースです(必須)。GitLabレジストリの場合、ネームスペースとプロジェクト名を含む完全なパスを使用します。
941960
- **追加情報**: 各レジストリタイプに必要な追加設定用のJSON文字列です。このフィールドはバージョン24.09.3から利用可能です。
961+
- **SSL検証(SSL Verification)**: Backend.AI がレジストリに接続する際に SSL 証明書を検証するかどうかを切り替えます。**デフォルトでは有効** で、公開インターネット経由でアクセス可能なレジストリでは有効のままにすることを推奨します。自己署名(self-signed)証明書で配信されるレジストリで、かつネットワーク経路を既に検証済みの信頼できる内部環境でのみ無効化してください。検証を無効にすると中間者(MITM)攻撃に対して脆弱になるため注意が必要です。
962+
963+
![](../images/container_registry_editor_modal.png)
964+
<!-- TODO: Recapture screenshot of the Container Registry Editor modal including the SSL Verification checkbox -->
942965

943966
![](../images/add_registry_dialog.png)
944967

packages/backend.ai-webui-docs/src/ko/admin_menu/admin_menu.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,8 @@ Backend.AI는 사용자 자신의 스토리지 폴더 외에도 프로젝트를
184184

185185
<a id="manage-models-cards"></a>
186186

187+
<a id="manage-model-cards"></a>
188+
187189
## 모델 카드 관리
188190

189191
모델 스토어의 모델 카드는 [관리자 모델 스토어 관리](#admin-model-store-management) 인터페이스를 통해 생성하고 관리합니다. 각 모델 카드는 실제 모델 파일이 저장된 스토리지 폴더(vfolder)와 연결됩니다.
@@ -342,6 +344,20 @@ models:
342344

343345
모델 카드 이름 옆의 삭제 아이콘을 클릭하여 개별 모델 카드를 삭제하거나, 행 체크박스로 여러 모델 카드를 선택한 후 선택 개수 옆의 빨간색 휴지통 버튼을 클릭하여 일괄 삭제를 수행할 수 있습니다.
344346

347+
![](../images/model_card_delete_with_folder.png)
348+
<!-- TODO: Recapture screenshot of the model card delete dialog showing the "Also delete the associated model folder" option -->
349+
350+
삭제 확인 대화 상자에는 **연결된 모델 폴더도 함께 삭제** 옵션이 포함되어 있습니다:
351+
352+
- 이 옵션을 체크하면, 모델 카드가 제거되는 동시에 해당 모델 카드와 연결된 스토리지 폴더(vfolder)가 휴지통으로 이동합니다. 휴지통 알림이 함께 표시되어 슈퍼관리자는 연결된 폴더가 휴지통으로 이동했음을 확인할 수 있으며, 필요한 경우 **데이터 > 휴지통**에서 폴더를 복원할 수 있습니다. 연결된 폴더를 삭제하면 같은 폴더를 참조하는 다른 모든 모델 카드도 함께 삭제된다는 점에 유의하세요.
353+
- 이 옵션을 체크하지 않으면, 모델 카드 레코드만 제거되며 연결된 스토리지 폴더는 그대로 유지되어 다른 모델 카드에 다시 사용할 수 있습니다.
354+
355+
**일괄 삭제** 시에도 동일하게 동작하며, 옵션을 체크하면 선택된 각 모델 카드와 연결된 스토리지 폴더가 휴지통으로 이동하고, 이동된 폴더마다 휴지통 알림이 표시됩니다.
356+
357+
:::note
358+
각 관리자용 디플로이먼트는 이제 `/admin-deployments/:id` 전용 경로를 갖습니다. 관리자 서빙 페이지에서 디플로이먼트를 열면 URL이 이 경로로 변경되어 디플로이먼트 상세 페이지를 직접 링크하거나 북마크할 수 있습니다.
359+
:::
360+
345361
<a id="prometheus-query-presets"></a>
346362

347363
## 프로메테우스 프리셋
@@ -542,7 +558,10 @@ keypair 자원 정책과 마찬가지로 테이블 오른쪽 하단의 '설정 (
542558

543559
테이블 오른쪽 하단의 '설정' 버튼을 클릭하여 원하는 열만 선택하고 표시할 수 있습니다.
544560

545-
현재 자원 정책을 파일로 저장하려면 각 탭 오른쪽 상단의 '더보기' 버튼을 클릭한 후 'CSV로 내보내기' 메뉴를 선택합니다.
561+
현재 자원 정책 목록을 CSV 파일로 저장하려면 **테이블 오른쪽 하단**의 **CSV로 내보내기(Export CSV)** 액션을 사용합니다. 이는 Keypair, User, Project 자원 정책 탭 모두에 동일하게 적용됩니다. 다른 관리자 목록과의 일관성을 위해 CSV 내보내기 컨트롤이 헤더 영역에서 테이블 하단 오른쪽 툴바로 이동되었습니다.
562+
563+
![](../images/resource_policy_list_csv.png)
564+
<!-- TODO: Recapture screenshot of the resource policy list showing the CSV export control at the BAITable bottom-right -->
546565

547566
![](../images/keypair_export.png)
548567

@@ -815,6 +834,10 @@ Controls의 새로고침 아이콘을 클릭하면 연결된 레지스트리에
815834
- **레지스트리 유형**: 레지스트리 유형을 선택합니다. 지원되는 유형: `docker`, `harbor`, `harbor2`, `github`, `gitlab`, `ecr`, `ecr-public`.
816835
- **프로젝트 이름**: 레지스트리의 프로젝트 또는 네임스페이스입니다 (필수). GitLab 레지스트리의 경우 네임스페이스와 프로젝트 이름을 포함한 전체 경로를 사용합니다.
817836
- **추가 정보**: 각 레지스트리 유형에 필요한 추가 설정을 위한 JSON 문자열입니다. 이 필드는 버전 24.09.3부터 사용 가능합니다.
837+
- **SSL 검증(SSL Verification)**: Backend.AI가 레지스트리에 연결할 때 SSL 인증서를 검증할지 여부를 설정합니다. **기본값은 활성화**이며, 공용 인터넷을 통해 접근 가능한 모든 레지스트리에는 활성화 상태를 유지하는 것을 권장합니다. 자체 서명(self-signed) 인증서를 사용하는 신뢰할 수 있는 내부 환경에서 네트워크 경로를 이미 검증한 경우에만 비활성화합니다. 검증을 비활성화하면 중간자(MITM) 공격에 취약해질 수 있으니 주의하세요.
838+
839+
![](../images/container_registry_editor_modal.png)
840+
<!-- TODO: Recapture screenshot of the Container Registry Editor modal including the SSL Verification checkbox -->
818841

819842
![](../images/add_registry_dialog.png)
820843

0 commit comments

Comments
 (0)