esxmagicwand 0.1.0

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 sgirones
+
+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.rdoc

@@ -0,0 +1,41 @@
+= EsxMagicWand
+
+EsxMagicWand deploy VMs on ESXi hypervisors and starts a PXE installation
+
+== Installation
+
+  $ gem install esxmagicwand
+
+== Example
+
+* Create a VM conf as following. Replace example values. File centos6_1.conf:
+
+    [dhcp-server]
+    ip=DHCP_SERVER_IP
+    port=7911
+    
+    [esx-server]
+    ip=ESX_SERVER_IP
+    user=root
+    password=ROOT_PASSWORD
+    datastore=datastore1
+    
+    [vm]
+    name=CentOS6
+    size=20000
+    cpu=1
+    memory=3000
+    os_type=centos64Guest
+    
+    lease_name=centos6_test1
+    ip=192.168.20.2
+    mask=255.255.255.0
+    pxe_path=centos6/pxelinux.0
+  
+* Deploy
+  
+    $ deploy_vm centos6_1.conf
+  
+* Undeploy
+
+    $ undeploy_vm centos6_1.conf

data/bin/deploy_vm

@@ -0,0 +1,69 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'esx'
+require 'esxmagicwand'
+require 'clamp'
+require 'parseconfig'
+
+class BaseCommand < Clamp::Command
+    parameter "CONFIG_PATH", "Config file path"
+
+    def execute
+        c = ParseConfig.new(config_path)
+
+        begin
+
+            #Prepare MagicWand
+            puts 'Prepare MagicWand'
+            dhcp_host = DHCP::Server.new(c.params['dhcp-server']['ip'], c.params['dhcp-server']['port'])
+            esx_host = ESX::Host.connect(c.params['esx-server']['ip'], c.params['esx-server']['user'], c.params['esx-server']['password'])
+            magic_wand = VMWizard::MagicWand.new(esx_host, dhcp_host)
+
+            #Prepare VM definition
+            puts 'Prepare VM definition'
+            vm = VMWizard::VirtualMachine.new(
+                        :name => c.params['vm']['name'],
+                        :disk_size => c.params['vm']['size'],
+                        :cpu => c.params['vm']['cpu'],
+                        :ram => c.params['vm']['memory'],
+                        :disk_type => c.params['vm']['disk_type'],
+                        :guest => c.params['vm']['os_type']
+            )
+            datastore = c.params['esx-server']['datastore']
+
+            #Deploy VM
+            puts 'Start deployment'
+            deployed_vm = magic_wand.deploy(vm, datastore)
+
+            puts 'Powering ON'
+            deployed_vm.power_on
+
+            mac = ''
+            #Recover mac address
+            Net::SSH.start(c.params['esx-server']['ip'], c.params['esx-server']['user'], :password => c.params['esx-server']['password']) do |ssh|
+                mac = ssh.exec!("grep \"ethernet0.generatedAddress \" \"/vmfs/volumes/#{datastore}/#{vm.name}/#{vm.name}.vmx\"|cut -f3 -d\" \"").gsub('"','')
+            end
+
+            #Prepare lease definition
+            lease = DHCP::Lease.new(
+                            :name => c.params['vm']['lease_name'],
+                            :ip => c.params['vm']['ip'],
+                            :mask => c.params['vm']['mask'],
+                            :mac => mac,
+                            :pxe_path => c.params['vm']['pxe_path'],
+                            :hostname => c.params['vm']['hostname']
+            )
+
+            puts "Adding DHCP lease"
+            dhcp_host.del_lease lease
+            dhcp_host.add_lease lease
+
+        rescue Exception => e
+            puts e.message
+            exit 1
+        end
+    end
+end
+
+BaseCommand.run

data/bin/undeploy_vm

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'esx'
+require 'esxmagicwand'
+require 'clamp'
+require 'parseconfig'
+
+class BaseCommand < Clamp::Command
+    parameter "CONFIG_PATH", "Config file path"
+
+    def execute
+        c = ParseConfig.new(config_path)
+
+        begin
+            #Prepare MagicWand
+            puts 'Prepare MagicWand'
+            dhcp_host = DHCP::Server.new(c.params['dhcp-server']['ip'], c.params['dhcp-server']['port'])
+            esx_host = ESX::Host.connect(c.params['esx-server']['ip'], c.params['esx-server']['user'], c.params['esx-server']['password'])
+            magic_wand = VMWizard::MagicWand.new(esx_host, dhcp_host)
+
+            puts 'Start undeploy'
+            magic_wand.undeploy(c.params['vm']['name'])
+
+            #Prepare lease definition
+            lease = DHCP::Lease.new(
+                            :name => c.params['vm']['lease_name'],
+                            :ip => c.params['vm']['ip'],
+                            :mask => c.params['vm']['mask']
+            )
+
+            puts "Removing DHCP lease"
+            dhcp_host.del_lease lease
+
+
+        rescue Exception => e
+            puts e.message
+            exit 1
+        end
+    end
+end
+
+BaseCommand.run

data/lib/dhcp.rb

