Cluster Management

docs/platform/guides/cluster-management/add-cluster/import-vendor-managed.md

@@ -21,7 +21,7 @@ section_menu_id: guides
 
 ### Select Credential
 
-3. Choose a credential with permission to access and import the cluster, then click `Next`. To create one, use the `+Create Credential` button (see [Credentials](../../account-management/kubernetes/credentials.html)).
+3. Choose a credential with permission to access and import the cluster, then click `Next`. To create one, use the `+Create Credential` button (see [Credentials](../../account-management/kubernetes/credentials.md)).
 
 ### Select Cluster
 

docs/platform/guides/cluster-management/cluster-helm-charts.md

@@ -10,27 +10,60 @@ menu_name: docsplatform_{{.version}}
 section_menu_id: guides
 ---
 
+# Helm Chart Management
 
-# Manage Helm Charts in Platform Console
+The **Helm** group in the Cluster UI sidebar gives you full visibility into your cluster's Helm ecosystem. It has three pages — Releases, HelmRelease, and HelmChart — covering deployed releases, FluxCD-managed releases, and chart sources respectively.
 
-Platform Console's Helm Chart Management lets you manage Helm releases within your Kubernetes clusters — installing new charts, modifying existing releases, and rolling back versions from the UI.
+## Open the Helm Section
 
