pauper 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: af5126775307e89900badb113cdc5e1425799250
-  data.tar.gz: 7e99fd016fbdfb32a35040061af5a07667b47fb3
+  metadata.gz: 3f0dab255dae6b6196868eea8e2016270e5ea73f
+  data.tar.gz: cfa3ea39f81b96138e5e9a88a74c0c68828ad0ff
 SHA512:
-  metadata.gz: 58bb795aa47da08f4dcd3f1fc64c74058414009a9a48e668621ee40f883f9973f7ef96e80f228b654197cb48552ea9282d1fe36781eefc324fac80838d35629b
-  data.tar.gz: d8b8d0b344870bdec4798b38bab5ae18dc6781bff2de109498a8d6ce37615e010d06dcd6eb78915a881633a04f4ae3c6ce50e6870deee9e94d9b37037c820749
+  metadata.gz: 812e2334e9c6175ea488e9591d17d41ae5fc3878ab296ce460dab41569be2cbdbac973b001f16dc22a0e769cf155edf53b5c0fbbae059f6e10d36b08281e1e8e
+  data.tar.gz: 381672d09740e94c5efe17e6eb3da403040aece3acc5456b6ea24e054711564f2c9f3699d70d5b7c4c83062ee478bf8eb08f5da423e3afc8f99ef59e15d98afb

data/README.md

@@ -1 +1,102 @@
 See https://fastly.atlassian.net/wiki/display/DOC/DeveloperSetupMac
+
+WHAT AM I
+-------------------------------------------------------------------------------
+Pauper is suppose to setup lxc's defined in a Pauperfile.
+We use this to build out dev environment.
+In the beginning it was created by fastly because the alternatives available
+where not filling our needs.
+
+Base Commands
+-------------------------------------------------------------------------------
+```bash
+pauper bootstrap [lucid|precise]  # Initialize the base image
+pauper create [NODENAME]          # Create a VM
+pauper destroy [NODENAME]         # Completely destroy a VM
+pauper halt                       # Stop all nodes on your vm from local!
+pauper help [COMMAND]             # Describe available commands or one specific command
+pauper reload                     # Basically an up then a halt...
+pauper resume [NODENAME]          # Resume a VM
+pauper setup [NODENAME]           # Refresh configs and run Chef on a VM
+pauper setup_osx [VMNAME]         # Set up things for OS X
+pauper start [NODENAME]           # Start a VM
+pauper stop [NODENAME]            # Stop a VM
+pauper suspend [NODENAME]         # Suspends a VM
+pauper up                         # Start all nodes on your vm from local!
+pauper write_hosts                # Write out a new /etc/hosts file
+pauper vm SUBCOMMAND              # Operations dealing with VMware Fusion
+
+Options:
+[--pauperfile=PAUPERFILE]         # defults to ./Pauperfile
+```
+
+VM Sub Commands
+-------------------------------------------------------------------------------
+This attempts to manage an OSX VMware Fusion VM instance headlessly.
+Please run `pauper vm setup` before asking for help when it does not work...
+
+The vm subcommand really only works for OSX users running VMWare Fusion.
+It relies entirely on VMWares vm-run scripts
+
+__!!IMPORTANT!!__ pauper vm setup should rid of most of the prompts and other
+things that are not need for headless vm operation but as a precaution you
+should `stop/start` using the GUI at least once and check all __"never show
+this to me again"__ boxes just to be safe.
+
+```bash
+Commands:
+pauper vm help [COMMAND]  # Describe subcommands or one specific subcommand
+pauper vm list            # List running fusion VMs
+pauper vm pause           # Pause given fusion VM
+pauper vm reset           # Reset given fusion VM
+pauper vm setup           # Setup your pauper vm experience
+pauper vm start           # Starts your fusion VM
+pauper vm stop            # Stop given fusion VM
+pauper vm suspend         # Suspend given fusion VM
+pauper vm unpause         # Unpause given fusion VM
+pauper vm vmruner         # A tube straight to the vmrun command...
+
+Options:
+[--vmpath=VMPATH]         # Defaults to "/Applications/VMware Fusion.app/Contents/Library/vmrun"
+[--vmrunpath=VMRUNPATH]   # Defaults to "#{ENV['HOME']}/Documents/Virtual Machines*/*.vmwarevm"
+```
+
+GPG
+-------------------------------------------------------------------------------
+We use GPG for key generation. It needs some amount of entropy to do its thing
+with any amount of haste. On a new VM there is very little entropy and very
+little happening that will generate entropy...
+
+If you notice that `pauper bootstrap` is hanging for a long time on a call
+involving gpg, attempt this on your VM:
+```bash
+sudo apt-get install haveged
+haveged
+```
+haveged generates the needed entropy for you and should slove this issue. Feel
+free to `kill` haveged when you are done (it will run forever, hiding in the
+background if you do not :P )
+
+
+TIPS
+--------------------------------------------------------------------------------
+Are things not working for you right now?
+Try this (probably overkill) way to fix things!
+
+First try running `./start.sh` from the pauper-env directory.
+
+If this script does not exist you may have to pull master or if you
+would prefer to do it the hard way...
+
+OSX users:
+1. SSH into your VM
+2. `cd` into your `pauper-env` directory
+3. `pauper stop`
+4. `pauper start`
+5. `pauper write_hosts`
+6. `sudo iptables -F`
+7. Return to your OSX cmd-line
+8. `cd` into your `pauper-env` directory
+9. `pauper setup_osx`
+
+This will hopefully get you into a happy state... Hopefully...

