Skip to content

Commit f5b07d0

Browse files
authored
Merge pull request #23737 from sftim/20200907_add_workload_concept_introduction
Add introduction to Workloads concept
2 parents dacb5a8 + 45fa151 commit f5b07d0

File tree

2 files changed

+51
-1
lines changed

2 files changed

+51
-1
lines changed

content/en/docs/concepts/workloads/_index.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,55 @@ title: "Workloads"
33
weight: 50
44
description: >
55
Understand Pods, the smallest deployable compute object in Kubernetes, and the higher-level abstractions that help you to run them.
6+
no_list: true
67
---
78

9+
{{< glossary_definition term_id="workload" length="short" >}}
10+
Whether your workload is a single component or several that work together, on Kubernetes you run
11+
it inside a set of [Pods](/docs/concepts/workloads/pods).
12+
In Kubernetes, a Pod represents a set of running {{< glossary_tooltip text="containers" term_id="container" >}}
13+
on your cluster.
14+
15+
A Pod has a defined lifecycle. For example, once a Pod is running in your cluster then
16+
a critical failure on the {{< glossary_tooltip text="node" term_id="node" >}} where that
17+
Pod is running means that all the Pods on that node fail. Kubernetes treats that level
18+
of failure as final: you would need to create a new Pod even if the node later recovers.
19+
20+
However, to make life considerably easier, you don't need to manage each Pod directly.
21+
Instead, you can use _workload resources_ that manage a set of Pods on your behalf.
22+
These resources configure {{< glossary_tooltip term_id="controller" text="controllers" >}}
23+
that make sure the right number of the right kind of Pod are running, to match the state
24+
you specified.
25+
26+
Those workload resources include:
27+
28+
* [Deployment](/docs/concepts/workloads/controllers/deployment/) and [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/)
29+
(replacing the legacy resource {{< glossary_tooltip text="ReplicationController" term_id="replication-controller" >}});
30+
* [StatefulSet](/docs/concepts/workloads/controllers/statefulset/);
31+
* [DaemonSet](/docs/concepts/workloads/controllers/daemonset/) for running Pods that provide
32+
node-local facilities, such as a storage driver or network plugin;
33+
* [Job](/docs/concepts/workloads/controllers/job/) and
34+
[CronJob](/docs/concepts/workloads/controllers/cronjob/)
35+
for tasks that run to completion.
36+
37+
There are also two supporting concepts that you might find relevant:
38+
* [Garbage collection](/docs/concepts/workloads/controllers/garbage-collection/) tidies up objects
39+
from your cluster after their _owning resource_ has been removed.
40+
* The [_time-to-live after finished_ controller](/docs/concepts/workloads/controllers/ttlafterfinished/)
41+
removes Jobs once a defined time has passed since they completed.
42+
43+
## {{% heading "whatsnext" %}}
44+
45+
As well as reading about each resource, you can learn about specific tasks that relate to them:
46+
47+
* [Run a stateless application using a Deployment](/docs/tasks/run-application/run-stateless-application-deployment/)
48+
* Run a stateful application either as a [single instance](/docs/tasks/run-application/run-single-instance-stateful-application/)
49+
or as a [replicated set](/docs/tasks/run-application/run-replicated-stateful-application/)
50+
* [Run Automated Tasks with a CronJob](/docs/tasks/job/automated-tasks-with-cron-jobs/)
51+
52+
Once your application is running, you might want to make it available on the internet as
53+
a [Service](/docs/concepts/services-networking/service/) or, for web application only,
54+
using an [Ingress](/docs/concepts/services-networking/ingress).
55+
56+
You can also visit [Configuration](/docs/concepts/configuration/) to learn about Kubernetes'
57+
mechanisms for separating code from configuration.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Controllers"
2+
title: "Workload Resources"
33
weight: 20
44
---
55

0 commit comments

Comments
 (0)