malkovich 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZGFkODJhNTU0NzQ5ZjJhOWRmNWJhZjAyM2MxZWMxYzUxMTgzNmI5NQ==
+  data.tar.gz: !binary |-
+    ZGRmYzIyZTM0ZGI0ZDYzNDQ0MTA4YjMyMzczZGNmNmQ0YjdiNzVjOA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZTE0NzZhMzc5YjViOTgwODRjYjk0NWM2NzI2ZTNhYmM5ODc1ZDQ4MDE4YmQz
+    MDhmZTE3NDgxYmMxODkwMDZkOTRlMDEzM2ZhYmUzZGFkNWJlMDNhMDhlMTNl
+    OTYwOWI2ZGI2MjIxN2I0YjJiZTZiNDkxODA3ZmViZTJjZjkwMTY=
+  data.tar.gz: !binary |-
+    Y2Y2NTUzYTdiNGVmOTI3NzU2Yzg1ODBiNzQ0MzhkNjAwNWZlMTM2M2IwM2Ji
+    M2Q3NWE4Y2FhMWJmMmRiY2U1OWVhMzBkOGQ4MmFjNmZkMWJjZWEzNDI1MjJj
+    ZTJlNzM4NjdlODk1ZGJmM2IyMGY3YzczZTY0MGFjNzI4ZTQyNzc=

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Steve Masterman
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,182 @@
+# Malkovich
+
+Makes it reasonably easy to develop and deploy Puppet modules using Capistrano. Also includes a convenience for Vagrant.
+
+This is a work in progress. Currently targets Ubuntu 12.04.
+
+## Installation
+
+In your `Capfile` add
+
+```rb
+require 'malkovich/capistrano'
+```
+
+## Vagrant
+
+Use a script provisioner to create the ubuntu user with your public key.
+
+Requires recent-ish version of Vagrant (e.g., 1.2.7).
+
+First, initialize a VM with Ubuntu Precise:
+
+```bash
+$ vagrant init precise32 http://files.vagrantup.com/precise32.box
+```
+
+Then create the shell provisioner script in `.vagrant/` with:
+
+```bash
+$ cap vagrant
+```
+
+The `vagrant` task by default assumes your ssh key is in `~/.ssh/id_rsa`.
+It will attempt to create a public key file at `~/.ssh/id_rsa.pub` if one doesn't already exist.
+The key filenames can be set with `private_key_filename` and `public_key_filename`.
+
+After the shell provisioner is written, inside the config block in your Vagrantfile add:
+
+```rb
+config.vm.provision :shell, :path => '.vagrant/shell_provisioner'
+```
+
+You might also set the network address for the VM so you can define the server in `Capfile`, for example:
+
+```rb
+config.vm.network :private_network, ip: "192.168.101.101"
+```
+
+Otherwise you can get it later from inside the VM using `ifconfig`.
+
+Finally, boot up your Vagrant VM for the first time:
+
+```bash
+$ vagrant up
+```
+
+At this point, you may wish to run the `bootstrap`, described below.
+
+## Stages
+
+For each stage, define a Capistrano task where you set a vaule for `:stage` and other values:
+
+```rb
+task :qa do
+  set :stage, 'qa'
+  server 'qa.myapp.com', :app, :db
+end
+```
+
+You can make a stage for your Vagrant VM:
+
+```rb
+task :dev do
+  set :stage, 'dev'
+  server '192.168.101.101', :app
+end
+```
+
+Then invoke a stage task on the Capistrano command line before any primary task, e.g.:
+
+```bash
+
+$ cap dev bootstrap
+```
+
+## Bootstrap
+
+A bootstrap Capistrano task is provided to prepare a base image with installed Puppet. This is for Ubuntu 12.04 precise.
+
+One approach is to run bootstrap once on a clean image, and then create a new EC2 image or Vagrant box from that.
+Then destroy the running machine and change your Vagrantfile to use the new image, also removing the shell provisioner.
+
+Now you can use this new image as a starting point for Puppet module development.
+
+## Puppet tasks
+
+For every `.pp` file in `puppet/manifests` a Capistrano task will be created in the `puppet` namespace.
+E.g., `puppet/manifests/web.pp` will result in the task `puppet:web` that can be run on stages.
+When `puppet:web` is run it will upload `puppet/` to the servers with the `:web` role and use `puppet apply` to apply the `web` manifest.
+
+This assumes `puppet/modules` is the path to the modules the manifest includes.
+
+## Facts
+
+Specifying a stage, a server and a role is enough to let you run your puppet manifests on your server, but in many cases it is useful to make arbitrary dynamic values available to your puppet modules when they run on the server.
+The `fact` method makes this easy. For example,
+
+```rb
+task :qa do
+  set :stage, 'qa'
+  server 'qa.myapp.com', :app, :db
+  fact :hostname, 'qa.myapp.com'
+end
+```
+
+will make a `$hostname` variable available in your puppet manifests. This is achieved with Facter environment variables.
+
+## Required values
+
+You must define at least one stage for most tasks, except for example `vagrant`.
+
+## Default values
+
+Some default Capistrano values are set such as user. See defaults.rb for more.
+Set your own values in `Capfile`.
+These work with the Vagrant shell provisioner and Canonical EC2 images.
+
+## Capistrano tasks
+
+There are some other tasks such as `uptime` and `upgrade`. View them all with:
+
+```bash
+$ cap -T
+```
+
+## Example
+
+* Capfile
+
+```rb
+load 'deploy'
+require 'malkovich/capistrano'
+
+task :qa do
+  set :stage, 'qa'
+  server 'qa.myapp.com', :web
+  fact :hostname, 'qa.myapp.com'
+end
+```
+
+* puppet/manifests/web.pp
+
+```puppet
+include nginx
+```
+
+* puppet/modules/nginx/manifests/init.pp
+
+```puppet
+class nginx {
+  file {
+    "/etc/nginx/nginx.conf":
+      content => template('nginx/nginx.conf.erb')
+  }
+}
+```
+
+* puppet/modules/nginx/templates/nginx.conf.erb
+
+```puppet
+http {
+  server {
+    server_name <%= @hostname %>; #Puppet facts become Ruby instance variables in ERB
+  }
+}
+```
+
+* Apply the manifest
+
+```bash
+$ cap qa puppet:web
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/malkovich/capistrano/defaults.rb

@@ -0,0 +1,31 @@
+Capistrano::Configuration.instance.load do
+  _cset(:stage) { abort "please specify stage" }
+
+  set :application, 'application'
+  set :user, 'ubuntu'
+  set :use_sudo, false
+  set(:deploy_to) { "/home/#{user}" }
+
+  set(:facter_vars) { "" }
+
+  default_run_options[:pty]     = true
+  ssh_options[:forward_agent]   = true
+
+  set :private_key_filename, "#{ENV['HOME']}/.ssh/id_rsa"
+  set :public_key_filename, "#{ENV['HOME']}/.ssh/id_rsa.pub"
+
+  set :apt_get_cmd, %|DEBIAN_FRONTEND=noninteractive apt-get -o Dpkg::Options::="--force-confnew" --force-yes --fix-broken --yes|
+
+  set :essential_packages, "build-essential openssl libreadline6 libreadline6-dev curl
+                              git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev
+                              sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev ncurses-dev
+                              automake libtool bison"
+
+  set :bonus_packages, "vim tmux ack-grep"
+
+  set :puppet_packages, "puppet ruby1.8 libopenssl-ruby ruby rubygems"
+
+  set :packages, [essential_packages.squeeze, bonus_packages, puppet_packages].join(" ")
+
+  set :puppet_opts, '--verbose --modulepath=modules'
+end

data/lib/malkovich/capistrano/fact.rb

@@ -0,0 +1,14 @@
+Capistrano::Configuration.class_eval do
+  def _facts
+    @_facts ||= {}
+  end
+
+  def fact(k, v)
+    _facts[k] = v
+  end
+
+  def _facter_envs
+    _facts.each_pair.map{|k, v| "FACTER_#{k.to_s.upcase}=#{v}"}.join ' '
+  end
+end
+

data/lib/malkovich/capistrano/puppet.rb

@@ -0,0 +1,11 @@
+Capistrano::Configuration.instance.load do
+  namespace :puppet do
+    Dir['puppet/manifests/*'].map{|s| s.split('/').last.split('.').first.to_sym}.each do |manifest|
+      desc "apply #{manifest} manifest to server with #{manifest} role"
+      task manifest, :roles => manifest do
+        upload "puppet", deploy_to, :via => :scp, :recursive => true
+        run "cd #{deploy_to}/puppet && sudo #{_facter_envs} puppet apply #{puppet_opts} manifests/#{manifest}.pp"
+      end
+    end
+  end
+end

data/lib/malkovich/capistrano/tasks.rb

@@ -0,0 +1,59 @@
+Capistrano::Configuration.instance.load do
+
+  desc 'Generate .vagrant/shell_provisioner with your publick_key'
+  task :vagrant do
+    dirname = '.vagrant'
+    filename = "#{dirname}/shell_provisioner"
+
+    abort("#{filename} already exists.") if File.exists? filename
+
+    unless File.exists? public_key_filename
+      puts "SSH public key #{public_key_filename} does not exist."
+      puts "Extracting from #{private_key_filename}..."
+      pub = `ssh-keygen -y -f #{private_key_filename}`
+      abort("Cancelled.") unless $? == 0
+      File.open(public_key_filename, 'a') {|f| f.write pub}
+    end
+    sh = <<-SH
+      adduser #{user} --gecos #{user} --disabled-password
+      adduser #{user} admin
+      mkdir ~#{user}/.ssh
+      echo "#{File.open(public_key_filename).read}" >> ~#{user}/.ssh/authorized_keys
+      chown #{user}.#{user} ~#{user}/.ssh/authorized_keys
+      chmod 600 ~#{user}/.ssh/authorized_keys
+    SH
+
+    puts "\nCreating #{filename}"
+    Dir.mkdir dirname unless File.exist? dirname
+    File.open(filename, 'w') do |f|
+        f.write sh
+    end
+    puts "\nAdd the following line to Vagrantfile:\nconfig.vm.provision :shell, :path => '.vagrant/shell_provisioner'"
+  end
+
+  task :uptime do
+      run "uptime"
+  end
+
+  desc "Upgrade packages and install puppet and build essentials"
+  task :bootstrap do
+    cmd = <<-SH
+  echo 'deb http://apt.puppetlabs.com precise main dependencies' | sudo tee /etc/apt/sources.list.d/puppetlabs.list;
+  sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 4BD6EC30;
+  sudo #{apt_get_cmd} update;
+  sudo #{apt_get_cmd} upgrade;
+  sudo #{apt_get_cmd} install #{packages};
+  sudo gem install bundler --no-ri --no-rdoc
+  SH
+    run cmd
+  end
+
+  desc "Upgrade packages"
+  task :upgrade do
+    cmd = <<-SH
+  sudo #{apt_get_cmd} update;
+  sudo #{apt_get_cmd} upgrade;
+  SH
+    run cmd
+  end
+end

