####Table of Contents
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with docker_registry
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how coming soon
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
The docker_registry module delploys a private docker registry.
Docker is an open platform for developers and sysadmins to build, ship, and run distributed applications. Consisting of Docker Engine, a portable, lightweight runtime and packaging tool, and Docker Hub, a cloud service for sharing applications and automating workflows, Docker enables apps to be quickly assembled from components and eliminates the friction between development, QA, and production environments. As a result, IT can ship faster and run the same app, unchanged, on laptops, data center VMs, and any cloud.
The Docker registry offers some of the same functionality as the Docker Hub. It can be installed and administered privately where business, network, and other concerns prohibit the use of a third party hub.
Please note that the deployed registry will be insecure.
- This module adds the requisite repositories and packages for running the docker registry, then starts the service.
- This is an alpha stage module; not intended for production use.
on ubuntu, make sure ruby 1.9.x is installed.
wget https://forgeapi.puppetlabs.com/v3/files/markb-docker_registry-0.2.0.tar.gz puppet module install markb-docker_registry-0.2.0.tar.gz puppet apply -e 'include docker_registry'
you'll want to stop the docker service and start a daemon with the insecure flag:
docker -d --insecure-registry localhost:5000
then you can use the following to see that the registry is working:
docker search tutorial docker pull learn/tutorial docker run learn/tutorial apt-get install -y ping docker ps -a docker commit <hash from last command> localhost:5000/tutorialWithPing docker push localhost:5000/tutorialWithPing
This module will only work for Debian and Rel variants. It's only been tesed on CentOs 6.5 and Ubuntu 12.04 at this point. Feedback and errata on other distros/versions is eagerly anticipated.
Please see the Github repository to contribute.