Skip to content

Commit e132a42

Browse files
authored
Merge pull request #47770 from jpbetz/retry-generate-name-ga
Promote RetryGenerateName to GA in 1.32
2 parents 5746924 + 31aba2f commit e132a42

File tree

2 files changed

+14
-0
lines changed

2 files changed

+14
-0
lines changed

content/en/docs/concepts/overview/working-with-objects/names.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,12 @@ of the same resource. API resources are distinguished by their API group, resour
3232
In cases when objects represent a physical entity, like a Node representing a physical host, when the host is re-created under the same name without deleting and re-creating the Node, Kubernetes treats the new host as the old one, which may lead to inconsistencies.
3333
{{< /note >}}
3434

35+
The server may generate a name when `generateName` is provided instead of `name` in a resource create request.
36+
When `generateName` is used, the provided value is used as a name prefix, which server appends a generated suffix
37+
to. Even though the name is generated, it may conflict with existing names resulting in a HTTP 409 resopnse. This
38+
became far less likely to happen in Kubernetes v1.31 and later, since the server will make up to 8 attempt to generate a
39+
unique name before returning a HTTP 409 response.
40+
3541
Below are four types of commonly used name constraints for resources.
3642

3743
### DNS Subdomain Names

content/en/docs/reference/command-line-tools-reference/feature-gates/retry-generate-name.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,14 @@ stages:
99
- stage: alpha
1010
defaultValue: false
1111
fromVersion: "1.30"
12+
toVersion: "1.30"
13+
- stage: beta
14+
defaultValue: true
15+
fromVersion: "1.31"
16+
toVersion: "1.31"
17+
- stage: stable
18+
defaultValue: true
19+
fromVersion: "1.32"
1220
---
1321
Enables retrying of object creation when the
1422
{{< glossary_tooltip text="API server" term_id="kube-apiserver" >}}

0 commit comments

Comments
 (0)