data/lib/malkovich/capistrano/version.rb

@@ -0,0 +1,5 @@
+module Malkovich
+  module Capistrano
+    VERSION = "0.0.1"
+  end
+end

data/lib/malkovich/capistrano.rb

@@ -0,0 +1,9 @@
+require 'capistrano'
+require 'malkovich/capistrano/version'
+require 'malkovich/capistrano/puppet'
+
+if Capistrano::Configuration.instance
+  require 'malkovich/capistrano/defaults'
+  require 'malkovich/capistrano/fact'
+  require 'malkovich/capistrano/tasks'
+end

data/malkovich.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'malkovich/capistrano/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "malkovich"
+  spec.version       = Malkovich::Capistrano::VERSION
+  spec.authors       = ["Steve Masterman"]
+  spec.email         = ["steve@vermonster.com"]
+  spec.description   = %q{Capistrano tasks and settings for Puppet, Vagrant/EC2, Ubuntu}
+  spec.summary   = %q{Capistrano tasks and settings for Puppet, Vagrant/EC2, Ubuntu}
+
+  spec.homepage      = "https://github.com/vermonster/malkovich"
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency "capistrano"
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: malkovich
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Steve Masterman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-16 00:00:00.000000000 Z
+dependencies:
+- !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'
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Capistrano tasks and settings for Puppet, Vagrant/EC2, Ubuntu
+email:
+- steve@vermonster.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/malkovich/capistrano.rb
+- lib/malkovich/capistrano/defaults.rb
+- lib/malkovich/capistrano/fact.rb
+- lib/malkovich/capistrano/puppet.rb
+- lib/malkovich/capistrano/tasks.rb
+- lib/malkovich/capistrano/version.rb
+- malkovich.gemspec
+homepage: https://github.com/vermonster/malkovich
+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.0.6
+signing_key: 
+specification_version: 4
+summary: Capistrano tasks and settings for Puppet, Vagrant/EC2, Ubuntu
+test_files: []