From 0531d3d91d989d9cabe354bbfea657329a2246bc Mon Sep 17 00:00:00 2001 From: gulshank0 Date: Tue, 3 Feb 2026 18:17:26 +0530 Subject: [PATCH 1/6] [Docs update](console): Document namespace manager caching and UI improvements Signed-off-by: gulshank0 --- docs/content/console/console-features.md | 32 +++++++++++++++++++++- docs/content/console/dashboards.md | 35 +++++++++++++++++++++++- 2 files changed, 65 insertions(+), 2 deletions(-) diff --git a/docs/content/console/console-features.md b/docs/content/console/console-features.md index 33138c93..4cff0317 100644 --- a/docs/content/console/console-features.md +++ b/docs/content/console/console-features.md @@ -107,7 +107,7 @@ The sidebar provides access to all major sections: ### Secondary Navigation - **Card History**: Previously viewed cards -- **Namespaces**: Namespace-specific views +- **Namespaces**: Namespace management across clusters - create, view, and manage namespaces with intelligent error handling and offline cluster detection - **User Management**: RBAC and access control - **Settings**: Console configuration @@ -125,6 +125,36 @@ The global search bar (`Cmd/Ctrl + K`) enables quick navigation: - Navigate to specific namespaces - Filter by resource type +## Namespace Management + +The Namespace Management page (`/namespaces`) provides a centralized interface for managing namespaces across all your clusters. + +### Key Features + +- **Direct Agent Access**: Namespace data is fetched directly from the local agent, providing faster response times and bypassing potential backend authentication issues +- **Smart Caching**: Intelligently caches namespace data while preventing empty states from being persisted on temporary failures +- **Offline Cluster Handling**: Clearly identifies offline clusters in the header without redundant error messages +- **Filtered Creation**: The Create Namespace dialog automatically filters out offline clusters, ensuring namespace creation only targets available clusters +- **Intelligent Error Display**: Error banners only appear when ALL clusters fail to respond, not on partial failures + +### Creating Namespaces + +To create a new namespace: + +1. Navigate to `/namespaces` +2. Click the "Create" button (sized appropriately for UI consistency) +3. Select one or more online clusters from the dialog +4. Enter the namespace name +5. Confirm to create the namespace across selected clusters + +Note: The create dialog only displays clusters that are currently online and responsive, preventing failed creation attempts. + +### Cluster Status Indicators + +- **Online clusters**: Show namespace lists and are available for namespace creation +- **Offline clusters**: Marked clearly in the header with offline status indicators +- **Partial failures**: Do not trigger error banners; only complete failures across all clusters show errors + ## Alerts The alert system keeps you informed: diff --git a/docs/content/console/dashboards.md b/docs/content/console/dashboards.md index 8e4bc2e3..d3633715 100644 --- a/docs/content/console/dashboards.md +++ b/docs/content/console/dashboards.md @@ -301,6 +301,40 @@ Focus on pods: --- +### Namespaces Dashboard + +**Route:** `/namespaces` + +Manage namespaces across all your clusters: +- View all namespaces from online clusters +- Create new namespaces on one or more clusters +- See which clusters are online or offline +- Real-time namespace discovery using local agent + +**Best for:** Managing namespace access and organization + +#### Key Features + +- **Smart Error Handling**: Error banners only appear when ALL clusters fail to respond, not on partial failures +- **Offline Cluster Detection**: Offline clusters are clearly marked in the header with status indicators +- **Filtered Creation**: The Create Namespace dialog only shows online clusters, preventing failed creation attempts +- **Improved Caching**: Namespace data is cached intelligently and won't persist empty states on temporary failures +- **Direct Agent Access**: Fetches namespaces directly from the local agent, bypassing backend authentication issues + +#### How to Use + +1. **View Namespaces**: The page automatically loads namespaces from all connected online clusters +2. **Create a Namespace**: + - Click the "Create" button (only appears if at least one cluster is online) + - Select one or more online clusters from the dialog + - Enter the namespace name + - Confirm to create across selected clusters +3. **Monitor Status**: + - Check cluster headers for online/offline status + - Watch for error banners if all clusters become unavailable + +--- + ## Utility Pages These aren't counted as dashboards but are useful: @@ -310,7 +344,6 @@ These aren't counted as dashboards but are useful: | Card History | `/history` | See cards you've removed | | Settings | `/settings` | Configure your preferences | | User Management | `/users` | Manage users (admin only) | -| Namespaces | `/namespaces` | Manage namespace access | --- From 70d369fd459bb04dffff16375f7d9057eda04ae8 Mon Sep 17 00:00:00 2001 From: gulshank0 Date: Tue, 3 Feb 2026 18:25:30 +0530 Subject: [PATCH 2/6] recoverd Signed-off-by: gulshank0 --- docs/content/console/dashboards.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/content/console/dashboards.md b/docs/content/console/dashboards.md index d3633715..e172ef10 100644 --- a/docs/content/console/dashboards.md +++ b/docs/content/console/dashboards.md @@ -344,6 +344,7 @@ These aren't counted as dashboards but are useful: | Card History | `/history` | See cards you've removed | | Settings | `/settings` | Configure your preferences | | User Management | `/users` | Manage users (admin only) | +| Namespaces | `/namespaces` | Manage namespace access | --- From 7b5cba241657aaa306e35cb3424a2193ad21b926 Mon Sep 17 00:00:00 2001 From: Gulshan Date: Tue, 3 Feb 2026 18:47:44 +0530 Subject: [PATCH 3/6] Update docs/content/console/console-features.md KSC Agent added Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: gulshank0 --- docs/content/console/console-features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/console/console-features.md b/docs/content/console/console-features.md index 4cff0317..eb888181 100644 --- a/docs/content/console/console-features.md +++ b/docs/content/console/console-features.md @@ -131,7 +131,7 @@ The Namespace Management page (`/namespaces`) provides a centralized interface f ### Key Features -- **Direct Agent Access**: Namespace data is fetched directly from the local agent, providing faster response times and bypassing potential backend authentication issues +- **Direct Agent Access**: Namespace data is fetched directly from the KSC Agent, providing faster response times and bypassing potential backend authentication issues - **Smart Caching**: Intelligently caches namespace data while preventing empty states from being persisted on temporary failures - **Offline Cluster Handling**: Clearly identifies offline clusters in the header without redundant error messages - **Filtered Creation**: The Create Namespace dialog automatically filters out offline clusters, ensuring namespace creation only targets available clusters From fa6d55db944f0c0cb202b5185de6e85fa80a58a8 Mon Sep 17 00:00:00 2001 From: Gulshan Date: Tue, 3 Feb 2026 18:48:43 +0530 Subject: [PATCH 4/6] Update docs/content/console/dashboards.md format updating Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: gulshank0 --- docs/content/console/dashboards.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/content/console/dashboards.md b/docs/content/console/dashboards.md index e172ef10..5279ced5 100644 --- a/docs/content/console/dashboards.md +++ b/docs/content/console/dashboards.md @@ -324,12 +324,12 @@ Manage namespaces across all your clusters: #### How to Use 1. **View Namespaces**: The page automatically loads namespaces from all connected online clusters -2. **Create a Namespace**: +2. **Create a Namespace**: - Click the "Create" button (only appears if at least one cluster is online) - Select one or more online clusters from the dialog - Enter the namespace name - Confirm to create across selected clusters -3. **Monitor Status**: +3. **Monitor Status**: - Check cluster headers for online/offline status - Watch for error banners if all clusters become unavailable From d5406efc878402951b0328c59cd3c70fb1ed12d1 Mon Sep 17 00:00:00 2001 From: gulshank0 Date: Tue, 3 Feb 2026 18:53:04 +0530 Subject: [PATCH 5/6] improved docs Signed-off-by: gulshank0 --- docs/content/console/dashboards.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/content/console/dashboards.md b/docs/content/console/dashboards.md index 5279ced5..f14ca8a0 100644 --- a/docs/content/console/dashboards.md +++ b/docs/content/console/dashboards.md @@ -309,7 +309,7 @@ Manage namespaces across all your clusters: - View all namespaces from online clusters - Create new namespaces on one or more clusters - See which clusters are online or offline -- Real-time namespace discovery using local agent +- Real-time namespace discovery using the KSC Agent (local agent) **Best for:** Managing namespace access and organization @@ -319,7 +319,7 @@ Manage namespaces across all your clusters: - **Offline Cluster Detection**: Offline clusters are clearly marked in the header with status indicators - **Filtered Creation**: The Create Namespace dialog only shows online clusters, preventing failed creation attempts - **Improved Caching**: Namespace data is cached intelligently and won't persist empty states on temporary failures -- **Direct Agent Access**: Fetches namespaces directly from the local agent, bypassing backend authentication issues +- **Direct Agent Access**: Fetches namespaces directly from the KSC Agent, bypassing backend authentication issues #### How to Use @@ -344,7 +344,7 @@ These aren't counted as dashboards but are useful: | Card History | `/history` | See cards you've removed | | Settings | `/settings` | Configure your preferences | | User Management | `/users` | Manage users (admin only) | -| Namespaces | `/namespaces` | Manage namespace access | + --- From a54b8d0c7327ca3500728167599c55f6a5a2971d Mon Sep 17 00:00:00 2001 From: gulshank0 Date: Tue, 3 Feb 2026 18:59:12 +0530 Subject: [PATCH 6/6] improved docs Signed-off-by: gulshank0 --- docs/content/console/dashboards.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/content/console/dashboards.md b/docs/content/console/dashboards.md index f14ca8a0..50e72cf9 100644 --- a/docs/content/console/dashboards.md +++ b/docs/content/console/dashboards.md @@ -344,6 +344,7 @@ These aren't counted as dashboards but are useful: | Card History | `/history` | See cards you've removed | | Settings | `/settings` | Configure your preferences | | User Management | `/users` | Manage users (admin only) | +| Namespaces | `/namespaces` | Manage namespace access | ---