From a9840a3e33ba997500ff9ae1fa36336165f5b206 Mon Sep 17 00:00:00 2001 From: Kyle Squizzato Date: Wed, 1 Aug 2018 16:17:26 -0400 Subject: [PATCH] [manage-images] Clarify character limitations on image names Signed-off-by: Kyle Squizzato --- ee/dtr/user/manage-images/index.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/ee/dtr/user/manage-images/index.md b/ee/dtr/user/manage-images/index.md index dee4775fcb..72b03993ee 100644 --- a/ee/dtr/user/manage-images/index.md +++ b/ee/dtr/user/manage-images/index.md @@ -34,9 +34,19 @@ When creating a repository in DTR, the full name of the repository becomes `//`. In this example, the full name of our repository will be `dtr.example.org/dave.lauper/golang`. -DTR only allows image names with 255 characters. This includes the domain, -organization, and repository name. When you create a repository, make sure -its full name has less than 255 characters. +When creating an image name for use with DTR ensure that the organization and +repository name has less than 56 characters and that the entire image name +which includes domain, organization and repository name does not exceed 255 +characters. + +*The 56 character `` limit in DTR is due to an +underlying limitation in how the image name information is stored within +DTR metadata in RethinkDB. RethinkDB currently has a Primary Key length limit +of 127 characters. + +When DTR stores the above data it appends a sha256sum comprised of 72 characters +to the end of the value to ensure uniqueness within the database. If the `` exceeds 56 characters it will then exceed the +127 character limit in RethinkDB (72+56=128).* ## Where to go next