github.com/ld86/docker@v1.7.1-rc3/docs/terms/repository.md (about)

     1  <!--[metadata]>
     2  +++
     3  draft = true
     4  title = "Repository"
     5  description = "Definition of an Repository"
     6  keywords = ["containers, concepts, explanation, image, repository,  container"]
     7  [menu.main]
     8  parent = "identifier"
     9  +++
    10  <![end-metadata]-->
    11  
    12  # Repository
    13  
    14  ## Introduction
    15  
    16  A repository is a set of images either on your local Docker server, or
    17  shared, by pushing it to a [*Registry*](/terms/registry/#registry-def)
    18  server.
    19  
    20  Images can be associated with a repository (or multiple) by giving them
    21  an image name using one of three different commands:
    22  
    23  1. At build time (e.g., `docker build -t IMAGENAME`),
    24  2. When committing a container (e.g.,
    25     `docker commit CONTAINERID IMAGENAME`) or
    26  3. When tagging an image id with an image name (e.g.,
    27     `docker tag IMAGEID IMAGENAME`).
    28  
    29  A Fully Qualified Image Name (FQIN) can be made up of 3 parts:
    30  
    31  `[registry_hostname[:port]/][user_name/](repository_name:version_tag)`
    32  
    33  `username` and `registry_hostname` default to an empty string. When
    34  `registry_hostname` is an empty string, then `docker push` will push to
    35  `index.docker.io:80`.
    36  
    37  If you create a new repository which you want to share, you will need to
    38  set at least the `user_name`, as the `default` blank `user_name` prefix is
    39  reserved for [Official Repositories](/docker-hub/official_repos).
    40  
    41  For more information see [*Working with
    42  Repositories*](/userguide/dockerrepos/#working-with-the-repository)