capistrano-docker 0.0.01

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a592fc849c9d22346829a7c36469511f958f6ed4
+  data.tar.gz: c54393b6fa06d26e7af161d460b5c597ab55fadc
+SHA512:
+  metadata.gz: 3da59a8592defba7141b6c595ff6251f635bf1abe3b958277112510b5ed04dd314d385e09972ef1e8ff8a9bde71793f1fbe8919015be045e537baf33da7b859b
+  data.tar.gz: cbfa3ff8723cf116ffd84c65048b2854ce4a5bcb2f911aca40917fd0fb58ef0c58a01d2ed6b841bce92b4285dd3a6d819a5cb56d48507bc8f0ebee5fe9d5ee2f

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_*
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/README.md

@@ -0,0 +1,42 @@
+# Capistrano - Docker Appliance Deploy
+
+This project aims to make it simple to deploy multiple apps inside Docker containers to an overall Docker Host.
+
+### Opinionated File Structure
+
+To make the process as simple as possible this project specifies an opinianated file structure, it will be much easier to start with a clean slate rather than trying to backport this to legacy file setup.
+
+Apps are namespaced by an account and an application, in a similar concept to Github account/repo structure.
+
+### Persistent Data Support
+
+There is support for persistent storage via configuration of volumes. Multiple volumes are supported for each project.
+
+### Installation & Required Configuration
+
+To get started you will need the following setup.
+
+    1. A local git repo that stores your project file
+    2. The root of the project needs a Dockerfile that handles the container build
+    3. A remote server with Docker installed and a preferably empty filesystem for the specified user.
+    4. A local Capfile that handles the configuration for the deploy.
+    
+Here's an example of the minimum requirements for your local Capfile.
+
+```
+require 'rubygems'
+require 'bundler/setup'
+require 'capistrano/setup'
+require 'capistrano/docker'
+
+set :namespace,         "yournamespace"
+set :application,       "yourapp"
+set :port,              "59999"
+set :stage,             "production"
+
+task :production do
+    set :branch,        "master"
+    server 'docker.yourserver.com', user: 'docker', roles: %w{host}
+end
+
+```

data/capistrano-docker.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'capistrano-docker'
+  spec.version       = '0.0.01'
+  spec.authors       = ["Ross Riley"]
+  spec.email         = ["riley.ross@gmail.com"]
+  spec.description   = %q{Docker support for Capistrano 3.x}
+  spec.summary       = %q{Docker support for Capistrano 3.x}
+  spec.homepage      = 'https://github.com/rossriley/capistrano-docker'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'capistrano', '>= 3.1'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+end

data/lib/capistrano/docker.rb

@@ -0,0 +1,3 @@
+load File.expand_path('../tasks/docker.rake', __FILE__)
+load File.expand_path('../tasks/deploy.rake', __FILE__)
+

data/lib/capistrano/tasks/deploy.rake

