github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2025-08-03 17:30:00 +00:00
Code Issues Projects Releases Wiki Activity

Document auto-set names

Browse Source
This commit is contained in:
Tim Hockin 2014-09-09 23:05:38 -07:00
parent 1d9cff4a87
commit 1eeed78a38
1 changed files with 1 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/identifiers.md
View File

@ -40,12 +40,11 @@ Name
1. must be non-empty and unique within the apiserver 1. must be non-empty and unique within the apiserver
2. enables idempotent and space-unique creation 2. enables idempotent and space-unique creation
1. generating random names will defeat idempotentcy 1. generating random names will defeat idempotentcy
2. for situations where generating a name is impractical, some or all objects may support a param to auto-generate a name
3. parts of the system (e.g. replication controller) may join strings (e.g. a base name and a random suffix) to create a unique Name 3. parts of the system (e.g. replication controller) may join strings (e.g. a base name and a random suffix) to create a unique Name
Example: "guestbook.user" Example: "guestbook.user"
Example: "backend-x4eb1" Example: "backend-x4eb1"
FIXME: final debate on having master default a name. Alternative: set "autosetName"=true
2. Upon acceptance of an object via an api, the object is assigned a UID (a UUID). 2. Upon acceptance of an object via an api, the object is assigned a UID (a UUID).
1. must be non-empty and unique across space and time 1. must be non-empty and unique across space and time
Example: "01234567-89ab-cdef-0123-456789abcdef" Example: "01234567-89ab-cdef-0123-456789abcdef"