-## Accessing Helm Chart Management
+1. Navigate to the [Platform Console](https://console.appscode.com).
+2. Click on your imported cluster to open its Cluster Overview page.
+3. In the left sidebar, click **Helm** to expand it.
 
-To navigate to the Helm Chart Management page:
+---
+
+## Releases
+
+The Releases page lists all Helm v3 releases currently deployed in your cluster — everything installed via `helm install`, regardless of how it got there. This is the primary page to check what is running, what version is deployed, and whether the release is in a healthy state.
+
+Use this page to get a quick overview of all deployed charts, check release status, or install a new chart using the **+ Install Chart** button.
+
+Lists every release with its **Name**, **Namespace**, **Status** (e.g. deployed, failed), **Version**, and **Age**. Use the **Select All** and **All Namespaces** dropdowns to filter the list.
+
+![Helm Releases page showing all deployed Helm releases with name, namespace, status, version, and age columns](images/cluster-helm-charts/helm-releases-deployed.png)
+
+---
+
+## HelmRelease
 
-1. From the [Platform Console](https://console.appscode.com), click on your imported cluster to go to the Cluster Overview page.
-2. In the left sidebar, under **Helm**, select **Releases** to access the Helm Chart Management page.
+A HelmRelease is a FluxCD resource that declaratively manages a Helm chart installation. The Platform Console tracks every HelmRelease and shows its reconciliation state, so you can see whether a GitOps-driven installation or upgrade succeeded or is still in progress.
 
-## Helm Chart Management Features
+Use this page to check FluxCD-managed release health, spot failed reconciliations, or create a new HelmRelease from the UI.
 
-### Install New Charts
+Lists every HelmRelease with its **Namespace**, **Age**, **Ready** status, and a **Status** message showing the last Helm operation result. Click **+ Create HelmRelease** to define a new one.
 
-1. **Choose Chart Source:** Select a chart source from publicly available URLs or provide a custom URL.
-2. **Select Chart and Version:** Browse and choose the desired chart and version.
-3. **Customize Installation:** Provide a custom release name, namespace, and specify a custom values file during installation.
+![HelmRelease list page showing FluxCD-managed releases with namespace, age, ready, and status columns](images/cluster-helm-charts/helm-releases-list.png)
+
+---
+
+## HelmChart
+
+A HelmChart is a FluxCD resource that sources a specific chart and version from a HelmRepository. Each HelmRelease references a HelmChart behind the scenes. This page tells you which charts are being pulled, from where, and whether the source is reachable and up to date.
+
+Use this page to verify chart versions in use, check that chart sources are resolving correctly, or create a new HelmChart resource.
+
+Lists every HelmChart with its **Namespace**, **Annotations**, **Age**, **Chart** name, **Version**, **Source Kind**, **Source Name**, **Ready** state, and **Status**. Click **+ Create HelmChart** to add a new chart source.
+
+![HelmChart list page showing chart name, version, source kind, source name, ready, and status columns](images/cluster-helm-charts/helm-charts-list.png)
+
+---
 
-### Interact with Existing Releases
+## Quick Reference
 
-- **Modify Releases:** Adjust existing Helm releases based on evolving requirements.
-- **Rollback to Previous Versions:** Revert to previous versions of Helm releases if needed.
+| Task | How to do it |
+|---|---|
+| View all deployed releases | Click **Releases** under the Helm group |
+| Install a new chart | Click **+ Install Chart** on the Releases page |
+| Check FluxCD-managed release health | Click **HelmRelease** under the Helm group |
+| View chart sources | Click **HelmChart** under the Helm group |
+| Create a new FluxCD release | Click **+ Create HelmRelease** on the HelmRelease page |

docs/platform/guides/cluster-management/cluster-workload.md

@@ -10,90 +10,105 @@ menu_name: docsplatform_{{.version}}
 section_menu_id: guides
 ---
 
-
 # Kubernetes Workload Management
 
-The Kubernetes Workload Management section in the Platform Console manages Kubernetes resources.
+The **Workloads** group in the Cluster UI sidebar is where you browse and manage everything that runs application containers — Deployments, Pods, Jobs, and the other standard Kubernetes workload types.
+
+## Open the Workloads Section
 
 1. Navigate to the [Platform Console](https://console.appscode.com).
-2. Click on your imported cluster to access the Cluster Overview page.
+2. Click on your imported cluster to open its Cluster Overview page.
+3. In the left sidebar, click **Workloads** to expand it.
+
+Every list page in this group follows the same layout: a 🔍 search box, an **All Namespaces** filter dropdown, and a green **+ Create** button top-right.
+
+---
+
+## Deployments
+
+A Deployment keeps a set number of identical app copies running and handles rolling updates — it's the standard way to run and update a stateless app. Use this page when you need to check rollout status, scale an app up/down, or push a new image version.
+
+Lists every Deployment with its Namespace, Pods (ready count), Images, and Age. Click a row to view or edit it; use **+ Create** to deploy a new one.
+
+![Deployments list page showing the table of deployments with namespace filter and Create button](images/cluster-workload/deployments-list.png)
 
-## Cluster Overview Page
+---
 
-The Cluster Overview page provides essential information about your cluster, including a node list, available FeatureSets, and their respective statuses (enabled or disabled).
+## Replica Sets
 
-## Left Sidebar Navigation
+A Replica Set's only job is to keep a fixed number of Pod copies alive. You rarely create these by hand — a Deployment creates and manages one for you behind the scenes. Check this page when troubleshooting why a Deployment isn't scaling the way you expect.
 
-The left sidebar presents a variety of options for managing Kubernetes workloads:
+Lists every Replica Set with its Namespace, Pods, Images, and Age.
 
-- **Kubernetes:**
-  - Overview
-  - Nodes
+![Replica Sets list page showing namespace, pods, images, and age columns](images/cluster-workload/replica-sets-list.png)
 
-- **Workloads:**
-  - Deployments
-  - Replica Sets
-  - Replication Sets
-  - Stateful Sets
-  - Daemon Sets
-  - Jobs
-  - Cron Jobs
-  - Pods
+---
 
-- **Helm:**
-  - Releases
+## Replication Controllers
 
-- **Datastore:**
-  - Postgres
-  - Elasticsearch
-  - MongoDB (and others managed by KubeDB)
+The older, legacy way to keep a fixed number of Pod copies running — same idea as a Replica Set, kept for backward compatibility. New workloads should use Deployments instead; you'd only see entries here on older setups.
 
-- **Service & Discovery:**
-  - Services
-  - Ingresses
-  - Network Policies
+Lists every Replication Controller with its Namespace, Pods, Images, and Age. Click **+ Create ReplicationController** to add one.
 
-- **Config:**
-  - Config Maps
-  - Secrets
+![Replication Controllers list page with no data available and a Create ReplicationController button](images/cluster-workload/replication-controllers-list.png)
 
-- **Storage:**
-  - Persistent Volume Claims
-  - Persistent Volumes
-  - Storage Classes
+---
 
-- **Monitoring:**
-  - Alertmanager
-  - PodMonitor
-  - Prometheus
-  - ServiceMonitor
-  - PrometheusRule
+## Stateful Sets
 
-- **Security:**
-  - Service Accounts
-  - Policy
-  - Gatekeeper Report
+For apps where each Pod needs a stable identity and its own storage — databases, queues, anything that can't just be swapped for an identical copy. Use this when running stateful services that care about pod order or persistent data.
 
-- **Admin:**
-  - Namespaces
-  - Resource Quotas
-  - Cluster Roles
-  - Roles
-  - CSI Drivers
+Lists every Stateful Set with its Namespace, Pods, Images, and Age.
 
-You can customize the left sidebar by clicking the ⚙️ icon on the navbar, navigating to the Cluster Settings page, and selecting the `Sidebar` tab. Refer to the [Sidebar Management Documentation](cluster-sidebar.md) for more details.
+![Stateful Sets list page showing namespace, pods, images, and age columns](images/cluster-workload/stateful-sets-list.png)
+
+---
 
-## Resource Management
+## Daemon Sets
 
-Select any resource from the left sidebar to list the resources. From there, you can go to the resource details page. The available options for each resource include:
+Runs one copy of a Pod on every node automatically — typically used for cluster-wide infrastructure like log collectors or monitoring agents that need to run everywhere. Check this page to confirm a node-wide agent has rolled out to all nodes.
+
+Lists every Daemon Set with its Namespace, Pods, Dsired, Current-Scheduled, Up-to-date, Node Selector, Images, and Age — the Desired/Current/Up-to-date columns show rollout progress at a glance.
+
+![Daemon Sets list page showing desired, current-scheduled, and up-to-date columns](images/cluster-workload/daemon-sets-list.png)
+
+---
 
-- Basic Overview
-- Resource Components
-- Related Resources
-- Events
-- Graph of Connected Resources
-- Resource Manifest
+## Jobs
+
+A Job runs a task once until it completes — a backup, a migration script, a one-off batch process — then stops, unlike a Deployment which runs forever. Use this page to check whether a one-off task finished and how long it took.
+
+Lists every Job with its Namespace, Annotations, Completions, Duration, Images, and Age.
+
+![Jobs list page showing completions, duration, images, and age columns](images/cluster-workload/jobs-list.png)
+
+---
+
+## Cron Jobs
+
+A Cron Job runs a Job on a repeating schedule — like a nightly backup or a recurring cleanup task — so you don't have to trigger it manually each time. Use the **Suspend** state here to pause a recurring task without deleting it.
+
+Lists every Cron Job with its Namespace, Annotations, Schedule, Suspend, Active, Last Schedule, Images, and Age — the Schedule column shows the cron expression.
+
+![Cron Jobs list page showing schedule, suspend, active, and last schedule columns](images/cluster-workload/cron-jobs-list.png)
+
+---
+
+## Pods
+
+A Pod is the actual running container(s) — the smallest unit in Kubernetes. Every Deployment, StatefulSet, Job, etc. above ultimately creates Pods to do the real work. This is the page to check when you need to see real-time container health or debug a crash.
+
+Lists every Pod with its Namespace, Ready, Status, Restarts, IP, Images, and Age — the only Workloads item with these extra live-state columns, useful for spotting crashing or restarting containers.
+
+![Pods list page showing Ready, Status, Restarts, and IP columns](images/cluster-workload/pods-list.png)
+
+---
 
-The `Datastore` section is dedicated to KubeDB, an AppsCode product, for managing various types of databases. You can create new databases, explore overviews, components, connected resources, and manifests for each database.
+## Quick Reference
 
-You can also create new resources directly from any resource list page by clicking the `➕ Create` button, filling out the form, and submitting to create the resource.
+| Task | How to do it |
+|---|---|
+| Open the Workloads view | Click your cluster on the Platform Console → click **Workloads** in the left sidebar |
+| List a workload type | Click its name under the Workloads group (e.g. Deployments, Pods) |
+| Filter by namespace | Use the **All Namespaces** dropdown on any list page |
+| Create a new workload | Click **+ Create** on the resource's list page |