Version information
Start using this module
Add this module to your Puppetfile:
mod 'markb-docker_registry', '0.2.0'
Learn more about managing modules with a PuppetfileDocumentation
#docker_registry
####Table of Contents
- Overview
- 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
##Overview
The docker_registry module delploys a private docker registry.
##Module Description
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.
##Setup
###affected components
- 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.
###Setup Requirements
on ubuntu, make sure ruby 1.9.x is installed.
###getting started
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
##Usage
include docker_registry
##Reference
forthcoming
##Limitations
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.
##Development
Please see the Github repository to contribute.
Dependencies
- stahnma/epel (>= 1.0.0)
- puppetlabs/apt (>= 1.7.0)
- stankevich/python (>= 1.7.15)