From 1eeed78a3886f6ea594e25b9ca23eebb093674ee Mon Sep 17 00:00:00 2001 From: Tim Hockin Date: Tue, 9 Sep 2014 23:05:38 -0700 Subject: [PATCH] Document auto-set names --- docs/identifiers.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/identifiers.md b/docs/identifiers.md index 07bc9391554..10bc3c35296 100644 --- a/docs/identifiers.md +++ b/docs/identifiers.md @@ -40,12 +40,11 @@ Name 1. must be non-empty and unique within the apiserver 2. enables idempotent and space-unique creation 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 Example: "guestbook.user" 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). 1. must be non-empty and unique across space and time Example: "01234567-89ab-cdef-0123-456789abcdef"