diff --git a/docs/platform/guides/cluster-management/add-cluster/import-vendor-managed.md b/docs/platform/guides/cluster-management/add-cluster/import-vendor-managed.md index 4b7d568..b2182f0 100644 --- a/docs/platform/guides/cluster-management/add-cluster/import-vendor-managed.md +++ b/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 diff --git a/docs/platform/guides/cluster-management/cluster-helm-charts.md b/docs/platform/guides/cluster-management/cluster-helm-charts.md index d0c3747..3544c30 100644 --- a/docs/platform/guides/cluster-management/cluster-helm-charts.md +++ b/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 | diff --git a/docs/platform/guides/cluster-management/cluster-workload.md b/docs/platform/guides/cluster-management/cluster-workload.md index 62e4f2c..789ad88 100644 --- a/docs/platform/guides/cluster-management/cluster-workload.md +++ b/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 | diff --git a/docs/platform/guides/cluster-management/feature-reference.md b/docs/platform/guides/cluster-management/feature-reference.md index a298e73..4828e46 100644 --- a/docs/platform/guides/cluster-management/feature-reference.md +++ b/docs/platform/guides/cluster-management/feature-reference.md @@ -32,6 +32,8 @@ Core platform capabilities. Must be installed before any other Feature Set. Note: If you are an ArgoCD user, AppsCode provides a way to convert the flux HelmRelease to an Argo Application via a custom operator called FargoCD. This is configurable in the [selfhost](../../selfhost-setup/install/_index.md) page. +![Configure Opscenter Core feature set showing Opscenter Features, Kube UI Server, License Proxyserver, FluxCD, and OpenShift Adapter](images/feature-reference-images/featureset-opscenter-core.png) + --- ## Backup & Recovery @@ -45,6 +47,8 @@ Scheduled backup and recovery for Kubernetes applications and databases. | **Stash** | Legacy backup operator (Stash 1.0). Enable only to keep existing Stash 1.0 setups working. | License Proxyserver | | **Stash Opscenter** | UI and Grafana monitoring for Stash. | Stash, Panopticon, Grafana Operator | +![Configure Backup & Recovery feature set showing Stash Opscenter, Stash 2.0, Stash, and Stash Presets](images/feature-reference-images/featureset-backup-recovery.png) + --- ## Databases @@ -58,6 +62,8 @@ Production-grade database management powered by KubeDB. | **KubeDB UI Presets** *(Recommended)* | Default presets for the database creation forms. | — | | **Prepare Cluster** | Pre-pulls images and prepares nodes for KubeDB. | — | +![Configure Databases feature set showing KubeDB Opscenter, Prepare Cluster, KubeDB UI Presets, and KubeDB with supported database types](images/feature-reference-images/featureset-databases.png) + --- ## Observability @@ -79,6 +85,8 @@ Cluster monitoring, metrics, and dashboards. | **Tenant Operator** *(Recommended)* | Isolates monitoring resources and access per tenant. | Prometheus Label Proxy, Thanos Operator | | **Inbox Agent / Server / UI** *(ALPHA)* | Cluster event inbox components. | — | +![Configure Observability feature set showing Panopticon, Prometheus Metrics Adapter, Monitoring Operator, Kube Prometheus Stack, Grafana Operator, and Inbox components](images/feature-reference-images/featureset-observability.png) + --- ## Cost Management @@ -92,6 +100,8 @@ Measure and allocate infrastructure and container costs. | **Opencost** *(ALPHA)* | Measure and allocate infrastructure and container costs. | Kube Prometheus Stack, Monitoring Operator | | **OpenCost Grafana Dashboards** | Cost visualization dashboards. | Opencost, Grafana Operator | +![Configure Cost Management feature set showing Keda HTTP Addon, OpenCost Grafana Dashboards, Opencost, and Keda](images/feature-reference-images/featureset-cost-management.png) + --- ## Security @@ -106,6 +116,8 @@ TLS certificates, runtime security, and image scanning. | **Falco** | Container-native runtime threat detection. | — | | **Falco UI Server** | UI for Falco runtime alerts. | Falco, Grafana Operator | +![Configure Security feature set showing Falco UI Server, Falco, CA Cert CSI Driver, Cert Manager, and Scanner](images/feature-reference-images/featureset-security.png) + --- ## Secret Management @@ -129,6 +141,8 @@ Secure secret storage, syncing, and distribution. | **Virtual Secrets** *(ALPHA)* | Virtual Secrets server for not to actually keep the secrets in k8s level. | — | | **Virtual Secrets provider** *(ALPHA)* | Virtual Secrets backend for the CSI driver. | Virtual Secrets, Secrets Store CSI Driver | +![Configure Secret Management feature set showing External Secrets, Kubevault, Config Syncer, Reloader, Sealed Secrets, CSI driver providers, and Virtual Secrets](images/feature-reference-images/featureset-secret-management.png) + --- ## Policy Management @@ -144,6 +158,8 @@ Platform-level policy enforcement. | **Kyverno** | Kubernetes-native policy management. | — | | **Kyverno Policies** | Pod Security Standards implemented as Kyverno policies. | Kyverno | +![Configure Policy Management feature set showing Kyverno Policies, Gatekeeper, Kyverno, GateKeeper Policy Grafana Dashboards, Gatekeeper Templates, and Gatekeeper Constraints](images/feature-reference-images/featureset-policy-management.png) + --- ## Storage Addons @@ -157,6 +173,8 @@ Additional storage drivers and integrations. | **CSI Volume Snapshotter** | Snapshot controller and validation webhook for CSI volumes. | — | | **TopoLVM** | Local LVM-backed CSI storage. | — | +![Configure Storage Addons feature set showing Longhorn, NFS CSI driver, CSI Volume Snapshotter, and TopoLVM](images/feature-reference-images/featureset-storage-addons.png) + --- ## Networking Addons @@ -170,6 +188,8 @@ Networking plugins and extensions. | **Voyager Ingress** | HAProxy-based ingress controller. | — | | **Voyager Gateway** | Envoy-based gateway distro by AppsCode. | — | +![Configure Networking Addons feature set showing Voyager Gateway, Kubernetes Gateway API, External DNS Operator, and Voyager Ingress](images/feature-reference-images/featureset-networking-addons.png) + --- ## Opscenter Tools @@ -182,6 +202,8 @@ DevOps tooling and management utilities. | **Sidekick** *(Recommended)* | Run a one-off container as a pod (sidecar-as-a-pod). | — | | **Operator Shard Manager** *(Recommended)* | Scale operators by sharding responsibility across instances. | — | +![Configure Opscenter Tools feature set showing Operator Shard Manager, Sidekick, and Supervisor](images/feature-reference-images/featureset-opscenter-tools.png) + --- ## Cluster Management @@ -194,6 +216,8 @@ Cluster provisioning and management tools (Cluster API core). | **CAPI Ops Manager** | Day-2 operations for Cluster API clusters. | — | | **Cluster Presets** | Preset configurations for cluster provisioning. Work with cloud NodePools | — | +![Configure Cluster Management feature set showing CAPI Catalog, CAPI Ops Manager, and Cluster Presets](images/feature-reference-images/featureset-cluster-management.png) + --- ## Cluster API AWS (CAPA) @@ -208,6 +232,8 @@ Lifecycle management for clusters running on AWS. | **AWS VPC Peering Operator** *(Recommended)* | Manage AWS VPC peering connections. | — | | **Cluster Autoscaler** *(Recommended)* | Node autoscaling for Cluster API clusters. | — | +![Configure Cluster API AWS (CAPA) feature set showing AWS VPC Peering Operator, AWS Credential Manager, Cluster Autoscaler, AWS Load Balancer Controller, and AWS EBS CSI Driver](images/feature-reference-images/featureset-capi-aws.png) + --- ## Cluster API GCP (CAPG) @@ -218,6 +244,8 @@ Lifecycle management for clusters running on GCP. |---|---|---| | **GCP Credential Manager** *(Recommended)* | Manage GCP credentials used by CAPG. | — | +![Configure Cluster API GCP (CAPG) feature set showing GCP Credential Manager](images/feature-reference-images/featureset-capi-gcp.png) + --- ## Cluster API Azure (CAPZ) @@ -228,6 +256,8 @@ Lifecycle management for clusters running on Azure. |---|---|---| | **Azure Credential Manager** *(Recommended)* | Manage Azure credentials used by CAPZ. | — | +![Configure Cluster API Azure (CAPZ) feature set showing Azure Credential Manager](images/feature-reference-images/featureset-capi-azure.png) + --- ## Crossplane @@ -241,6 +271,8 @@ Control-plane framework for infrastructure as code. | **KubeDB Azure Provider** | Provision KubeDB databases on Azure through Crossplane. | Crossplane | | **KubeDB GCP Provider** | Provision KubeDB databases on GCP through Crossplane. | Crossplane | +![Configure Crossplane feature set showing KubeDB GCP Provider, KubeDB Azure Provider, KubeDB AWS Provider, and Crossplane](images/feature-reference-images/featureset-crossplane.png) + --- ## Multicluster Hub @@ -259,6 +291,8 @@ Central hub for managing a fleet of clusters. | **License Proxyserver Manager** *(Recommended)* | Distribute AppsCode licenses to spoke clusters. | Multicluster Hub, Cluster Profile Manager | | **Hub Cluster Robot** *(Recommended)* | Automation account for hub-driven operations. | Multicluster Hub, Cluster Auth Manager | +![Configure Multicluster Hub feature set showing Cluster Gateway Manager, Cluster Profile Manager, Managed ServiceAccount Manager, Cluster Auth Manager, Hub Cluster Robot, FluxCD Manager, License Proxyserver Manager, Cluster Proxy Manager, and Multicluster Hub](images/feature-reference-images/featureset-multicluster-hub.png) + --- ## Multicluster Spoke @@ -269,6 +303,8 @@ Connect this cluster as a spoke to an existing hub. |---|---|---| | **Multicluster Spoke** *(Recommended)* | Register this cluster as a spoke of a Multicluster Hub. | — | +![Configure Multicluster Spoke feature set showing Multicluster Spoke component with Hub Information and Spoke Information fields](images/feature-reference-images/featureset-multicluster-spoke.png) + --- ## Kubernetes Native Service @@ -281,3 +317,5 @@ Components for Kubernetes-native service patterns. | **Service Gateway Presets** *(Recommended)* | A preset that holds the root 'ace' gateway configurations | Cert Manager, External DNS Operator | | **Service Connector Backend** | Backend for the service connector. | — | | **Service Provider** | Service provider component. | — | + +![Configure Kubernetes Native Service feature set showing Service Catalog, Service Connector Backend, Service Gateway Presets, and Service Provider](images/feature-reference-images/featureset-kubernetes-native-service.png) diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-05-53.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-05-53.png new file mode 100644 index 0000000..0136437 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-05-53.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-06-49.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-06-49.png new file mode 100644 index 0000000..c5e3558 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-06-49.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-10-22.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-10-22.png new file mode 100644 index 0000000..08a6220 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-10-22.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-10-30.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-10-30.png new file mode 100644 index 0000000..8b92260 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-10-30.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-22.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-22.png new file mode 100644 index 0000000..c9a25d7 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-22.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-26.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-26.png new file mode 100644 index 0000000..3399b8d Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-26.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-38.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-38.png new file mode 100644 index 0000000..6a91d19 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-38.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-49.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-49.png new file mode 100644 index 0000000..705161e Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-49.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-53.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-53.png new file mode 100644 index 0000000..9539a4d Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-19-53.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-27.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-27.png new file mode 100644 index 0000000..e56bbe8 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-27.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-34.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-34.png new file mode 100644 index 0000000..383818b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-34.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-39.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-39.png new file mode 100644 index 0000000..78eddde Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-39.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-43.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-43.png new file mode 100644 index 0000000..f47127b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-43.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-47.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-47.png new file mode 100644 index 0000000..6dc7659 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-47.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-51.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-51.png new file mode 100644 index 0000000..74baeaf Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-51.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-55.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-55.png new file mode 100644 index 0000000..8b9db7b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-55.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-57.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-57.png new file mode 100644 index 0000000..0ea72ff Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-20-57.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-05.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-05.png new file mode 100644 index 0000000..4192149 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-05.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-18.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-18.png new file mode 100644 index 0000000..309eeb0 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-18.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-22.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-22.png new file mode 100644 index 0000000..f9e9602 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-22.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-25.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-25.png new file mode 100644 index 0000000..886bca0 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-25.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-29.png b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-29.png new file mode 100644 index 0000000..a4abc7d Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/Screenshot from 2026-06-16 15-22-29.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/delete_cluster.png b/docs/platform/guides/cluster-management/images/Cluster_management/delete_cluster.png new file mode 100644 index 0000000..acb50e4 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/delete_cluster.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/helm-release.png b/docs/platform/guides/cluster-management/images/Cluster_management/helm-release.png new file mode 100644 index 0000000..a00f6fd Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/helm-release.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/removeAndDelete.png b/docs/platform/guides/cluster-management/images/Cluster_management/removeAndDelete.png new file mode 100644 index 0000000..86c3489 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/removeAndDelete.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/remove_cluster.png b/docs/platform/guides/cluster-management/images/Cluster_management/remove_cluster.png new file mode 100644 index 0000000..8baedb9 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/remove_cluster.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-09.png b/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-09.png new file mode 100644 index 0000000..4addef7 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-09.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-20.png b/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-20.png new file mode 100644 index 0000000..2983bd9 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-20.png differ diff --git a/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-41.png b/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-41.png new file mode 100644 index 0000000..bb0069f Binary files /dev/null and b/docs/platform/guides/cluster-management/images/Cluster_management/resource_management/Screenshot from 2026-06-16 15-49-41.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-charts-list.png b/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-charts-list.png new file mode 100644 index 0000000..8b92260 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-charts-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-releases-deployed.png b/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-releases-deployed.png new file mode 100644 index 0000000..a00f6fd Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-releases-deployed.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-releases-list.png b/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-releases-list.png new file mode 100644 index 0000000..08a6220 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-helm-charts/helm-releases-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/cron-jobs-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/cron-jobs-list.png new file mode 100644 index 0000000..d4efeeb Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/cron-jobs-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/daemon-sets-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/daemon-sets-list.png new file mode 100644 index 0000000..ece1b4b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/daemon-sets-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/deployments-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/deployments-list.png new file mode 100644 index 0000000..c9dcd41 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/deployments-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/jobs-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/jobs-list.png new file mode 100644 index 0000000..0285140 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/jobs-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/pods-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/pods-list.png new file mode 100644 index 0000000..68ce55f Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/pods-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/replica-sets-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/replica-sets-list.png new file mode 100644 index 0000000..cdccf6c Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/replica-sets-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/replication-controllers-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/replication-controllers-list.png new file mode 100644 index 0000000..f5c85e9 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/replication-controllers-list.png differ diff --git a/docs/platform/guides/cluster-management/images/cluster-workload/stateful-sets-list.png b/docs/platform/guides/cluster-management/images/cluster-workload/stateful-sets-list.png new file mode 100644 index 0000000..361e9d5 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/cluster-workload/stateful-sets-list.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-backup-recovery.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-backup-recovery.png new file mode 100644 index 0000000..3ca47e5 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-backup-recovery.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-aws.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-aws.png new file mode 100644 index 0000000..404c2c8 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-aws.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-azure.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-azure.png new file mode 100644 index 0000000..7a56e1a Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-azure.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-gcp.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-gcp.png new file mode 100644 index 0000000..d2f41ea Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-capi-gcp.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-cluster-management.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-cluster-management.png new file mode 100644 index 0000000..f6741fa Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-cluster-management.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-cost-management.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-cost-management.png new file mode 100644 index 0000000..5f35ed5 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-cost-management.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-crossplane.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-crossplane.png new file mode 100644 index 0000000..dd31b8b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-crossplane.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-databases.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-databases.png new file mode 100644 index 0000000..c4ca2ec Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-databases.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-kubernetes-native-service.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-kubernetes-native-service.png new file mode 100644 index 0000000..cda767e Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-kubernetes-native-service.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-multicluster-hub.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-multicluster-hub.png new file mode 100644 index 0000000..2b5b11a Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-multicluster-hub.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-multicluster-spoke.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-multicluster-spoke.png new file mode 100644 index 0000000..d3995d8 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-multicluster-spoke.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-networking-addons.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-networking-addons.png new file mode 100644 index 0000000..5f49dd6 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-networking-addons.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-observability.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-observability.png new file mode 100644 index 0000000..c2bd0de Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-observability.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-opscenter-core.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-opscenter-core.png new file mode 100644 index 0000000..a6604b0 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-opscenter-core.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-opscenter-tools.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-opscenter-tools.png new file mode 100644 index 0000000..0893d5b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-opscenter-tools.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-policy-management.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-policy-management.png new file mode 100644 index 0000000..b0bedfd Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-policy-management.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-secret-management.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-secret-management.png new file mode 100644 index 0000000..cf5309b Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-secret-management.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-security.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-security.png new file mode 100644 index 0000000..edda00c Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-security.png differ diff --git a/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-storage-addons.png b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-storage-addons.png new file mode 100644 index 0000000..80d9bcb Binary files /dev/null and b/docs/platform/guides/cluster-management/images/feature-reference-images/featureset-storage-addons.png differ diff --git a/docs/platform/guides/cluster-management/images/remove-cluster/cluster-options-menu.png b/docs/platform/guides/cluster-management/images/remove-cluster/cluster-options-menu.png new file mode 100644 index 0000000..86c3489 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/remove-cluster/cluster-options-menu.png differ diff --git a/docs/platform/guides/cluster-management/images/remove-cluster/delete-cluster-modal.png b/docs/platform/guides/cluster-management/images/remove-cluster/delete-cluster-modal.png new file mode 100644 index 0000000..acb50e4 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/remove-cluster/delete-cluster-modal.png differ diff --git a/docs/platform/guides/cluster-management/images/remove-cluster/remove-cluster-modal.png b/docs/platform/guides/cluster-management/images/remove-cluster/remove-cluster-modal.png new file mode 100644 index 0000000..8baedb9 Binary files /dev/null and b/docs/platform/guides/cluster-management/images/remove-cluster/remove-cluster-modal.png differ diff --git a/docs/platform/guides/cluster-management/remove-cluster.md b/docs/platform/guides/cluster-management/remove-cluster.md index 682558a..f1947e8 100644 --- a/docs/platform/guides/cluster-management/remove-cluster.md +++ b/docs/platform/guides/cluster-management/remove-cluster.md @@ -10,27 +10,46 @@ menu_name: docsplatform_{{.version}} section_menu_id: guides --- - # Remove / Delete Cluster -You can remove an imported cluster from the Platform Console and manage its associated features during removal. +From the cluster list, click the **⋮** (three-dot) menu on any cluster card to access two actions: **Remove** and **Delete**. + +![Cluster options menu showing KubeConfig, Remove, and Delete actions](images/remove-cluster/cluster-options-menu.png) -1. **Navigate to the Cluster Overview Page:** - - Go to the [Platform Console](https://console.appscode.com). - - Click on your imported cluster to access the Cluster Overview page. +--- - **OR** +## Remove -2. **Access Removal Options from Cluster List:** - - On the [Cluster List](https://console.appscode.com) page, locate your cluster. - - Click the three dots attached to your cluster to find the removal button. +**Remove** unregisters the cluster from the Cluster UI. The actual Kubernetes cluster and its workloads are left untouched. -3. **Remove Cluster:** - - In both instances, you will find the option to remove the cluster. - - Confirm the removal to complete the process. +1. Click **⋮** on your cluster card. +2. Click **Remove**. +3. A confirmation modal opens. Optionally check any cleanup actions to run before removal: + - **Remove FluxCD** — uninstalls FluxCD from the cluster. + - **Remove All Features** — uninstalls all installed feature-sets from the cluster. +4. Click **Yes, Remove**. -4. **Manage Features:** - - During the removal process, you have the option to disable features associated with the cluster. +![Remove Cluster modal with optional checkboxes for Remove FluxCD and Remove All Features](images/remove-cluster/remove-cluster-modal.png) --- +## Delete + +**Delete** permanently destroys the cluster and its underlying infrastructure. This action is irreversible. + +1. Click **⋮** on your cluster card. +2. Click **Delete**. +3. Confirm in the modal by clicking **Yes, Delete**. + +![Delete Cluster modal asking for confirmation with Yes, Delete button](images/remove-cluster/delete-cluster-modal.png) + +> **Warning:** Delete tears down the actual infrastructure. Use **Remove** if you only want to unregister the cluster from the UI. + +--- + +## Quick Reference + +| Action | What happens | Cluster destroyed? | +|---|---|---| +| **Remove** | Unregisters cluster from Cluster UI | No | +| **Delete** | Destroys cluster + infrastructure | Yes |