Skip to content

Resource List Pages ​

Every Kubernetes resource list page in Kuboard — Deployments, Pods, ConfigMaps, CRDs and so on — follows the same page structure, so the interactions and operations are identical everywhere. This page summarizes those commonalities; resource-specific fields and actions are covered in the relevant sections of this guide (e.g. Deployments).

How to Open ​

Open the list page of any resource from the left menu (for example Workloads → Deployment). The page is laid out as follows, from top to bottom:

AreaContents
Title barResource name + links to the Kubernetes official documentation (concepts + API reference)
ToolbarList-mode switch, cache status, auto-refresh, create and batch-action buttons
Data areaCluster / namespace selectors (search mode) or the resource tree on the left (tree mode) + the resource table

Two List Modes ​

A switch at the top right toggles between search mode and tree mode (your choice is remembered for next time):

  • Search mode: two selectors, Cluster and Namespace, appear at the top. After picking a cluster, the namespace can be a specific one or all, and the table below shows paginated results;
  • Tree mode: the left side shows a cluster → namespace tree (for namespaced resources) or a cluster tree (for cluster-scoped resources). Clicking a node filters the list.

Resource availability

In tree mode, if the current resource is not installed on a cluster (e.g. the cluster has no Gateway API), the corresponding node shows a ⚠ icon; hovering it reveals an installation guide.

Cached vs Direct Data ​

List data comes from one of two channels, shown by a "use cache / no cache" label at the top of the page:

ChannelDescriptionPagination
Cached listResources configured for automatic sync (e.g. Pods, Deployments, Namespaces); the list is read from the Kuboard cache for fast accessFull-cluster search and pagination supported
Direct listResources without caching (mostly low-frequency and custom resources) are read directly from the cluster API; data is real-timeNo pagination (the list footer shows "items that are not in the cache cannot be paginated")

Common Columns ​

Every list page has the following common columns:

ColumnDescription
NameClick to open the detail page (when you have get permission); resources being deleted are shown with a strikethrough
NamespaceThe namespace the resource belongs to (namespaced resources)
Creation timeDisplayed in the selected cluster's time zone
Alive statusAlive / dead marker (some resources)
OperationsEdit (when the resource has an edit page), View YAML, Delete; resource-specific actions (e.g. restart, scale) appear as extra buttons next to them

Common Operations ​

  • Create: the Add button in the toolbar, via a form or a YAML wizard depending on the resource type;
  • Edit / View YAML / Delete: in the row's operations column;
  • Batch operations: select rows and act on all of them, e.g. batch delete — the confirmation dialog distinguishes "items in the cluster" from "items in the cache" and handles them separately; workloads also support batch restart, etc.;
  • Auto refresh: the auto-refresh button in the toolbar; append ?autoRefresh=true to the URL to enable it as soon as the page opens.

Filters Are Synced to the Address Bar ​

The filter conditions of a list page (search keyword, cluster and namespace selection, page size) are synced to the browser address bar:

  • Changing a filter updates the address bar; a cleared condition is removed from it;
  • Copy the address-bar link and send it to a colleague — they open the same set of data;
  • Returning from a detail page to the list keeps your filters, so you do not have to pick them again.

A list filtered by a name keyword, with the share button next to the title (the address bar carries the same conditions)

The parameters that appear in the address bar:

ParameterMeaning
modeList mode: search (search mode) or tree (tree mode)
clusterId / namespaceThe cluster and namespace selected in search mode
scopesThe cluster / namespace nodes selected in tree mode
pageSizeNumber of rows per page
Filter conditionsOne parameter per filter (e.g. name keyword, creation time range), named after the corresponding field in the table's filter boxes

Share button

Both the list page and the resource detail page have a Share button next to the title — clicking it copies the current address-bar link (dropping parameters that only affect you, such as auto-refresh), with a confirmation toast. Use it instead of assembling a link by hand.

Permissions ​

  • Every button on the list page is shown / hidden automatically according to the current user's RBAC permissions; unauthorized actions simply do not appear;
  • If the current user has no list permission on the whole cluster, the page shows "Limited authorities" at the top — pick a namespace you have access to in the namespace selector.