mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
f93fee5f48
Tweaking for Hugo Updating the Dockerfile with new sed; fix broken link on Kitematic Fixing image pull for Dockerfile Removing docs targets Signed-off-by: Mary Anthony <mary@docker.com>
42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
<!--[metadata]>
|
|
+++
|
|
draft = true
|
|
title = "Repository"
|
|
description = "Definition of an Repository"
|
|
keywords = ["containers, concepts, explanation, image, repository, container"]
|
|
[menu.main]
|
|
parent = "identifier"
|
|
+++
|
|
<![end-metadata]-->
|
|
|
|
# Repository
|
|
|
|
## Introduction
|
|
|
|
A repository is a set of images either on your local Docker server, or
|
|
shared, by pushing it to a [*Registry*](/terms/registry/#registry-def)
|
|
server.
|
|
|
|
Images can be associated with a repository (or multiple) by giving them
|
|
an image name using one of three different commands:
|
|
|
|
1. At build time (e.g., `docker build -t IMAGENAME`),
|
|
2. When committing a container (e.g.,
|
|
`docker commit CONTAINERID IMAGENAME`) or
|
|
3. When tagging an image id with an image name (e.g.,
|
|
`docker tag IMAGEID IMAGENAME`).
|
|
|
|
A Fully Qualified Image Name (FQIN) can be made up of 3 parts:
|
|
|
|
`[registry_hostname[:port]/][user_name/](repository_name:version_tag)`
|
|
|
|
`username` and `registry_hostname` default to an empty string. When
|
|
`registry_hostname` is an empty string, then `docker push` will push to
|
|
`index.docker.io:80`.
|
|
|
|
If you create a new repository which you want to share, you will need to
|
|
set at least the `user_name`, as the `default` blank `user_name` prefix is
|
|
reserved for [Official Repositories](/docker-hub/official_repos).
|
|
|
|
For more information see [*Working with
|
|
Repositories*](/userguide/dockerrepos/#working-with-the-repository)
|