knife-topo 0.0.3 → 0.0.4

data/README.md

@@ -1,9 +1,13 @@
 knife topo
 ==========
 
-This Chef Knife plugin is provided by ThirdWave Insights LLC. 
-It allows you to use knife to create and update topologies consisting of 
-multiple nodes.  
+This Chef Knife plugin allows you to create and update topologies 
+consisting of multiple nodes. You may find it useful if you are 
+regularly updating a system consisting of multiple nodes, and would
+like to manage its dynamic configuration (like software versions) 
+through a single (json) configuration file. It may also be useful
+if you are regularly bringing up multi-node systems with similar 
+topologies but differences in their configuration details.
 
 # Installation #
 
@@ -20,7 +24,7 @@ This plugin has been tested with Chef Version 11.12 on Ubuntu 14.04 LTS.
 
 # Usage #
 
-Define one or more *topologies* in a [*topology file*](#markdown-header-topology-file). 
+Define one or more topologies in a [topology file](#markdown-header-topology-file). 
 
 Import the topology file into your local chef repo using
 [knife topo import](#markdown-header-knife-topo-import). Create and optionally
@@ -30,14 +34,15 @@ using [knife topo update](#markdown-header-knife-topo-update).
 
 # Getting Started #
 
-Try out this plugin using a [test repo](knife-topo/src/master/test-repo) which you can
-download from Github or is included in the installed gem. See the 
-[Instructions](knife-topo/src/master/test-repo/Instructions.txt) for how to use the test repo.
+Try out this plugin using a [test repo](knife-topo/src/master/test-repo) 
+which you can download from Github or is included in the installed gem. See the 
+[Instructions](knife-topo/src/master/test-repo/Instructions.md) for a
+demo script, explanation, and troubleshooting.
 
 The instructions assume you have
  [chefDK](http://www.getchef.com/downloads/chef-dk/)
  or equivalent installed and working with Vagrant and VirtualBox, but
- chefDK is not a requirement for this plugin. 
+ none of these are requirements for this plugin. 
 
 # Topology File #
 
@@ -72,17 +77,7 @@ The `name` is how you will refer to the topology in the
 The `chef-environment` and `normal` attributes defined
 here will be applied to all nodes in the topology, unless alternative
 values are provided for a specific node.  The `tags` 
-will be added to each node. The normal attributes may either be 
-specified using the dot notation, as shown above, or may be expanded as
-a JSON structure, i.e., the above is equivalent to:
-```json
-    {
-        "normal": {
-            "topo": {
-              "blueprint": "blah"
-            }
-        }
-    }
+will be added to each node. 
     
 ## Node List
 Each topology contains a list of `nodes`.
@@ -94,8 +89,8 @@ Each topology contains a list of `nodes`.
         "nodes": {
             "buildserver": {
                 "name": "buildserver01",
-                "ssh_host": "127.0.0.1",
-                "ssh_port": "8241",
+                "ssh_host": "192.168.1.201",
+                "ssh_port": "2224",
                 "chef_environment": "dev",
                 "run_list": ["role[base-ubuntu]", "ypo::db", "recipe[ypo::appserver]"],
                 "normal": {
@@ -121,8 +116,63 @@ bootstrap a node.
 
 ## Topology Cookbook Attributes
 
+Each topology may have attributes that are set via
+an attribute file in a topology-specific cookbook. Each
+attribute file is described in an entry in the 'cookbook_attributes'
+array.
+
+```json
+	"cookbook_attributes": [
+		{
+			"cookbook": "testsys_test1",
+			"filename": "softwareversion",
+			"normal": 
+			{			
+				"nodejs": 
+				{
+					"version": "0.28"
+				},
+
+				"testapp": 
+				{
+					"version": "0.0.3"
+				},
+
+				"mongodb": 
+				{
+					"package_version": "2.6.1"
+				}
+			},
+			"conditional" : [
+				{
+					"qualifier": "node_type",
+					"value" : "buildserver",
+					"normal": 
+					{
+						"mongodb": 
+						{
+							"package_version": "2.5.1"
+						}
+					}
+				}
+			]
+		}
+	]
+```
+
+Attributes listed directly under an attribute priority (e.g. 'normal'
+in the above) will generate an entry in the attribute file such as:
 
+  normal['mongodb'][package_version] = "2.6.1"
+  
+Attributes listed under the `conditional` property will generate an 
+entry in the attribute file such as:
 
+```ruby
+  if (node['topo']['node_type'] == "buildserver")
+    normal['mongodb'][package_version] = "2.5.1"
+  end
+```
 
 # Subcommands #
 
@@ -185,12 +235,42 @@ user name of vagrant, password of vagrant, and running using sudo.
 Generates the topology cookbook attribute files and attributes described in the 
 'cookbook_attributes' property.
 
+### Options:
+
+The knife topo cookbook create subcommand supports the following additional options.
+
+Option        | Description
+------------  | -----------
+See [knife cookbook create](http://docs.opscode.com/chef/knife.html#cookbook)  |  
+
+### Examples:
+The following will generate the topology cookbook attribute files for
+topology test1.
+
+	$ knife topo cookbook create test1
+
+## knife topo cookbook upload 
+
+	knife topo cookbook upload TOPOLOGY
+
+Uploads the topology cookbook attribute files.
+
+### Options:
+
+The knife topo cookbook upload subcommand supports the following additional options.
+
+Option        | Description
+------------  | -----------
+See [knife cookbook upload](http://docs.opscode.com/chef/knife.html#cookbook)  | 
+
+
 ### Examples:
 The following will generate the topology cookbook attribute files for
 topology test1.
 
 	$ knife topo cookbook create test1
 	
+  
 ## knife topo create 
 
 	knife topo create TOPOLOGY

data/lib/chef/knife/topo/version.rb

@@ -1,5 +1,5 @@
 module Knife
   module Topo
-    VERSION = "0.0.3"
+    VERSION = "0.0.4"
   end
 end

data/lib/chef/knife/topo_bootstrap.rb

@@ -79,7 +79,7 @@ class Chef
             end
 
           end
-          ui.info "Successfully bootstrapped #{nodes.length - (@failed.length + skipped)} nodes and skipped #{skipped} nodes of #{nodes.length} in topology #{@bag_name}/#{@topo_name}"
+          ui.info "Bootstrapped #{nodes.length - (@failed.length + skipped)} nodes and skipped #{skipped} nodes of #{nodes.length} in topology #{@bag_name}/#{@topo_name}"
           ui.warn "#{@failed.length} nodes [ #{@failed.join(', ')} ] failed to bootstrap" if @failed.length > 0
         else
           ui.info "No nodes found for topology #{@topo_name}"

data/lib/chef/knife/topo_cookbook_create.rb

@@ -150,23 +150,21 @@ class Chef
           end
           
           # Print out qualified attributes
-          def print_qualified_attr(file, qualifier, qualifier_hash)
-            qualifier_hash.each do |qualifier_value, qualified_attrs|
-              file.puts "if node['topo']['#{qualifier}'] == \"#{qualifier_value}\""
-              print_priority_attrs(file, qualified_attrs, 2)
-              file.puts "end"
-            end
+          def print_qualified_attr(file, qualifier_hash)
+            file.puts "if node['topo']['#{qualifier_hash['qualifier']}'] == \"#{qualifier_hash['value']}\""
+            print_priority_attrs(file, qualifier_hash, 2)
+            file.puts "end"
           end
           
           # Process the attributes not needing qualification
           print_priority_attrs(file, attrs)
           file.puts
           
-          # Process attributes that need to be qualified (must appear after the above in cookbook)
-          %w(node_type).each do |qualifier|
-            if attrs[qualifier]
-              file.puts "# Attributes for specific #{qualifier}"
-              print_qualified_attr(file, qualifier, attrs[qualifier])
+          # Process attributes that need to be qualified
+          if attrs['conditional']
+            attrs['conditional'].each do |qualified_attrs|
+              file.puts "# Attributes for specific #{qualified_attrs['qualifier']}"
+              print_qualified_attr(file, qualified_attrs)
             end
           end        
           

data/lib/chef/knife/topo_create.rb

@@ -85,6 +85,7 @@ class Chef
          rescue Net::HTTPServerException => e
           raise unless e.to_s =~ /^409/
           ui.confirm("Topology already exists - do you want to re-create it", true, false)
+          topo.save
         end
 
         # make sure env and cookbooks are in place

data/lib/chef/knife/topo_export.rb

@@ -101,30 +101,32 @@ class Chef
 
       # get actual node properties for export
       def node_export (node_name)
+
+        node_data = {}
+
         begin
-          node = Chef::Node.load(node_name).to_hash
+          node = Chef::Node.load(node_name)
+          
+          node_data['name'] = node.name
+          node_data['tags'] = node.tags
+          node_data['chef_environment'] = node.chef_environment
+          node_data['normal'] = node.normal
+          node_data['run_list'] = node.run_list
+          
         rescue Net::HTTPServerException => e
           raise unless e.to_s =~ /^404/
           node = empty_node(node_name)
         end
-        props = %w{name chef_environment normal run_list recipes}
-        node_data = {}
-
-        props.each do |prop|
-          node_data[prop] = node[prop] if node.has_key?(prop)
-        end
         
-        node_data[tags] = node_data[normal][tags]
-
         node_data
       end
 
       # merge hash properties with the actual node properties
       def merge_node_properties!(nodes, node_name)
         # find out if the node is already in the array
-        node = nodes.find{|n| n["name"] == node_name }
-        if node
-          node.merge!(node_export(node_name))
+        found = nodes.index{|n| n["name"] == node_name }
+        if found
+          nodes[found] = node_export(node_name)
         else
           nodes.push(node_export(node_name))
         end

data/lib/chef/knife/topology_helper.rb

@@ -81,22 +81,37 @@ class Chef
 
         chef_env
       end
+      
+      # recursive merge that retains all keys
+      def prop_merge!(hash, other_hash)
+        other_hash.each do |key, val|
+          if val.kind_of?(Hash) && hash[key]
+            prop_merge!(hash[key], val)
+          else
+            hash[key] = val
+          end
+        end
+        
+        hash
+      end   
 
       # Merges topology properties into nodes, returning the merged nodes
       def merge_topo_properties(nodes, topo_hash)
 
-        if nodes
-          merged_nodes = nodes.clone
+        if nodes && nodes.length > 0
+          merged_nodes = nodes ? nodes.clone : {}
           merged_nodes.each do |nodeprops|
 
+            normal_defaults = topo_hash['normal'] ? topo_hash['normal'].clone : {}
+            nodeprops['normal'] ||= {}
+            nodeprops['normal'] = prop_merge!(normal_defaults, nodeprops['normal'])
+
             nodeprops['chef_environment'] ||=  topo_hash['chef_environment'] if topo_hash['chef_environment']
 
             # merge in the topology tags
-            nodeprops['tags'] |= topo_hash['tags'] if topo_hash['tags']
-            
-            normal_defaults = topo_hash['normal'] || {}
-            nodeprops['normal'] = normal_defaults.merge(nodeprops['normal'] || {})
-
+            nodeprops['tags'] ||= []
+            nodeprops['tags'] |= topo_hash['tags'] if topo_hash['tags'] && topo_hash['tags'].length > 0
+ 
           end
         end
 
@@ -115,8 +130,14 @@ class Chef
          nodes.each do |updates|
             node_name = updates['name']
             begin
+              
               # load then update and save the node
               node = Chef::Node.load(node_name)
+              
+              if updates['chef_environment'] && updates['chef_environment'] != node['chef_environment']
+                check_chef_env(topo['chef_environment']) 
+              end
+              
               if updated_values = update_node_with_values(node, updates)
                 ui.info "Updating #{updated_values.join(', ')} on node #{node.name}"
                 node.save
@@ -142,7 +163,15 @@ class Chef
       # Make updates into the original node, returning the list of updated properties.
       def update_node_with_values(node, updates)
         updated_properties = []
+        
+        # merge the normal attributes (but not tags)
+        normal_updates = updates['normal'] || {}
+        normal_updates.delete('tags')
+        original_normal = node.normal.clone()
+        prop_merge!(node.normal, normal_updates) 
+        updated_properties << 'normal' if (original_normal != node.normal)
 
+        # merge with existing runlist
         if updates['run_list']
           updated_run_list = RunList.new
           updates['run_list'].each { |e| updated_run_list << e }
@@ -152,25 +181,19 @@ class Chef
           end
         end
 
+        # update chef env
         new_chef_environment = updates['chef_environment']
         if new_chef_environment && new_chef_environment != node.chef_environment
           updated_properties << 'chef_environment'
           node.chef_environment(new_chef_environment)
         end
 
+        # merge tags
         orig_num_tags = node.tags.length
         updates['tags'] ||= [] # make sure tags are initialized
         node.tag(*updates['tags'])
         updated_properties << 'tags' if node.tags.length > orig_num_tags
 
-        normal_updates = updates['normal'] || {}
-        normal_updates.each do |key, value|
-          if (value != node.normal[key])
-            updated_properties << "normal.#{key}"
-            node.normal[key] = value
-          end
-        end
-
         # return false if no updates, else return array of property names
         updated_properties.length > 0 && updated_properties
       end

data/test-repo/Instructions.md

@@ -0,0 +1,131 @@
+##Setup
+
+Assumptions for this demo: chefDK, Vagrant, VirtualBox and chef-zero
+
+* [chefDK](http://www.getchef.com/downloads/chef-dk/)
+
+* [Vagrant](https://www.vagrantup.com/downloads.html)
+
+* [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
+
+If you have chefDK installed, you can use the embedded chef-zero  at 
+/opt/chefdk/embedded/bin/chef-zero
+
+or install it:
+
+	sudo gem install chef-zero
+
+Copy `test-repo` into a working directory, either downloading it from 
+github or copying it from the installed knife-topo gem. You can use:
+
+	gem env
+
+to get the path to your gems and then
+
+```
+  cp -R <gem-path>/gems/knife-topo/test-repo ~
+  cd ~/test-repo
+```
+
+## Demo 
+
+This demo will create and bootstrap two nodes in a topology called test1:
+
+* an application server with a specific version of nodejs (0.10.28), running
+a test application
+* a database server with a specific version of  mongodb (2.6.1)
+
+Each node in the topology will be tagged with 'testsys' and will 
+have an 'owner' and 'node_type' normal attribute.
+ 
+The test1 topology will also contain a third node called buildserver01, 
+which is created but not bootstrapped. This node:
+
+* Is in a different chef environment ('dev')
+* Requires a different version of mongodb
+ 
+In this demo
+
+### Running the demo
+
+From the test-repo, do the following.  Note: you may be prompted to select the network to bridge to
+
+	vagrant up 
+
+This will start the virtual machines on a 
+private network using vagrant. Once the virtual machines are created, 
+start chef-zero listening on the same private network:
+
+	chef-zero -H 10.0.1.1
+
+In another terminal, in test-repo:
+
+```
+	berks install
+	berks upload
+```
+
+To create and bootstrap the test1 topology:
+
+```
+	knife topo import topology.json
+	knife topo create test1 --bootstrap -x vagrant -P vagrant --sudo
+```
+
+To check the bootstrap has succeeded, browse to: 
+[http://localhost:3031](http://localhost:3031).
+You should see a "Welcome" message.
+
+You can see the results on the Chef server
+using standard knife commands, for example:
+
+```
+  knife node list
+  knife node show appserver01
+  knife node show appserver01 -a normal
+  knife data bag show topologies test1
+```
+  
+You can try your own modifications to the topologies.json file. To
+update the topology with the modified configuration:
+
+```
+  knife topo import your_topology.json
+  knife topo update test1
+```  
+
+
+####Troubleshooting
+
+If you are having trouble with berks (`read server certificate B: 
+certificate verify failed (Faraday::SSLError)`
+try following the instructions 
+[here](https://gist.github.com/fnichol/867550#the-manual-way-boring) 
+to add CA certificates for OpenSSL
+
+If the bootstrap fails with 'ERROR: 412 "Precondition Failed"', make sure
+you have run `berks upload` since you started chef-zero.
+
+I encountered some problems getting chef-zero to run on a private network
+on Windows 8.1 (it responded really really slowly). 
+If you have similar problems, you can use hosted Chef
+(sign up for a free account [here](https://manage.opscode.com/signup))
+or your own Chef server. Copy your knife settings and certificates (e.g.,
+the contents of chef-repo/.chef in the "Getting Started" download) into
+test-repo/.chef, and replace the Vagrantfile in test-repo with 
+Vagrantfile_bridged (which will allow the VMs to connect to addresses 
+outside of the host).
+
+If you modify the cookbook_attributes for mongodb and this causes
+a downgrade, the Chef run may fail to converge. 
+There is an [issue](https://github.com/edelight/chef-mongodb/pull/305) 
+in the current cookbook which has been fixed but
+not released (as of 19 July 2014). Run the following to remove the
+installed mongodb and then retry the knife topo bootstrap:
+
+  vagrant ssh dbserver -c 'sudo apt-get remove mongodb'
+
+If you have changed the nodejs version, you need to also change the
+SHA256 checksum. This can be found at
+http://nodejs.org/dist/v0.xx.xx/SHASUMS256.txt. The one you want is
+for 'node-v0.xx.xx-linux-x64.tar.gz'

data/test-repo/Vagrantfile

@@ -19,11 +19,11 @@ qual = "0#{id}"
 nodes = {
 	:dbserver => {
 		:hostname => "dbserver#{qual}",
-		:ipaddress => "10.0.#{id}.2"
+		:private_ipaddress => "10.0.#{id}.2"
 	},
 	:appserver => {
 		:hostname => "appserver#{qual}",
-		:ipaddress => "10.0.#{id}.3",
+		:private_ipaddress => "10.0.#{id}.3",
 		:forwardports => [ 
 		{
 			:guest => 3001, 
@@ -39,14 +39,9 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
 	nodes.each do |node, options|
 		config.vm.define node do |node_config|
 		
-			# setup networking using private network, with port forwarding where needed to access
-			# TODO how to let ip be optional in either case
-			net_type = ( options.has_key?(:public)) ? :public_network : :private_network
-			if options.has_key?(:public)
-    			node_config.vm.network net_type, ip: options[:ipaddress]			
-			else
-				node_config.vm.network net_type, ip: options[:ipaddress]		
-			end
+			# setup networking using private network, with port forwarding where needed to access, and optional bridge
+			node_config.vm.network :public_network if options.has_key?(:public)		
+			node_config.vm.network :private_network, ip: options[:private_ipaddress] if options.has_key?(:private_ipaddress)					
 			
 			if options.has_key?(:forwardports)
 				options[:forwardports].each do |port|

data/test-repo/Vagrantfile_bridged

@@ -0,0 +1,59 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# This Vagrantfile was inspired by Joshua Timberman's blog
+# http://jtimberman.housepub.org/blog/2012/03/18/multivm-vagrantfile-for-chef/
+
+#
+# Vagrantfile for two-machine test topology. Runs with a bridged network
+# and port forwarding from 3001 on appserver guest, to port 303n on host (i.e. 3031 for topo with id 1). 
+# ipaddresses are 10.0.1.2, 10.0.1.3 for dbserver, appserver. 
+
+# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
+VAGRANTFILE_API_VERSION = "2"
+
+id = 1 
+qual = "0#{id}"
+
+ # Define the options for each node
+nodes = {
+	:dbserver => {
+		:hostname => "dbserver#{qual}",
+		:private_ipaddress => "10.0.#{id}.2",
+		:public => true
+	},
+	:appserver => {
+		:hostname => "appserver#{qual}",
+		:private_ipaddress => "10.0.#{id}.3",
+		:public => true,
+		:forwardports => [ 
+		{
+			:guest => 3001, 
+			:host => (3030 +  id) 
+		}
+		]
+	}
+}
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+
+	# setup each node using config ("options") defined above
+	nodes.each do |node, options|
+		config.vm.define node do |node_config|
+		
+			# setup networking using private network, with port forwarding where needed to access, and optional bridge
+			node_config.vm.network :public_network if options.has_key?(:public)		
+			node_config.vm.network :private_network, ip: options[:private_ipaddress] if options.has_key?(:private_ipaddress)					
+			
+			node_config.vm.hostname = options[:hostname]
+		end
+	end
+
+  # Setup the generic config across both servers
+  config.vm.box = "ubuntu64"
+
+  # The url from where the 'config.vm.box' box will be fetched if it
+  # doesn't already exist on the user's system.
+  config.vm.box_url = "http://files.vagrantup.com/precise64.box"
+
+end

data/test-repo/cookbooks/testapp/recipes/appserver.rb

@@ -5,4 +5,4 @@
 # Copyright 2014, ThirdWave Insights
 #
 
-include_recipe "nodejs::install_from_package"
+include_recipe "nodejs::install_from_binary"

data/test-repo/cookbooks/testapp/recipes/deploy.rb

@@ -37,7 +37,7 @@ template "ypo.upstart.conf" do
   mode '0644'
   variables(
   :user => 'vagrant',
-  :node_dir => '/usr',
+  :node_dir => '/usr/local',
   :app_dir => '/home/vagrant',
   :entry => 'ypo'
   )

data/test-repo/topology.json

@@ -22,7 +22,8 @@
 			[
 				"recipe[apt]",
 				"recipe[testapp::appserver]",
-				"testapp::deploy"
+				"testapp::deploy",
+				"testsys_test1"
 			],
 
 			"normal": 
@@ -39,7 +40,8 @@
 			"run_list": 
 			[
 				"recipe[apt]",
-				"recipe[testapp::db]"
+				"recipe[testapp::db]",
+				"testsys_test1"
 			],
 
 			"tags": 
@@ -54,22 +56,49 @@
 					"node_type": "dbserver"
 				}
 			}
+		},
+		{
+			"name": "buildserver01",
+			"chef_environment": "dev",
+			"run_list": 
+			[
+				"recipe[apt]",
+				"recipe[testapp::db]",
+				"recipe[testapp::appserver]",
+				"recipe[testapp::deploy]",
+				"testsys_test1"
+			],
+
+			"tags": 
+			[
+			],
+
+			"normal": 
+			{
+				"topo": 
+				{
+					"node_type": "buildserver"
+				}
+			}
 		}
 	],
 
 	"cookbook_attributes": 
 	[
 		{
+			"cookbook": "testsys_test1",
+			"filename": "softwareversion",
 			"normal": 
-			{
+			{			
 				"nodejs": 
 				{
-					"version": "0.28"
+					"version": "0.10.28",
+					"checksum_linux_x64": "5f41f4a90861bddaea92addc5dfba5357de40962031c2281b1683277a0f75932"
 				},
 
 				"testapp": 
 				{
-					"version": "1.0"
+					"version": "0.0.3"
 				},
 
 				"mongodb": 
@@ -77,11 +106,10 @@
 					"package_version": "2.6.1"
 				}
 			},
-
-			"node_type": 
-			{
-				"buildserver": 
+			"conditional" : [
 				{
+					"qualifier": "node_type",
+					"value" : "buildserver",
 					"normal": 
 					{
 						"mongodb": 
@@ -90,10 +118,7 @@
 						}
 					}
 				}
-			},
-
-			"cookbook": "testsys_test1",
-			"filename": "softwareversion"
+			]
 		}
 	]
 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: knife-topo
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-19 00:00:00.000000000 Z
+date: 2014-07-20 00:00:00.000000000 Z
 dependencies: []
 description: Knife plugin that to manage topologies of nodes
 email:
@@ -30,8 +30,8 @@ files:
 - test-repo/topology.json
 - test-repo/Berksfile
 - test-repo/Vagrantfile
-- test-repo/multipletopology.json
-- test-repo/Instructions.txt
+- test-repo/Instructions.md
+- test-repo/Vagrantfile_bridged
 - test-repo/cookbooks/testapp/recipes/appserver.rb
 - test-repo/cookbooks/testapp/recipes/deploy.rb
 - test-repo/cookbooks/testapp/recipes/default.rb

data/test-repo/Instructions.txt

@@ -1,48 +0,0 @@
-# Assumptions for this demo: chefDK, Vagrant, VirtualBox and chef-zero
-
-# chefDK can be obtained from:
-http://www.getchef.com/downloads/chef-dk/
-
-# vagrant can be installed from:
-https://www.vagrantup.com/downloads.html
-
-# VirtualBox can be obtained from:
-https://www.virtualbox.org/wiki/Downloads
-
-# If you have chefDK installed, you can use the embedded chef-zero
-/opt/chefdk/embedded/bin/chef-zero
-
-# or install it
-sudo gem install chef-zero
-
-# Copy test-repo into a working directory, either downloading it from github or copying it from the installed
-# knife-topo gem. You can use
-gem env
-# to get the path to your gems and then
-cp -R <path-to-gem>/knife-topo/test-repo ~
-cd ~/test-repo
-
-# From the test-repo, do the following to start the virtual machines on a private network using vagrant - 
-# Note: you may be prompted to select the network to bridge to
-vagrant up 
-
-# Once the virtual machines are created, start chef-zero listening on the same private network:
-chef-zero -H 10.0.1.1
-
-# In another terminal, in test-repo:
-berks install
-berks upload
-
-# To create and bootstrap the test1 topology
-knife topo import exchange.json
-knife topo create sys1_test test1
-knife topo bootstrap sys1_test test1 -x vagrant -P vagrant --sudo
-
-
-# To check the bootstrap has succeeded, browse to:
-http://localhost:3031
-# You should see a "Welcome" message
-
-
-
-

data/test-repo/multipletopology.json

@@ -1,117 +0,0 @@
-[{
-	"name": "test1",
-	"chef_environment": "test",
-	"tags": 
-	[
-		"testsys"
-	],
-	"normal": 
-	{
-		"owner": {
-			"name": "Christine Draper",
-			"phone": "512-xxx-xxxx",
-			"email": "christine_draper@thirdwaveinsights.com"
-		}
-	},
-	"nodes": 
-	{
-		"appserver": 
-		{
-			"name": "appserver01",
-			"ssh_host": "10.0.1.3",
-			"run_list": 
-			[
-				"recipe[apt]",
-				"recipe[testapp::appserver]",
-				"testapp::deploy"
-			],
-
-			"normal": 
-			{
-				"topo": 
-				{
-					"node_type": "appserver"
-				}
-			}
-		},
-
-		"dbserver": 
-		{
-			"name": "dbserver01",
-			"ssh_host": "10.0.1.2",
-			"run_list": 
-			[
-				"recipe[apt]",
-				"recipe[testapp::db]"
-			],
-
-			"tags": 
-			[
-				"testapp_database"
-			],
-
-			"normal": 
-			{
-				"topo": 
-				{
-					"node_type": "dbserver"
-				}
-			}
-		}
-	},
-
-	"cookbook_attributes": 
-	[
-		{
-			"normal": 
-			{
-				"nodejs": 
-				{
-					"version": "0.28"
-				},
-
-				"testapp": 
-				{
-					"version": "1.0"
-				},
-
-				"mongodb": 
-				{
-					"package_version": "2.6.1"
-				}
-			},
-
-			"node_type": 
-			{
-				"buildserver": 
-				{
-					"normal": 
-					{
-						"mongodb": 
-						{
-							"package_version": "2.5.1"
-						}
-					}
-				}
-			},
-
-			"cookbook": "testsys_test1",
-			"filename": "softwareversion"
-		}
-	]
-},
-{
-	"name": "test2",
-	"chef_environment": "test",
-	"tags": 
-	[
-		"testsys"
-	],
-	"normal": 
-	{
-		"owner": "John Sweitzer"
-	},
-	"nodes": 
-	{
-	}
-}]