Skip to content

Commit 3874094

Browse files
improved text
Signed-off-by: Sourav Roy <souravroy@appscode.com>
1 parent 0c39cd2 commit 3874094

1 file changed

Lines changed: 20 additions & 4 deletions

File tree

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

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,18 @@ Every list page in this group follows the same layout: a 🔍 search box, an **A
2626

2727
## Deployments
2828

29-
Lists every Deployment with its Namespace, Pods (ready count), Images, and Age.
29+
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.
30+
31+
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.
3032

3133
![Deployments list page showing the table of deployments with namespace filter and Create button](images/cluster-workload/deployments-list.png)
3234

3335
---
3436

3537
## Replica Sets
3638

39+
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.
40+
3741
Lists every Replica Set with its Namespace, Pods, Images, and Age.
3842

3943
![Replica Sets list page showing namespace, pods, images, and age columns](images/cluster-workload/replica-sets-list.png)
@@ -42,6 +46,8 @@ Lists every Replica Set with its Namespace, Pods, Images, and Age.
4246

4347
## Replication Controllers
4448

49+
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.
50+
4551
Lists every Replication Controller with its Namespace, Pods, Images, and Age. Click **+ Create ReplicationController** to add one.
4652

4753
![Replication Controllers list page with no data available and a Create ReplicationController button](images/cluster-workload/replication-controllers-list.png)
@@ -50,6 +56,8 @@ Lists every Replication Controller with its Namespace, Pods, Images, and Age. Cl
5056

5157
## Stateful Sets
5258

59+
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.
60+
5361
Lists every Stateful Set with its Namespace, Pods, Images, and Age.
5462

5563
![Stateful Sets list page showing namespace, pods, images, and age columns](images/cluster-workload/stateful-sets-list.png)
@@ -58,14 +66,18 @@ Lists every Stateful Set with its Namespace, Pods, Images, and Age.
5866

5967
## Daemon Sets
6068

61-
Lists every Daemon Set with its Namespace, Pods, Dsired, Current-Scheduled, Up-to-date, Node Selector, Images, and Age.
69+
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.
70+
71+
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.
6272

6373
![Daemon Sets list page showing desired, current-scheduled, and up-to-date columns](images/cluster-workload/daemon-sets-list.png)
6474

6575
---
6676

6777
## Jobs
6878

79+
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.
80+
6981
Lists every Job with its Namespace, Annotations, Completions, Duration, Images, and Age.
7082

7183
![Jobs list page showing completions, duration, images, and age columns](images/cluster-workload/jobs-list.png)
@@ -74,15 +86,19 @@ Lists every Job with its Namespace, Annotations, Completions, Duration, Images,
7486

7587
## Cron Jobs
7688

77-
Lists every Cron Job with its Namespace, Annotations, Schedule, Suspend, Active, Last Schedule, Images, and Age.
89+
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.
90+
91+
Lists every Cron Job with its Namespace, Annotations, Schedule, Suspend, Active, Last Schedule, Images, and Age — the Schedule column shows the cron expression.
7892

7993
![Cron Jobs list page showing schedule, suspend, active, and last schedule columns](images/cluster-workload/cron-jobs-list.png)
8094

8195
---
8296

8397
## Pods
8498

85-
Lists every Pod with its Namespace, Ready, Status, Restarts, IP, Images, and Age — the only Workloads item with these extra live-state columns.
99+
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.
100+
101+
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.
86102

87103
![Pods list page showing Ready, Status, Restarts, and IP columns](images/cluster-workload/pods-list.png)
88104

0 commit comments

Comments
 (0)