data/lib/pauper.rb

@@ -183,11 +183,12 @@ class Pauper
       bootstrap(release)
     end
 
-    puts "Cloning #{base_name}..."
-    clone_base(base_name, node_name)
     mac = generate_mac
     ip = "#{@pauper_config.config[:subnet]}.#{node_config.config[:last_octet]}"
 
+    puts "Cloning #{base_name}..."
+    clone_base(base_name, node_name, ip)
+
     lxc = LXC.new(node_name)
     lxc.interface = @pauper_config.config[:bridge]
     lxc.mac = mac
@@ -265,7 +266,7 @@ EOF
     end
 
     if vm_exists?(node_name)
-      stop_node(node_name)
+      stop(node_name)
 
       chef_node = "#{node_name}#{@pauper_config.config[:node_suffix]}"
       puts "Removing #{node_name} from Chef..."
@@ -561,11 +562,16 @@ EOF
     `sudo lxc-info -n '#{node_name}'`.include?("FROZEN")
   end
 
-  def clone_base(base_name, node_name)
+  def clone_base(base_name, node_name, ip)
     cmd "sudo cp -ax #{DEFAULT_VM_PATH}/#{base_name} #{DEFAULT_VM_PATH}/#{node_name}"
     cmd "sudo rm -f #{DEFAULT_VM_PATH}/#{node_name}/rootfs/etc/chef/client.pem"
     cmd "sudo rm -f #{DEFAULT_VM_PATH}/#{node_name}/rootfs/etc/ssh/ssh*key*"
     cmd "sudo sed -i \"s/#{base_name}/#{node_name}/g\" /var/lib/lxc/#{node_name}/rootfs/etc/hostname /var/lib/lxc/#{node_name}/rootfs/etc/chef/client.rb"
+    # The chef run in the base wrote base's IP into /etc/hosts.  Once we run chef
+    # in the copied lxc, its /etc/hosts will be rewritten.  However, we need
+    # the node's hostname in /etc/hosts in the copy before we run chef in it,
+    # so that sudo lets us put files for chef in place and chef can run.
+    cmd "sudo sh -c 'echo #{ip} #{node_name} >> #{DEFAULT_VM_PATH}/#{node_name}/rootfs/etc/hosts'"
   end
 
   def vm_config(node_name)

data/lib/pauper/version.rb

@@ -1,3 +1,3 @@
 class Pauper
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pauper
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Tyler McMullen
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-27 00:00:00.000000000 Z
+date: 2014-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -116,3 +116,4 @@ summary: A semi-sane way to manage a multi-vm dev environment
 test_files:
 - test/pauper_test.rb
 - test/test_helper.rb
+has_rdoc: