knife-topo 0.0.5 → 0.0.6

data/README.md

@@ -1,48 +1,65 @@
 knife topo
 ==========
 
-This Chef Knife plugin allows you to create and update topologies 
-consisting of multiple nodes. You may find it useful if you are 
+The knife-topo plugin allows you to create and update topologies 
+consisting of multiple nodes using single knife commands, based on
+a JSON definition of the topology. The plugin:
+* creates a data bag for the topology
+* generates attribute file(s) in a topology-specific cookbook
+* sets and updates the run list, chef environment and properties of nodes
+* uploads the topology-specific cookbook and bootstraps nodes
+
+You may find this plugin useful if you are 
 regularly updating a system consisting of multiple nodes, and would
-like to manage its dynamic configuration (like software versions) 
+like to manage its dynamic configuration (e.g. changing 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 #
 
-Copy the contents of lib/chef/knife into your plugin directory, e.g.:
+[Download the latest knife-topo release](http://github.com/christinedraper/knife-topo/releases/latest), 
+unzip and copy `lib/chef/knife` into your plugin directory, e.g.:
 
-	$ mkdir -p ~/.chef/knife/plugins
-	$ cp lib/chef/knife/* ~/.chef/knife/plugins
+	$ unzip knife-topo-0.0.6.zip -d ~
+	$ cd ~/knife-topo-0.0.6
+	$ mkdir -p ~/.chef/plugins/knife
+	$ cp lib/chef/knife/* ~/.chef/plugins/knife
 
 or install knife-topo as a gem
 
-    $ sudo gem install knife-topo
+    $ gem install knife-topo
+
+You may need to use `sudo gem install knife-topo`, depending on your setup.
+
+This plugin has been tested with Chef Version 11.12 on Ubuntu 14.04 LTS. 
 
-This plugin has been tested with Chef Version 11.12 on Ubuntu 14.04 LTS.
+Note: I've encountered a case (on a Mac) where knife was not configured to use
+ gems on the gem path. If the gem install succeeds but `knife topo`
+ is not a recognized knife command, try the first approach (copy
+the ruby plugin scripts into ~/.chef/plugins/knife).
 
 # Usage #
 
-Define one or more topologies in a [topology file](#topology-file). 
+Define one or more topologies in a [topology file](#topology-file). Import
+that file into your Chef workspace using [knife topo import](#import), 
+then create and bootstrap the nodes using a single command [knife topo create](#create). 
+Update the topology file as the configuration changes (e.g., when you 
+need to update software versions), import those changes and run one command
+[knife topo update](#update) to update all of the nodes.
 
-Import the topology file into your local chef repo using
-[knife topo import](#import). Create and optionally
-bootstrap a topology on the Chef server using 
-[knife topo create](#create), and update it
-using [knife topo update](#update).
 
 # Getting Started #
 
-Try out this plugin using a [test repo](test-repo) 
-which you can download from Github or is included in the installed gem. See the 
-[Instructions](Instructions.md) for a
+Try out this plugin using a [test-repo](test-repo) provided in the knife-topo github repository.
+[Download the latest knife-topo release](http://github.com/christinedraper/knife-topo/releases/latest)
+and unzip it, then follow the [Instructions](test-repo/Instructions.md) for a
 demo script, explanation, and troubleshooting.
 
-The instructions assume you have
- [chefDK](http://www.getchef.com/downloads/chef-dk/)
+The instructions assume you have [chefDK](http://www.getchef.com/downloads/chef-dk/)
  or equivalent installed and working with Vagrant and VirtualBox, but
- none of these are requirements for this plugin. 
+ none of these are requirements to use the knife-topo plugin. 
 
 # Topology File <a name="topology-file"></a>#
 
@@ -86,8 +103,8 @@ Each topology contains a list of `nodes`.
     {
         "name": "test1",
         ...
-        "nodes": {
-            "buildserver": {
+        "nodes": [
+           {
                 "name": "buildserver01",
                 "ssh_host": "192.168.1.201",
                 "ssh_port": "2224",
@@ -101,11 +118,8 @@ Each topology contains a list of `nodes`.
                 "tags": ["build"]
             },
             ...
-            }
-        }
-    },
-    ...
-    ]}
+        ]
+    }
 ```
 Within `nodes`, the `name` field is the node name that will be used in Chef.
 The fields `chef_environment`, `run_list`, `tags` and the attributes
@@ -277,11 +291,11 @@ topology test1.
 	knife topo create TOPOLOGY
 
 Creates the specified topology in the chef server as an item in the 
-system environment data bag. Creates the chef environment associated
-with the system environment, if it does not already exist. Uploads any
-topology cookbooks. Creates or 
-updates nodes identified in the topology, using information 
-specified in the system environment and for the specific node. 
+topology data bag. Creates the chef environment associated
+with the topology, if it does not already exist. Uploads any
+topology cookbooks. Updates existing nodes based on the topology
+information. New nodes will be created if the bootstrap option is
+specified.
 
 ### Options:
 
@@ -291,7 +305,7 @@ Option        | Description
 ------------  | -----------
 --bootstrap    | Bootstrap the topology (see [topo bootstrap](#bootstrap))
 See [knife bootstrap](http://docs.opscode.com/knife_bootstrap.html)  | Options supported by `knife bootstrap` are passed through to the bootstrap command
---no-upload   | Do not upload topology cookbooks
+--disable-upload   | Do not upload topology cookbooks
 
 ### Examples:
 The following will create the 'test1' topology, and bootstrap it.
@@ -301,7 +315,7 @@ The following will create the 'test1' topology, and bootstrap it.
 The following will create the 'test1' topology but will not bootstrap it 
 or upload topology cookbooks.
 
-$ knife topo create test1 --no-upload
+$ knife topo create test1 --disable-upload
 
 ## knife topo export <a name="export"></a>
 
@@ -330,8 +344,8 @@ The following will create an outline for a new topology called  'christine_test'
 
 	knife topo import [ TOPOLOGY_FILE [ TOPOLOGY ... ]] 
 
-Imports the system environment and topologies from a
-[topology file](#Topology File) into the local repo. If no topology
+Imports the topologies from a
+[topology file](#topology-file) into the local repo. If no topology
 file is specified, attempts to read from a file called 'topology.json'
 in the current directory. Generates the topology cookbook attribute 
 files and attributes described in the 'cookbook_attributes' property.
@@ -354,9 +368,15 @@ Updates the specified topology. Creates or updates nodes
 identified in the topology, using information specified in the 
 topology for the specific node. 
 
-If no topology is specified, all existing topologies in that environment 
+If no topology is specified, all existing topologies
 will be updated.
 
+Option        | Description
+------------  | -----------
+--bootstrap    | Bootstrap the topology (see [topo bootstrap](#bootstrap))
+See [knife bootstrap](http://docs.opscode.com/knife_bootstrap.html)  | Options supported by `knife bootstrap` are passed through to the bootstrap command
+--disable-upload   | Do not upload topology cookbooks
+
 ### Examples:
 The following will update the 'test1' topology.
 

data/knife-topo.gemspec

@@ -13,8 +13,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/christinedraper/knife-topo"
   spec.license       = "Apache License (2.0)"
   
-  spec.files         = Dir.glob("{lib,test-repo}/**/*") +
-  	Dir.glob("test-repo/.chef/*") +
+  spec.files         = Dir.glob("{lib}/**/*")  +
     ['LICENSE', 'README.md', __FILE__]
   spec.require_paths = ["lib"]
 

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

@@ -1,5 +1,5 @@
 module Knife
   module Topo
-    VERSION = "0.0.5"
+    VERSION = "0.0.6"
   end
 end

data/lib/chef/knife/topo_create.rb

@@ -40,12 +40,12 @@ class Chef
       option :bootstrap,
       :long => "--bootstrap",
       :description => "Whether to bootstrap newly created nodes",
-      :boolean => false
+      :boolean => true
 
-      option :no_upload,
-      :long => "--no-upload",
-      :description => "Do not upload cookbooks",
-      :boolean => false
+      option :disable_upload,
+      :long => "--disable-upload",
+      :description => "Do not upload topo cookbooks",
+      :boolean => true
             
       # Make called command options available
       opts = self.options
@@ -90,7 +90,7 @@ class Chef
 
         # make sure env and cookbooks are in place
         check_chef_env(topo['chef_environment']) if topo['chef_environment']
-        upload_cookbooks(@topo_upload_args) if (!config[:no_upload])  
+        upload_cookbooks(@topo_upload_args) if (!config[:disable_upload])  
 
         # update any existing nodes
         topo_hash = topo.raw_data

data/lib/chef/knife/topo_update.rb

@@ -34,6 +34,11 @@ class Chef
       :long => "--data-bag DATA_BAG",
       :description => "The data bag the topologies are stored in"
 
+      option :disable_upload,
+      :long => "--disable-upload",
+      :description => "Do not upload topo cookbooks",
+      :boolean => true
+ 
       # Make called command options available
       self.options = Chef::Knife::TopoCookbookUpload.options.merge(self.options)
 
@@ -99,7 +104,7 @@ class Chef
       def update_topo(topo)
         topo.save
         @topo_upload_args[3] = topo['name']
-        upload_cookbooks(@topo_upload_args) if (!config[:no_upload]) 
+        upload_cookbooks(@topo_upload_args) if (!config[:disable_upload]) 
 
         topo_hash = topo.raw_data
         nodes = merge_topo_properties(topo_hash['nodes'], topo_hash)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: knife-topo
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-21 00:00:00.000000000 Z
+date: 2014-07-22 00:00:00.000000000 Z
 dependencies: []
 description: Knife plugin that to manage topologies of nodes
 email:
@@ -27,25 +27,6 @@ files:
 - lib/chef/knife/topo_import.rb
 - lib/chef/knife/topology_helper.rb
 - lib/chef/knife/topo_cookbook_upload.rb
-- test-repo/topology.json
-- test-repo/Berksfile
-- test-repo/Vagrantfile
-- 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
-- test-repo/cookbooks/testapp/recipes/db.rb
-- test-repo/cookbooks/testapp/templates/default/nodejs.upstart.conf.erb
-- test-repo/cookbooks/testapp/CHANGELOG.md
-- test-repo/cookbooks/testapp/metadata.rb
-- test-repo/cookbooks/testapp/README.md
-- test-repo/cookbooks/testapp/files/default/index.html
-- test-repo/cookbooks/testapp/files/default/package.json
-- test-repo/cookbooks/testapp/files/default/server.js
-- test-repo/cookbooks/README.md
-- test-repo/.chef/knife.rb
-- test-repo/.chef/dummy.pem
 - LICENSE
 - README.md
 - knife-topo.gemspec

data/test-repo/.chef/dummy.pem

@@ -1,27 +0,0 @@
------BEGIN RSA PRIVATE KEY-----
-MIIEogIBAAKCAQEAqZszg6n+ukMvore53ROFNQAAZhEfW0H9erLqC/4Go/lkRhwl
-d/BOu3bexV2bQFh8Eqg/0VfP0/eOGx4pt6lOP1W20isWr0sGnf8DID2oB/Vi/NhS
-+zfnos/TMXbJSvXryfpMUB6YKhraC645Q0zuBDHm+3fjGol6nND/tVWCW9h+og7d
-WTZLOVUbbD949F7WBVEcbNp66e49AaZ5yYevVJtjCQRQQ1E9d+/WsMM0Nv24VEc2
-oEmbH4U0/+g+WKiJB4m/IDJ4RXco3JtFNpkM/HeKHcc0Niw1A8aLVv5Bp3hYkEnh
-VidA+H2nZ7IxNOzF3wzJAUwxmg89hC2X1t9WUQIDAQABAoIBAGCZrBKOrS3LfIMy
-H6NiLdmNAa0gjXp9sHDFHHbuHTwhnFIuT8zrSvyM7L7+3KEehLRfrdF/MTjqY77g
-RCR+QrniCPnVXttCYSd2CoK/e0flJJccYs8A/WaG9iPTIz0VqlFkxThQ5Jv+pThH
-6AeD9oDfJ08M7oW7zeEpTKssY84JKE7iAPjBoRF8wMjJPbJB6HEDKPT6pPL9fyjF
-+FkD01XxaI4Ip5vXsc0+Lckf9uItD5SP4CDcFVxFtU+4m/iJjBrUxeUDrzWCzOY4
-SgfD9aJ3J79acQ4omtvD0iGUSu/4CwSpAyuw0qzBOS2tmYyaiz0EK2YGg3IbE9xz
-jPjnj40CgYEA1ai6cb/9PBfF82sG6e23fie2odHN6Lt5Ex7AmCjGg7yVly1rLm7f
-LxCA+bJfwyOmx7/rptECAFnQeahVcsLQ3KXDwm0IP8Ow60s83Tk0HNrejlIK7f5i
-8PlvO7Z+bhbTqKDI12YuKJ74pBw4WCP7U4fmxWNryFj1/7o8gPgsqesCgYEAyzeZ
-3lbya3Txl3gYhS5Ppeuqave/q1jcCYUmoTqCfyZxqQyCmuVpMN/S6zx/vTAlFqHK
-OsE5v9GD+NuvfhXga4+9FH4nMdbdhYntHLSwgAW/WPShVsNM2WCibIZtkOoI3Bkl
-wYQF+PZNGPmAChaEsE7oq6vavHD5DHeVmn3M1bMCgYBbLeZjJMutGXggqUwKCKiF
-7ezCogZ9i4Pf5P/L75rIHXK5UWisKCSWsTRZWwYDAPPryruGNSvlem69fFj64KjB
-gPxJvL4IeDrILxOKVR8oMT9I/Tos1qLis5AEq5zI3nT1Qah0Q+bu7uitIF3rP2/B
-9f1Fv2f/1/cjaxbm8wIcgQKBgBx4t8gc6m3/vnF4VAcky+f1MrU17Na25m03CIiC
-SBJEcpw6snm9NpWwZj6rBUKeYjPfixPcSpkDY7gUH2xM6FppkxYx7o/fCL5S6rOg
-5TGqnHp8G7aqOjQig98snmE1SPR9WXrZYnTVHUwoeLXxHboN9C9JLqZENcB3aLBy
-e6ZdAoGACeT2RLyEngm2XVcdNeiXbtwu8+qhoK4FHX5eFKmO2hm+xDo/601acaH+
-LdFDMKfGevjqTCVS9ZD3SgELSk+KpAvXpVmOzXaX/n/eGCVOYxsWPEKhwpEUsIml
-9rq1jU/phQw7627WvP8UbwMbNl1u1SDCJwFTFssVmZ3pDI4nth8=
------END RSA PRIVATE KEY-----

data/test-repo/.chef/knife.rb

@@ -1,13 +0,0 @@
-# See http://docs.opscode.com/config_rb_knife.html for more information on knife configuration options
-
-current_dir = File.dirname(__FILE__)
-log_level                :info
-log_location             STDOUT
-node_name                "workstation"
-client_key               "#{current_dir}/dummy.pem"
-validation_client_name   "validator"
-validation_key           "#{current_dir}/dummy.pem"
-chef_server_url          "http://10.0.1.1:8889"
-cache_type               'BasicFile'
-cache_options( :path => "#{ENV['HOME']}/.chef/checksums" )
-cookbook_path            ["#{current_dir}/../cookbooks"]

data/test-repo/Berksfile

@@ -1,4 +0,0 @@
-source "https://api.berkshelf.com"
-
-cookbook 'testapp', :path => './cookbooks/testapp' 
-

data/test-repo/Instructions.md

@@ -1,131 +0,0 @@
-##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

@@ -1,62 +0,0 @@
-# -*- 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 private 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"
-	},
-	:appserver => {
-		:hostname => "appserver#{qual}",
-		:private_ipaddress => "10.0.#{id}.3",
-		: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)					
-			
-			if options.has_key?(:forwardports)
-				options[:forwardports].each do |port|
-					node_config.vm.network :forwarded_port, guest: port[:guest], host: port[:host]
-				end
-			end
-			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/Vagrantfile_bridged

@@ -1,59 +0,0 @@
-# -*- 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/README.md

@@ -1,54 +0,0 @@
-This directory contains the cookbooks used to configure systems in your infrastructure with Chef.
-
-Knife needs to be configured to know where the cookbooks are located with the `cookbook_path` setting. If this is not set, then several cookbook operations will fail to work properly.
-
-    cookbook_path ["./cookbooks"]
-
-This setting tells knife to look for the cookbooks directory in the present working directory. This means the knife cookbook subcommands need to be run in the `chef-repo` directory itself. To make sure that the cookbooks can be found elsewhere inside the repository, use an absolute path. This is a Ruby file, so something like the following can be used:
-
-    current_dir = File.dirname(__FILE__)
-    cookbook_path ["#{current_dir}/../cookbooks"]
-
-Which will set `current_dir` to the location of the knife.rb file itself (e.g. `~/chef-repo/.chef/knife.rb`).
-
-Configure knife to use your preferred copyright holder, email contact and license. Add the following lines to `.chef/knife.rb`.
-
-    cookbook_copyright "Example, Com."
-    cookbook_email     "cookbooks@example.com"
-    cookbook_license   "apachev2"
-
-Supported values for `cookbook_license` are "apachev2", "mit","gplv2","gplv3",  or "none". These settings are used to prefill comments in the default recipe, and the corresponding values in the metadata.rb. You are free to change the the comments in those files.
-
-Create new cookbooks in this directory with Knife.
-
-    knife cookbook create COOKBOOK
-
-This will create all the cookbook directory components. You don't need to use them all, and can delete the ones you don't need. It also creates a README file, metadata.rb and default recipe.
-
-You can also download cookbooks directly from the Opscode Cookbook Site. There are two subcommands to help with this depending on what your preference is.
-
-The first and recommended method is to use a vendor branch if you're using Git. This is automatically handled with Knife.
-
-    knife cookbook site install COOKBOOK
-
-This will:
-
-* Download the cookbook tarball from cookbooks.opscode.com.
-* Ensure its on the git master branch.
-* Checks for an existing vendor branch, and creates if it doesn't.
-* Checks out the vendor branch (chef-vendor-COOKBOOK).
-* Removes the existing (old) version.
-* Untars the cookbook tarball it downloaded in the first step.
-* Adds the cookbook files to the git index and commits.
-* Creates a tag for the version downloaded.
-* Checks out the master branch again.
-* Merges the cookbook into master.
-* Repeats the above for all the cookbooks dependencies, downloading them from the community site
-
-The last step will ensure that any local changes or modifications you have made to the cookbook are preserved, so you can keep your changes through upstream updates.
-
-If you're not using Git, use the site download subcommand to download the tarball.
-
-    knife cookbook site download COOKBOOK
-
-This creates the COOKBOOK.tar.gz from in the current directory (e.g., `~/chef-repo`). We recommend following a workflow similar to the above for your version control tool.

data/test-repo/cookbooks/testapp/CHANGELOG.md

@@ -1,10 +0,0 @@
-testapp CHANGELOG
-=================
-
-This file is used to list changes made in each version of the testapp cookbook.
-
-0.1.0
------
-- Christine Draper - Initial release of testapp
-
-- - -

data/test-repo/cookbooks/testapp/README.md

@@ -1,26 +0,0 @@
-Test Application Cookbook
-=========================
-A simple nodejs application that puts up a welcome page.
-
-Requirements
-------------
-Tested on Ubuntu 12.04 LTS.
-
-#### packages
-- `nodejs` - The test application is a nodejs application
-- ` mongodb` - In the future, the test application will have a connection to a database
-
-Attributes
-----------
-None
-
-
-Recipes
--------
-#### testapp::default
-
-
-
-License and Authors
--------------------
-Authors: Christine Draper, ThirdWave Insights, LLC

data/test-repo/cookbooks/testapp/files/default/index.html

@@ -1,13 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-<meta charset="utf-8">
-<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
-<title>YPO Test Application</title>
-
-</head>
-<body>
-	<p> Welcome ! You can find the knife topo plugin on Github:</p>
-	<a href="https://github.com">https://github.com/thirdwaveinsights/knife-topo</a>
-</body>
-</html>

data/test-repo/cookbooks/testapp/files/default/package.json

@@ -1,14 +0,0 @@
-{
-  "name": "testapp",
-  "description": "A dummy application for testing knife-topo",
-  "author": "ThirdWave Insights LLC <contact@thirdwaveinsights.com>",
-  "version": "0.0.1",
-  "private": true,
-  "main": "server.js",
-  "dependencies": {
-    "express": "3.3.4",
-    "ejs": "0.8.4",
-    "connect": "2.8.4"
-  },
-  "engine": "node 0.10.15"
-}

data/test-repo/cookbooks/testapp/files/default/server.js

@@ -1,42 +0,0 @@
-/*jslint node: true */
-"use strict";
-
-/**
- * Module dependencies.
- */
-
-var express = require('express')
-  ,  ejs = require('ejs')
-  , http = require('http')
-  ;
-
-// APPLICATION INITIALIZATION
-
-
-/*
- * Setup the express middleware pipeline.
- */
-var app = express();
-
-app.set('port', 3001 );
-app.set('views', __dirname);
-app.set('view engine', 'html');		// default extension to use if omitted
-app.engine('html', ejs.renderFile);	// Use ejs engine for routed html
-app.use(app.router);				// Enables routing
-
-
-//render the index page
-app.get('/', function(req, res) {
-	var username = (req.user && req.user.userName) ? req.user.userName : "";
-	res.render('index.html'); 
-});
-
-
-/*
- * Startup the http server
- */
-http.createServer(app).listen(app.get('port'), function(){
-	console.log("YPO example application server started and listening on port " + app.get('port'));
-});
-
-         

data/test-repo/cookbooks/testapp/metadata.rb

@@ -1,9 +0,0 @@
-name             'testapp'
-maintainer       'ThirdWave Insights LLC'
-maintainer_email 'christine_draper@thirdwaveinsights.com'
-license          'Apache v2.0'
-description      'Installs/Configures test application'
-long_description IO.read(File.join(File.dirname(__FILE__), 'README.md'))
-version          '0.1'
-depends			 'mongodb'
-depends			 'nodejs'

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

@@ -1,8 +0,0 @@
-#
-# Cookbook Name:: testapp
-# Recipe:: db
-#
-# Copyright 2014, ThirdWave Insights
-#
-
-include_recipe "nodejs::install_from_binary"

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

@@ -1,9 +0,0 @@
-#
-# Cookbook Name:: testapp
-# Recipe:: db
-#
-# Copyright 2014, ThirdWave Insights
-#
-
-include_recipe "mongodb::10gen_repo"
-include_recipe "mongodb::default"

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

@@ -1,11 +0,0 @@
-#
-# Cookbook Name:: testapp
-# Recipe:: default
-#
-# Copyright 2014, ThirdWave Insights
-#
-#
-
-include_recipe "testapp::db"
-include_recipe "testapp::appserver"
-include_recipe "testapp::deploy"

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

@@ -1,50 +0,0 @@
-#
-# Cookbook Name:: testapp
-# Recipe:: deploy
-#
-# Copyright 2014, ThirdWave Insights
-#
-#
-
-directory "/home/vagrant/ypo" do
-  owner "vagrant"
-  group "vagrant"
-  mode 00750
-  action :create
-end
-
-cookbook_file "/home/vagrant/ypo/server.js" do
-  source 'server.js' 
-end
-
-cookbook_file "/home/vagrant/ypo/package.json" do
-  source 'package.json' 
-end
-
-cookbook_file "/home/vagrant/ypo/index.html" do
-  source 'index.html'  
-end
-
-execute 'install_ypo' do
-  cwd "/home/vagrant/ypo"
-  user "vagrant"
-  command "npm install"
-end
-
-template "ypo.upstart.conf" do
-  path "/etc/init/ypo.conf"
-  source 'nodejs.upstart.conf.erb'
-  mode '0644'
-  variables(
-  :user => 'vagrant',
-  :node_dir => '/usr/local',
-  :app_dir => '/home/vagrant',
-  :entry => 'ypo'
-  )
-end
-
-service 'ypo' do
-  provider Chef::Provider::Service::Upstart
-  supports :restart => true, :start => true, :stop => true
-  action [:restart]
-end

data/test-repo/cookbooks/testapp/templates/default/nodejs.upstart.conf.erb

@@ -1,9 +0,0 @@
-#!upstart
-description "Node.js Application Server"
-
-start on (local-filesystems and net-device-up IFACE!=lo)
-stop on [!12345]
-
-console log
-chdir <%= @app_dir %>
-exec <%= @node_dir %>/bin/node <%= @entry %>

data/test-repo/topology.json

@@ -1,124 +0,0 @@
-{
-	"name": "test1",
-	"chef_environment": "test",
-	"tags": 
-	[
-		"testsys"
-	],
-	"normal": 
-	{
-		"owner": {
-			"name": "Christine Draper",
-			"phone": "512-xxx-xxxx",
-			"email": "christine_draper@thirdwaveinsights.com"
-		}
-	},
-	"nodes": 
-	[
-		{
-			"name": "appserver01",
-			"ssh_host": "10.0.1.3",
-			"run_list": 
-			[
-				"recipe[apt]",
-				"recipe[testapp::appserver]",
-				"testapp::deploy",
-				"testsys_test1"
-			],
-
-			"normal": 
-			{
-				"topo": 
-				{
-					"node_type": "appserver"
-				}
-			}
-		},
-		{
-			"name": "dbserver01",
-			"ssh_host": "10.0.1.2",
-			"run_list": 
-			[
-				"recipe[apt]",
-				"recipe[testapp::db]",
-				"testsys_test1"
-			],
-
-			"tags": 
-			[
-				"testapp_database"
-			],
-
-			"normal": 
-			{
-				"topo": 
-				{
-					"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.10.28",
-					"checksum_linux_x64": "5f41f4a90861bddaea92addc5dfba5357de40962031c2281b1683277a0f75932"
-				},
-
-				"testapp": 
-				{
-					"version": "0.0.3"
-				},
-
-				"mongodb": 
-				{
-					"package_version": "2.6.1"
-				}
-			},
-			"conditional" : [
-				{
-					"qualifier": "node_type",
-					"value" : "buildserver",
-					"normal": 
-					{
-						"mongodb": 
-						{
-							"package_version": "2.5.1"
-						}
-					}
-				}
-			]
-		}
-	]
-}