Modify man pages for image-naming

This PR adds recommendations in man pages to use only [a-z0-9-_.] when
naming and tagging images.  The purpose of this is to add consistency
and to make image naming caps rules seem less arbitrary.

This PR addresses confusion with:
1. BaseImage:Tagged (not allowed)
2. baseimage:Tagged (allowed)
3. baseimage/tagged:V1 (allowed)
4. baseimage/Tagged:V1 (not allowed)

Signed-off-by: Sally O'Malley <somalley@redhat.com>
This commit is contained in:
Sally O'Malley 2015-07-01 11:15:17 -04:00
parent 9158ddef89
commit 05a86905a2
4 changed files with 13 additions and 6 deletions

View file

@ -171,8 +171,8 @@ instruction into the specified target.
## Building an image and naming that image ## Building an image and naming that image
A good practice is to give a name to the image you are building. There are A good practice is to give a name to the image you are building. Note that
no hard rules here but it is best to give the names consideration. only a-z0-9-_. should be used for consistency. There are no hard rules here but it is best to give the names consideration.
The **-t**/**--tag** flag is used to rename an image. Here are some examples: The **-t**/**--tag** flag is used to rename an image. Here are some examples:
@ -190,7 +190,7 @@ and give it the version 1.0:
The next example is for the "whenry" user repository and uses Fedora and The next example is for the "whenry" user repository and uses Fedora and
JBoss and gives it the version 2.1 : JBoss and gives it the version 2.1 :
docker build -t whenry/fedora-jboss:V2.1 docker build -t whenry/fedora-jboss:v2.1
If you do not provide a version tag then Docker will assign `latest`: If you do not provide a version tag then Docker will assign `latest`:
@ -229,3 +229,4 @@ Note: supported compression formats are 'xz', 'bzip2', 'gzip' and 'identity' (no
March 2014, Originally compiled by William Henry (whenry at redhat dot com) March 2014, Originally compiled by William Henry (whenry at redhat dot com)
based on docker.com source material and internal work. based on docker.com source material and internal work.
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
June 2015, updated by Sally O'Malley <somalley@redhat.com>

View file

@ -50,6 +50,9 @@ create a new image run `docker ps` to find the container's ID and then run:
# docker commit -m="Added Apache to Fedora base image" \ # docker commit -m="Added Apache to Fedora base image" \
-a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20 -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20
Note that only a-z0-9-_. are allowed when naming images from an
existing container.
## Apply specified Dockerfile instructions while committing the image ## Apply specified Dockerfile instructions while committing the image
If an existing container was created without the DEBUG environment If an existing container was created without the DEBUG environment
variable set to "true", you can create a new image based on that variable set to "true", you can create a new image based on that
@ -64,3 +67,4 @@ based on docker.com source material and in
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
Oct 2014, updated by Daniel, Dao Quang Minh <daniel at nitrous dot io> Oct 2014, updated by Daniel, Dao Quang Minh <daniel at nitrous dot io>
June 2015, updated by Sally O'Malley <somalley@redhat.com>

View file

@ -24,7 +24,8 @@ specify a `REGISTRY_HOST`, the command uses Docker's public registry located at
# Pushing a new image to a registry # Pushing a new image to a registry
First save the new image by finding the container ID (using **docker ps**) First save the new image by finding the container ID (using **docker ps**)
and then committing it to a new image name: and then committing it to a new image name. Note that only a-z0-9-_. are
allowed when naming images:
# docker commit c16378f943fe rhel-httpd # docker commit c16378f943fe rhel-httpd
@ -48,4 +49,4 @@ April 2014, Originally compiled by William Henry (whenry at redhat dot com)
based on docker.com source material and internal work. based on docker.com source material and internal work.
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
April 2015, updated by Mary Anthony for v2 <mary@docker.com> April 2015, updated by Mary Anthony for v2 <mary@docker.com>
June 2015, updated by Sally O'Malley <somalley@redhat.com>

View file

@ -34,6 +34,7 @@ separated by a ':'
**TAG** **TAG**
The tag you are assigning to the image. Though this is arbitrary it is The tag you are assigning to the image. Though this is arbitrary it is
recommended to be used for a version to distinguish images with the same name. recommended to be used for a version to distinguish images with the same name.
Also, for consistency tags should only include a-z0-9-_. .
Note that here TAG is a part of the overall name or "tag". Note that here TAG is a part of the overall name or "tag".
# OPTIONS # OPTIONS
@ -62,4 +63,4 @@ based on docker.com source material and internal work.
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
April 2015, updated by Mary Anthony for v2 <mary@docker.com> April 2015, updated by Mary Anthony for v2 <mary@docker.com>
June 2015, updated by Sally O'Malley <somalley@redhat.com>