3f1859af26
This commit removes `oss` storage driver from distribution as well as `alicdn` storage middleware which only works with the `oss` driver. There are several reasons for it: * no real-life expertise among the maintainers * oss is compatible with S3 API operations required by S3 storage driver Signed-off-by: Milos Gajdos <milosthegajdos@gmail.com>
3.5 KiB
| description | keywords | title |
|---|---|---|
| Explains what the Registry is, basic use cases and requirements | registry, on-prem, images, tags, repository, distribution, use cases, requirements | About Registry |
A registry is a storage and content delivery system, holding named Docker images, available in different tagged versions.
Example: the image
distribution/registry, with tags2.0and2.1.
Users interact with a registry by using docker push and pull commands.
Example:
docker pull registry-1.docker.io/distribution/registry:2.1.
Storage itself is delegated to drivers. The default storage driver is the local posix filesystem, which is suitable for development or small deployments. Additional cloud-based storage drivers like S3, Microsoft Azure and Google Cloud Storage are supported. People looking into using other storage drivers should consider if the driver they'd like to be supported is S3 compatible like many cloud storage systems as adding new storage driver support has been put on hold for the time being.
Since securing access to your hosted images is paramount, the Registry natively supports TLS and basic authentication.
The Registry GitHub repository includes additional information about advanced authentication and authorization methods. Only very large or public deployments are expected to extend the Registry in this way.
Finally, the Registry ships with a robust notification system, calling webhooks in response to activity, and both extensive logging and reporting, mostly useful for large installations that want to collect metrics.
Understanding image naming
Image names as used in typical docker commands reflect their origin:
docker pull ubuntuinstructs docker to pull an image namedubuntufrom the official Docker Hub. This is simply a shortcut for the longerdocker pull docker.io/library/ubuntucommanddocker pull myregistrydomain:port/foo/barinstructs docker to contact the registry located atmyregistrydomain:portto find the imagefoo/bar
You can find out more about the various Docker commands dealing with images in the official Docker engine documentation.
Use cases
Running your own Registry is a great solution to integrate with and complement your CI/CD system. In a typical workflow, a commit to your source revision control system would trigger a build on your CI system, which would then push a new image to your Registry if the build is successful. A notification from the Registry would then trigger a deployment on a staging environment, or notify other systems that a new image is available.
It's also an essential component if you want to quickly deploy a new image over a large cluster of machines.
Finally, it's the best way to distribute images inside an isolated network.
Requirements
You absolutely need to be familiar with Docker, specifically with regard to pushing and pulling images. You must understand the difference between the daemon and the cli, and at least grasp basic concepts about networking.
Also, while just starting a registry is fairly easy, operating it in a production environment requires operational skills, just like any other service. You are expected to be familiar with systems availability and scalability, logging and log processing, systems monitoring, and security 101. Strong understanding of http and overall network communications, plus familiarity with golang are certainly useful as well for advanced operations or hacking.
Next
Dive into deploying your registry