@@ -0,0 +1,80 @@
+module DHCP
+
+    class Server
+        attr_reader :address, :port
+
+        def initialize(address, port)
+            @address = address
+            @port = port
+        end
+
+        def add_lease(lease)
+            File.open('/tmp/add_pxe_lease','w') do |file|
+                file.puts "server #{@address}"
+                file.puts "server #{@port}"
+                file.puts "connect"
+                file.puts "new host"
+                file.puts "set name = \"#{lease.name}\""
+                file.puts "set hardware-address = #{lease.mac}"
+                file.puts "set hardware-type = 1"
+                file.puts "set ip-address = #{lease.ip}"
+                file.puts "set statements = \"#{lease.statements_string}\""
+                file.puts "create"
+            end
+
+            #execute!
+            `cat /tmp/add_pxe_lease | omshell`
+            `rm /tmp/add_pxe_lease`
+        end
+
+        def del_lease(lease)
+            File.open('/tmp/del_pxe_lease','w') do |file|
+                file.puts "server #{address}"
+                file.puts "server #{port}"
+                file.puts "connect"
+                file.puts "new host"
+                file.puts "set name = \"#{lease.name}\""
+                file.puts "open"
+                file.puts "remove"
+            end
+
+            #execute!
+            `cat /tmp/del_pxe_lease | omshell`
+            `rm /tmp/del_pxe_lease`
+        end
+    end
+
+    class Lease
+        attr_reader :name, :ip, :mask , :mac, :pxe_path, :hostname
+
+        def initialize(definition)
+            @name = definition[:name]
+            @ip = definition[:ip]
+            @mask = definition[:mask]
+            @mac = definition[:mac]
+            @pxe_path = definition[:pxe_path] if definition.include? :pxe_path
+            @hostname = definition[:hostname] if definition.include? :hostname
+        end
+
+        def statements_string
+            out = "option subnet-mask = #{ip2hex(@mask)};"
+            if @pxe_path
+                out += " filename = \\\"#{@pxe_path}\\\";"
+            end
+            if @hostname
+                out += " host-name = \\\"#{@hostname}\\\";"
+            end
+            return out
+        end
+
+        def ip2hex ip
+          ip.split(".").map{|i| "%02x" % i }.join(":")
+        end
+    end
+
+end
+
+
+
+
+

data/lib/esxmagicwand.rb

@@ -0,0 +1,61 @@
+require File.join(File.dirname(__FILE__), 'dhcp.rb')
+
+module VMWizard
+
+    class VirtualMachine
+        attr_reader :name, :disk_size, :cpu, :ram, :disk_type, :guest, :mac
+
+        def initialize(specs)
+            @name = specs[:name]
+            @disk_size = specs[:disk_size]
+            @cpu = specs[:cpu]
+            @ram = specs[:ram]
+            @mac = specs[:mac]
+            @disk_type = specs[:disk_type]
+            @guest = specs[:guest]
+        end
+    end
+
+    class MagicWand
+        attr_reader :esx_host, :dhcp_host
+
+        def initialize(esx_host, dhcp_host)
+            @esx_host = esx_host
+            @dhcp_host = dhcp_host
+        end
+
+        def deploy(vm, datastore)
+            vm = @esx_host.create_vm(
+                        :vm_name => vm.name, 
+                        :datastore => datastore,
+                        :disk_type => :thin,
+                        :disk_size => vm.disk_size,
+                        :memory => vm.ram,
+                        :guest_id => vm.guest
+                    )
+
+            return vm
+        end
+
+        def undeploy(vm_name)
+            vm = nil
+            esx_host.virtual_machines.each do |x|
+                if x.name == vm_name
+                    vm = x
+                    break
+                end
+            end
+
+            if not vm
+                raise "VM with name #{vm_name} not found"
+            end
+
+            if vm.power_state == "poweredOn"
+                vm.power_off
+            end
+
+            vm.destroy
+
+        end
+    end
+end

metadata

@@ -0,0 +1,217 @@
+--- !ruby/object:Gem::Specification 
+name: esxmagicwand
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- sgirones
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-12-29 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id001
+  name: shoulda
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  version_requirements: *id002
+  name: bundler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  version_requirements: *id003
+  name: jeweler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id004
+  name: rcov
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id005
+  name: rdoc
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 2
+        - 2
+        version: 0.2.2
+  version_requirements: *id006
+  name: esx
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id007
+  name: clamp
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id008
+  name: parseconfig
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id009
+  name: esx
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id010
+  name: parseconfig
+  prerelease: false
+  type: :runtime
+description: VM deploy on ESX using PXE as install method. Add dynamic leases to DHCP server through OMAPI
+email: salvador.girones@abiquo.com
+executables: 
+- deploy_vm
+- undeploy_vm
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- lib/dhcp.rb
+- lib/esxmagicwand.rb
+- LICENSE.txt
+- README.rdoc
+- bin/deploy_vm
+- bin/undeploy_vm
+homepage: http://github.com/sgirones/esxmagicwand
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: VM deploy on ESX using PXE
+test_files: []
+