Day 6：Dashboard 導覽——每個分頁在做什麼

這是《OpenShift AI 入門 30 天》系列的第 6 篇。

這是什麼、解決什麼問題

前幾天都在給 YAML 和 oc 指令。但實際情況是：
用這個平台的人多半不會用 oc。

Dashboard 是他們唯一的入口。而它顯示的東西跟 oc 看到的是同一批物件——
只是換了個呈現方式，並且藏起了一部分。

知道哪些被藏起來，是你能幫上忙的地方。

什麼時候你會用到

• 要教別人用這個平台
• 有人說「我在畫面上找不到」，你要知道去哪裡查
• 要示範給主管看（oc 的輸出沒有說服力）

什麼時候不要用：批次操作、要留下可重跑的紀錄、GitOps。
那些走 YAML。

前置條件

• DSC 裡 dashboard 是 Managed
• 你的使用者在對應 namespace 上有權限

步驟一：找到入口

⚠️ 3.x 的 route 名稱換過。 2.x 是 odh-dashboard / rhods-dashboard，
3.x 走一個叫 data-science-gateway 的東西。

不要記名字，直接列出來：

oc get route -A | grep -iE 'dashboard|data-science-gateway'

我的 lab 上有三筆，真正的入口是最後那個：

opendatahub       odh-dashboard          odh-dashboard-opendatahub.apps-crc.testing
opendatahub       data-science-gateway   data-science-gateway.apps-crc.testing
openshift-ingress data-science-gateway   rh-ai.apps-crc.testing          ← 這個

前兩個是 redirect，第三個才是 gateway 本體。
照舊文件找 odh-dashboard 會連到，但那是轉址。

左邊那排就是全部功能。

步驟二：Projects——一切的起點

「Project」就是一個 OpenShift namespace。

oc get project llm-serve-demo     # 同一個東西

⚠️ 你用 oc new-project 建的 namespace，dashboard 看不到。

要它出現，namespace 上要有這個 label：

oc label namespace <你的 ns> opendatahub.io/dashboard=true

這是新手最常卡的第一關，而畫面上不會告訴你原因——
它只是不顯示。

點進一個 project，裡面有五個分頁：
Workbenches／Connections／Cluster storage／Models／Pipelines。
接下來幾天講的東西都在這裡。

步驟三：Connections

這頁列的是貼了 dashboard label 的 Secret（Day 7 會細講）。

真正要看的是 Connected resources 那一欄。

它告訴你有誰在用這份憑證。如果是 --，代表沒有東西在用——
而如果你的 pipeline 同時在正常跑，那就表示
它用的是另一份你在這頁看不到的憑證。

盤點憑證的時候，這頁不能當唯一來源：

# 實際掛進 pod 的 secret
oc get pods -n <ns> -o json | jq -r '
  .items[].spec.containers[].envFrom[]?.secretRef.name,
  .items[].spec.volumes[]?.secret.secretName
  | select(. != null)' | sort -u

（select(. != null) 別省，不然沒掛 secret 的 volume 會印出一堆 null。）

步驟四：Workbenches

開／停 JupyterLab 的地方。要看的欄位是 Status 和 Size。

⚠️ Status 顯示 Starting 卡很久，多半是資源不夠而不是還在下載。
畫面不會說，去看 pod：

oc describe pod <workbench-pod> -n <ns> | tail -5
# Warning  FailedScheduling  ... Insufficient cpu

按 Open 進去就是標準的 JupyterLab：

步驟五：Pipelines——三個分頁要分清楚

這一區最容易搞混，因為有三層東西：

⚠️ Runs 頁的綠勾只代表容器 exit code 是 0。

一個什麼都沒做就結束的 step 也是綠的。
要確認事情真的發生了，去 Artifacts 頁看產物：

這頁列出每個 run 產出的檔案、大小、位置。
檔案在、大小合理、時間戳對，才算做完。

這是整個 dashboard 上我認為最值得教的一件事：
綠燈在 Runs 頁，證據在 Artifacts 頁。

步驟六：Models

列出這個 project 裡的 InferenceService。要看的是：

• Status——綠色代表 pod 起來了
• Inference endpoint——⚠️ 這是叢集內部的位址

第二點常被誤會。那個 *.svc.cluster.local 從你筆電 curl 不會通，
而這常被當成「服務壞了」。要從外面打，得自己建 Route（Day 10 會講）。

⚠️ 這頁整排變紅，第一個要懷疑的是模型放的那個 S3 還在不在。
InferenceService 是靠 init container（storage-initializer）
去 S3 把模型拉下來的，S3 連不到，pod 連跑都跑不到：

oc get pods -n <ns> | grep predictor
# llm-scratch-predictor-xxx   0/2   Init:CrashLoopBackOff
oc logs <pod> -c storage-initializer --tail=5
# ERROR ... Could not connect to the endpoint URL: "http://10.x.x.x:9000/models"

我這台 lab 的 MinIO 跑在宿主上，重開機沒跟著起來，
三個 InferenceService 就全部 READY=False。
dashboard 上只會顯示紅色，不會告訴你是 S3 掛了。

怎麼確認做對了

第 4 項一定要做。用管理員帳號測，你永遠不會發現權限問題。
真正的使用者是誰、他看得到什麼，Day 21 會專門講。

常見問題

Q：我的 namespace 不出現在 Projects。
A：補 label：oc label namespace <ns> opendatahub.io/dashboard=true。

Q：畫面上做的事，oc 看得到嗎？
A：看得到，dashboard 只是幫你產 CR。
建一個 workbench 就是建一個 Notebook，建 connection 就是建 Secret。
想學這個平台，最快的方法是在畫面上做一次，然後用 oc get -o yaml 看它產了什麼。

Q：dashboard 上刪掉東西，底層真的刪了嗎？
A：是。沒有回收桶。 刪 project 就是刪 namespace，
裡面的 PVC 和資料一起走。

Q：畫面卡住、載不出來。
A：先看 pod：oc get pods -n opendatahub | grep dashboard。
另外 3.x 走 gateway，gateway 那層也可能是問題，
兩邊的 log 都要看。

你們的人比較常用 dashboard 還是 oc？卡在哪一頁最多？

• 叢集：CRC 2.63.0 · OpenShift 4.22.7 · Kubernetes v1.35.6
  單節點 13 vCPU / 40 GiB / 120 GB，叢集內沒有 GPU
• Operator：opendatahub-operator.v3.5.0（即 RHOAI 3.x 的上游開源版）、
  cert-manager-operator.v1.20.0（3.x 的必要相依，2.x 不需要）
  ⚠️ 本文截圖與畫面結構是在 3.5.0 上拍的；這台叢集後來被自動升到 3.6.0-ea.1，
  升版怎麼發生的、我怎麼處理，寫在 Day 5 的補記。
• 開啟的元件：kserve、aipipelines、dashboard、workbenches、modelregistry
• 叢集外：Harbor v2.15.2（私有 registry）、MinIO（S3），跑在宿主的 podman 上
• 宿主：Framework Laptop 16（Ryzen AI 7 350 · 8C/16T · 64 GB · 1 TB NVMe）

⚠️ ODH ≠ RHOAI：元件同源，但 namespace 與部分名稱不同
（這裡是 opendatahub，商用版是 redhat-ods-*）。指令邏輯可照用，字串要自己對一次。

補充資料

• 🧪 這篇用到的 YAML／腳本：https://github.com/ryanGTR/openshift-ai-30days
• 🤖 lab 服務的那個模型（從零手刻的小 GPT）：https://github.com/ryanGTR/llm-from-scratch

你們的人比較常用 dashboard 還是 oc？卡在哪一頁最多？　留言或到原文留言都可以，我會回。