@@ -0,0 +1,137 @@
+namespace :deploy do
+
+    
+    desc "Checks that the required configuration parameters are set"
+    task :check do 
+        on roles :all do
+            if roles(:host).length==0
+                error "You do not have any host machines defined in your capfile. Try eg: server 'host.example.com', user:youruser, roles: %w{host}"
+                exit 
+            end
+            if !fetch(:ports) || fetch(:ports).length ==0
+                error "You do not have any port mappings defined in your capfile. Try eg: set :ports, {11111=>80}"
+                exit
+            end 
+            if !fetch(:namespace)
+                error "You do not have a docker namespace variable defined in your capfile. Try eg: set :namespace, yourname"
+                exit 
+            end
+            if !fetch(:password)
+                error "You do not have an application password defined in your capfile. Try eg: set :password, secret1234"
+                exit 
+            end
+            if !File.exists?('Dockerfile')
+                error "You need to have a Dockerfile setup in the root of your project"
+                exit 
+            end
+            run_locally do 
+                outp = capture "git ls-files Dockerfile"
+                if outp.length == 0
+                    error "You need to have a Dockerfile commited into the root of your project. Try using: git add Dockerfile and then git commit"
+                    exit 
+                end
+            end
+
+        end
+    end
+    
+    desc "Builds project locally ready for deploy."
+    task :build do
+        puts "Preparing local build: note, only code commited to your local Git repository will be included."
+       
+        run_locally do
+            begin
+                capture "ls tmp/build/.git"
+            rescue
+                execute "mkdir -p tmp/build"
+                execute "cd tmp/build && git clone ../../ ."
+            end
+            
+            execute "cd tmp/build/ && git fetch && git checkout -f origin/HEAD"
+
+            fetch(:build_commands).each do |command|
+                execute "cd tmp/build && "+command       
+            end
+            
+            execute "echo '"+fetch(:start_commands, []).join(';\n') +"' > tmp/build/start.sh"
+            execute "chmod +x tmp/build/start.sh"        
+        
+        end   
+        
+        
+    end
+    
+    desc "Updates the code on the remote container"
+    task :update do
+        on roles :host do |host|
+            info " Running Rsync to: #{host.user}@#{host.hostname}"
+            run_locally do
+                execute "rsync -rup --exclude '.git' tmp/build/* #{host.user}@#{host.hostname}:#{fetch(:docker_buildpath)}/"
+            end
+        end
+    end
+    
+    task :container do 
+        invoke "docker:prepare"
+    end
+    
+    task :deploy do
+        invoke "docker:build"
+    end
+    
+    task :proxy do
+        on roles :host do |host|
+            config = ""
+            fetch(:proxies).each do |proxy,port|
+                config <<  "server {" + "\n"
+                config << "  server_name "+proxy+";" + "\n"
+                config << "  location / {" + "\n"
+                config << "    proxy_pass http://127.0.0.1:"+port+"/;" + "\n"
+                config << "    proxy_set_header Host $http_host;" + "\n"
+                config << "  }" + "\n"
+                config << "}" + "\n"
+            end
+            basepath = "dockerappliance/conf/nginx/"
+            destination = basepath + fetch(:docker_appname)+".conf"
+            io   = StringIO.new(config)
+            upload! io,   destination
+        end
+    end
+    
+    task :supervisor do
+        on roles :host do |host|
+            config = ""
+            config << "[program:"+fetch(:docker_appname)+"]"+"\n"
+            config << "command=docker start -a "+fetch(:docker_appname) + "\n"
+            config << "autorestart=true"+"\n"
+            destination = "dockerappliance/conf/supervisor/" + fetch(:docker_appname)+".conf"
+            io   = StringIO.new(config)
+            upload! io,   destination
+        end
+    end
+    
+    task :restart do
+        on roles :host do |host|
+            execute "sudo service nginx restart"
+        end
+    end
+    
+    
+    task :finished do 
+        
+    end
+    
+end
+
+desc 'Deploy a new release.'
+task :deploy do
+  set(:deploying, true)
+  %w{ check build container update deploy proxy supervisor restart finished }.each do |task|
+    invoke "deploy:#{task}"
+  end
+end
+task default: :deploy
+invoke 'load:defaults'
+
+
+

data/lib/capistrano/tasks/docker.rake

@@ -0,0 +1,52 @@
+namespace :docker do
+    
+
+    desc "Prepares the container to store structured docker apps"
+    task :prepare do
+        on roles :host do
+            execute "mkdir -p #{fetch(:docker_buildpath)}"
+            execute "mkdir -p #{fetch(:docker_mountpath)}"
+        end
+    end
+    
+    desc "build an updated box, restart container"
+    task :build do
+        on roles :host do
+            execute "docker build --no-cache=true -t #{fetch(:docker_appname)}_img #{fetch(:docker_buildpath)}/"
+            execute "docker kill #{fetch(:docker_appname)}" rescue ""
+            execute "docker rm #{fetch(:docker_appname)}" rescue ""
+            execute build_run_command
+        end
+    end
+
+    def build_run_command()
+        cmd = "docker run "
+        fetch(:ports).each do |port,map|
+           cmd << "-p #{port}:#{map} "
+        end
+        fetch(:volumes).each do |name,vol|
+            execute "mkdir -p -m7777 #{fetch(:docker_mountpath)}/#{name}"
+            cmd << "-v `pwd`/#{fetch(:docker_mountpath)}/#{name}:#{vol}:rw "
+        end
+        cmd << "-name #{fetch(:docker_appname)} "
+        cmd << "-e APP_USER='#{fetch(:docker_appname)}' "
+        cmd << "-e APP_PASS='#{fetch(:password)}' "
+        cmd << "-e APP_DB='#{fetch(:docker_appname)}' "
+        cmd << "-d -t #{fetch(:docker_appname)}_img:latest "
+        cmd
+    end
+end
+
+namespace :load do
+
+    task :defaults do
+        
+        set  :docker_workpath,  ->   { "dockerappliance/containers/#{fetch(:namespace)}/#{fetch(:application)}" }         
+        set  :docker_buildpath, ->   { "#{fetch(:docker_workpath)}/config" }
+        set  :docker_mountpath, ->   { "#{fetch(:docker_workpath)}/mounts" }
+        set  :docker_appname,   ->   { "#{fetch(:namespace)}_#{fetch(:application)}" }
+        
+        
+    end
+
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-docker
+version: !ruby/object:Gem::Version
+  version: 0.0.01
+platform: ruby
+authors:
+- Ross Riley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Docker support for Capistrano 3.x
+email:
+- riley.ross@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- README.md
+- capistrano-docker.gemspec
+- lib/capistrano-docker.rb
+- lib/capistrano/docker.rb
+- lib/capistrano/tasks/deploy.rake
+- lib/capistrano/tasks/docker.rake
+homepage: https://github.com/rossriley/capistrano-docker
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: Docker support for Capistrano 3.x
+test_files: []