Skip to content

Commit 8ac6b03

Browse files
authored
Merge pull request #32923 from jai/jai/add-app-labels-well-known
Register and properly document recommended workload labels
2 parents 97295ed + 795672d commit 8ac6b03

File tree

1 file changed

+70
-0
lines changed
  • content/en/docs/reference/labels-annotations-taints

1 file changed

+70
-0
lines changed

content/en/docs/reference/labels-annotations-taints/_index.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,76 @@ This document serves both as a reference to the values and as a coordination poi
1515

1616
## Labels, annotations and taints used on API objects
1717

18+
### app.kubernetes.io/component
19+
20+
Example: `app.kubernetes.io/component=database`
21+
22+
Used on: All Objects
23+
24+
The component within the architecture.
25+
26+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
27+
28+
### app.kubernetes.io/created-by
29+
30+
Example: `app.kubernetes.io/created-by=controller-manager`
31+
32+
Used on: All Objects
33+
34+
The controller/user who created this resource.
35+
36+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
37+
38+
### app.kubernetes.io/instance
39+
40+
Example: `app.kubernetes.io/instance=mysql-abcxzy`
41+
42+
Used on: All Objects
43+
44+
A unique name identifying the instance of an application.
45+
46+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
47+
48+
### app.kubernetes.io/managed-by
49+
50+
Example: `app.kubernetes.io/managed-by=helm`
51+
52+
Used on: All Objects
53+
54+
The tool being used to manage the operation of an application.
55+
56+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
57+
58+
### app.kubernetes.io/name
59+
60+
Example: `app.kubernetes.io/name=mysql`
61+
62+
Used on: All Objects
63+
64+
The name of the application.
65+
66+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
67+
68+
### app.kubernetes.io/part-of
69+
70+
Example: `app.kubernetes.io/part-of=wordpress`
71+
72+
Used on: All Objects
73+
74+
The name of a higher level application this one is part of.
75+
76+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
77+
78+
### app.kubernetes.io/version
79+
80+
Example: `app.kubernetes.io/version="5.7.21"`
81+
82+
Used on: All Objects
83+
84+
The current version of the application (e.g., a semantic version, revision hash, etc.).
85+
86+
One of the [recommended labels](/docs/concepts/overview/working-with-objects/common-labels/#labels).
87+
1888
### kubernetes.io/arch
1989

2090
Example: `kubernetes.io/arch=amd64`

0 commit comments

Comments
 (0)