ucloudstack 0.0.1

data/CHANGES.rdoc

@@ -0,0 +1,68 @@
+= Changes
+
+== 2012-05-17 (0.0.12)
+* Adding option to disable public IP allocation on server create
+  https://github.com/CloudStack/knife-cloudstack/pull/8
+* Fix whitespace issue in network names
+  https://github.com/CloudStack/knife-cloudstack/pull/7
+
+== 2011-11-03 (0.0.11)
+* Added LICENSE file and licensing headers to source. No feature changes.
+
+== 2011-10-13 (0.0.10)
+* Support for multi-homed VMs: The --networks option for the <tt>server create</tt> command takes a comma-separated list
+  of network offering names. The created VM will have one nic per network, with nics assigned to networks in the order
+  specified (e.g. the first network in the list will be assigned to eth0, the second to eth1 and so on). The --networks
+  option replaces the --network option, which supported a single network name.
+* The <tt>server list</tt> command now shows the VM 'displayname' in parentheses when the displayname is defined and is
+  different than the VM name.
+* Public IP logic has been updated to support multi-homed VMs. It now uses the first nic attached to a network with the
+  'default' value set to true as the primary interface.
+   
+== 2011-08-30 (0.0.9)
+* Added subcommands: <tt>server start</tt>, <tt>server stop</tt> and <tt>server reboot</tt>.
+* Updated the <tt>hosts</tt> command to return short hostnames and FQDNs. Also added comments where needed so the output
+  can be directly pasted into /etc/hosts.
+
+== 2011-08-06 (0.0.8)
+* Changed cloudstack async command timeout from 60 to 300 seconds.
+
+== 2011-07-21 (0.0.7)
+* Fixed http_request actions in <tt>stack create</tt>.
+
+== 2011-07-15 (0.0.6)
+* The <tt>server delete</tt> command now deletes the chef node and client if their names match the fqdn of the server.
+* Added the <tt>stack create</tt> and <tt>stack delete</tt> commands for bulk creation and deletion of servers using a
+  JSON definition file. These commands are still experimental and subject to change. See README.rdoc for details.
+* Added a <tt>hosts</tt> command, which lists the public ip address and fqdn of all servers in /etc/hosts file format.
+* Fixed nil reference bug in <tt>server list</tt> command.
+
+== 2011-06-05 (0.0.5)
+* Added <tt>--port-rules</tt> option to the <tt>cs server create</tt> command. It accepts a list of port forwarding
+  rules to be created for the server (only applies to servers on a virtual network). See 'Port forwarding rules for
+  virtual networks' in README.rdoc for details.
+
+== 2011-06-01 (0.0.4)
+* Fixed ssh detection bug.
+
+== 2011-05-30 (0.0.3)
+
+* Added support for virtual networks. A public IP address is allocated for each new server in a virtual network
+  and an ssh port forwarding rule is created. The IP is released when the server is destroyed as long as it doesn't
+  have forwarding rules for any servers other than the one being deleted.
+* Default network is now detected automatically. If there is more than one network marked as 'default' for an
+  account, the first Direct network is preferred.
+
+== 2011-05-22 (0.0.2)
+
+* Added subcommands: <tt>service list</tt>, <tt>template list</tt>, <tt>network list</tt> and <tt>zone list</tt>.
+* Removed -H (and --hostname) option from the <tt>cs server create</tt> command. The host name is now the first
+  argument to the command: <tt>knife cs server create myhostname</tt>. If a host name is not specified, CloudStack
+  will use an auto-generated name.
+* Added --no-bootstrap option to the server create command. This prevents Chef from being installed on the new server.
+* Fixed help banners (commands were shown as <tt>knife cloudstack ...</tt> instead of <tt>knife cs ...</tt>).
+* Added README.rdoc.
+
+== 2011-05-15 (0.0.1)
+
+* Initial release

data/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.rdoc

@@ -0,0 +1,215 @@
+= knife-cloudstack
+
+== DESCRIPTION:
+
+This is the Edmunds Knife plugin for CloudStack. This plugin gives Knife the ability to create, bootstrap and manage
+CloudStack instances.
+
+== INSTALLATION:
+This plugin is distributed as a Ruby Gem. To install it, run:
+
+    gem install knife-cloudstack
+
+Depending on your system's configuration, you may need to run this command with root privileges.
+
+== CONFIGURATION:
+In order to communicate with the CloudStack API you will have to tell Knife about your CloudStack API Key, your Secret Key and the URL of the API endpoint.
+The easiest way to accomplish this is to create some entries in your <tt>knife.rb</tt> file:
+
+    knife[:cloudstack_url] = "http://yourcloudstackserver.com:8080/client/api
+    knife[:cloudstack_api_key]  = "Your CloudStack API Key"
+    knife[:cloudstack_secret_key] = "Your CloudStack Secret Key"
+
+If your knife.rb file will be checked into a SCM system (ie readable by others) you may want to read the values from environment variables:
+
+    knife[:cloudstack_url] = "#{ENV['CLOUDSTACK_URL']}"
+    knife[:cloudstack_api_key] = "#{ENV['CLOUDSTACK_API_KEY']}"
+    knife[:cloudstack_secret_key] = "#{ENV['CLOUDSTACK_SECRET_KEY']}"
+
+You also have the option of passing your CloudStack URL and API/Secret Keys into the individual knife subcommands using the <tt>-U</tt> (or <tt>--cloudstack-url</tt>),
+<tt>-A</tt> (or <tt>--cloudstack-api-key </tt>) <tt>-K</tt> (or <tt>--cloudstack-secret-key</tt>) command options
+    # provision a new small RHEL 5.6 webserver
+    knife cs server create my-server -r 'role[webserver]' -S "small" -T "RHEL 5.6 Base" -A 'Your CloudStack API Key' -K "Your CloudStack Secret Key" --distro "rhel5-gems"
+
+Additionally the following options may be set in your <tt>knife.rb</tt>:
+
+* knife[:cloudstack_service]
+* knife[:cloudstack_template]
+* knife[:cloudstack_zone]
+* knife[:distro]
+* knife[:template_file]
+
+
+== SUBCOMMANDS:
+
+This plugin provides the following Knife subcommands.  Specific command options can be found by invoking the subcommand with a <tt>--help</tt> flag
+
+=== knife cs server create
+
+Provisions a new server in CloudStack and then performs a Chef bootstrap (using the SSH protocol).  The goal of the bootstrap is to get Chef installed on the target
+system so it can run Chef Client with a Chef Server. The main assumption is a baseline OS installation exists (provided by the provisioning). It is primarily
+intended for Chef Client systems that talk to a Chef server.  By default the server is bootstrapped using the {ubuntu10.04-gems}[https://github.com/opscode/chef/bl
+ob/master/chef/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb] template.  This can be overridden using the <tt>-d</tt> or <tt>--template-file</tt> command options.
+
+By default, new servers are allocated a public IP address mapping to the CloudStack private IP address. If you do not want this behavior, pass the <tt>--no-public-ip</tt> option.
+
+==== Port forwarding rules for virtual networks
+The <tt>--port-rules</tt> option takes a comma separated list of port forwarding rules. These rules are created on the
+virtual public ip address of the server. Note that this option only applies to servers using a virtual network; it is
+ignored if the server's public ip address is on a direct attached network.
+
+Port forwarding rules have the syntax <tt>PUBLIC_PORT[:PRIVATE_PORT[:PROTOCOL]]</tt>. <tt>PRIVATE_PORT</tt> and
+<tt>PROTOCOL</tt> are optional. The default value of <tt>PRIVATE_PORT</tt> is <tt>PUBLIC_PORT</tt> and the default
+<tt>PROTOCOL</tt> is 'TCP'.
+For example, a rule to forward from public port 80 to private port 7000 would look like <tt>80:7000:TCP</tt>.
+Since 'TCP' is the default protocol, the rule can be shortened to <tt>80:7000</tt>. A rule can even be shortened to a
+single number when the public and private ports are the same. For example, a rule to forward from public port 25 to
+private port 25 can be stated as simply <tt>25</tt>. A list of such rules for a webserver might look like
+<tt>80,443</tt>.
+
+=== knife cs server delete
+
+Deletes an existing server in the currently configured CloudStack account.  <b>PLEASE NOTE</b> - this does not delete
+the associated node and client objects from the Chef server.
+
+=== knife cs server list
+
+Displays a list of all servers in the currently configured CloudStack account.  <b>PLEASE NOTE</b> - this shows all
+servers associated with the cloudstack account including servers that are not registered with a Chef server.
+
+=== knife cs network list
+Displays a list of all networks available in the currently configured CloudStack account. A network can be specified
+when creating a new server by passing the network name as an argument to the -W (or --network) option of the
+<tt>knife cs server create</tt> command.
+
+=== knife cs service list
+Displays a list of all service offerings available in the currently configured CloudStack account. A service offering
+can be specified when creating a new server by passing the name as an argument to the -S (or --service) option of the
+<tt>knife cs server create</tt> command.
+
+=== knife cs template list
+Displays a list of all templates in the currently configured CloudStack account. Featured templates are displayed by default.
+Use the -F (or --filter) option to use a different filter. The allowable filter values are:
+
+* featured - templates that are featured and are public (this is the default)
+* self - templates that have been registered/created by the owner
+* self-executable - templates that have been registered/created by the owner that can be used to deploy a new VM
+* executable - all templates that can be used to deploy a new VM
+* community - templates that are public
+
+A template can be specified when creating a new server by passing the template name as an argument to the -T
+(or --template) option of the <tt>knife cs server create</tt> command.
+
+=== knife cs zone list
+Displays a list of all zones available in the currently configured CloudStack account. A zone can be specified
+when creating a new server by passing the zone name as an argument to the -Z (or --zone) option of the
+<tt>knife cs server create</tt> command.
+
+=== knife cs hosts
+Convenience command that displays the public ip address and fqdn for all servers. Matches /etc/hosts file format.
+
+=== knife cs stack create
+Creates a "stack" of servers based on a JSON definition file. Simple orchestration can be performed by
+specifying one or more actions to be executed after a server (or group of servers) is created.
+
+==== Example Stack Definition File:
+<tt>
+{
+  "name": "hadoop_cluster_a",
+  "description": "A small hadoop cluster with hbase",
+  "version": "1.0",
+  "environment": "production",
+  "servers": [
+    {
+      "name": "zookeeper-a, zookeeper-b, zookeeper-c",
+      "description": "Zookeeper nodes",
+      "template": "rhel-5.6-base",
+      "service": "small",
+      "port_rules": "2181",
+      "run_list": "role[cluster_a], role[zookeeper_server]",
+      "actions": [
+        { "knife_ssh": ["role:zookeeper_server", "sudo chef-client"] }
+      ]
+    },
+    {
+      "name": "hadoop-master",
+      "description": "Hadoop master node",
+      "template": "rhel-5.6-base",
+      "service": "large",
+      "networks": "app-net, storage-net",
+      "port_rules": "50070, 50030, 60010",
+      "run_list": "role[cluster_a], role[hadoop_master], role[hbase_master]"
+    },
+    {
+      "name": "hadoop-worker-a hadoop-worker-b hadoop-worker-c",
+      "description": "Hadoop worker nodes",
+      "template": "rhel-5.6-base",
+      "service": "medium",
+      "port_rules": "50075, 50060, 60030",
+      "run_list": "role[cluster_a], role[hadoop_worker], role[hbase_regionserver]",
+      "actions": [
+        { "knife_ssh": ["role:hadoop_master", "sudo chef-client"] },
+        { "http_request": "http://${hadoop-master}:50070/index.jsp" }
+      ]
+    }
+}
+</tt>
+
+==== Stack Attributes
+name:: Stack name. May be used in the future to e.g. look up a stack in a databag.
+version:: Stack version. This attribute is not currently used.
+environment:: Chef environment used for all servers in the stack.
+servers:: List of servers to create.
+
+==== Server Attributes
+name:: The name of the new server. Specify a list of names separated by commas and/or spaces to create multiple servers.
+description:: Server description.
+template:: Cloudstack template name.
+service:: Cloudstack service offering name.
+port_rules:: Port forwarding rules for virtual networks. These are ignored when using direct or other network types.
+run_list:: Chef run list.
+actions:: List of actions to perform after the server (or group of servers) is created.
+
+==== Actions
+knife-ssh:: Performs a knife-ssh command. Takes the search query and the command to execute as an array of arguments.
+http_request:: Performs an http request. Supports references to server names in the stack with ${server_name}.
+
+==== Upcoming Actions
+The following actions are under development:
+
+runlist_add:: Adds an entry from the run list.
+runlist_remove:: Removes an entry from the run list.
+
+=== knife cs stack delete
+Deletes all servers in the specified stack definition.
+
+=== knife cs server start
+Starts the specified virtual machine(s).
+
+=== knife cs server stop
+Stops the specified virtual machine(s). Force stop is optional.
+
+=== knife cs server reboot
+Reboots the specified virtual machines(s).
+
+== LICENSE:
+
+Author:: Ryan Holmes <rholmes@edmunds.com> 
+Author:: KC Braunschweig <kbraunschweig@edmunds.com>
+Author:: John E. Vincent <lusis.org+github.com@gmail.com>
+
+Copyright:: Copyright (c) 2011 Edmunds, Inc.
+License:: Apache License, Version 2.0
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+

data/lib/chef/knife/cs_hosts.rb

@@ -0,0 +1,83 @@
+#
+# Author:: Ryan Holmes (<rholmes@edmunds.com>)
+# Author:: KC Braunschweig (<kbraunschweig@edmunds.com>)
+# Copyright:: Copyright (c) 2011 Edmunds, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'chef/knife'
+
+module KnifeCloudstack
+  class CsHosts < Chef::Knife
+
+    MEGABYTES = 1024 * 1024
+
+    deps do
+      require 'knife-cloudstack/connection'
+    end
+
+    banner "knife cs hosts"
+
+    option :cloudstack_url,
+           :short => "-U URL",
+           :long => "--cloudstack-url URL",
+           :description => "The CloudStack endpoint URL",
+           :proc => Proc.new { |url| Chef::Config[:knife][:cloudstack_url] = url }
+
+    option :cloudstack_api_key,
+           :short => "-A KEY",
+           :long => "--cloudstack-api-key KEY",
+           :description => "Your CloudStack API key",
+           :proc => Proc.new { |key| Chef::Config[:knife][:cloudstack_api_key] = key }
+
+    option :cloudstack_secret_key,
+           :short => "-K SECRET",
+           :long => "--cloudstack-secret-key SECRET",
+           :description => "Your CloudStack secret key",
+           :proc => Proc.new { |key| Chef::Config[:knife][:cloudstack_secret_key] = key }
+
+    def run
+
+      connection = CloudstackClient::Connection.new(
+          locate_config_value(:cloudstack_url),
+          locate_config_value(:cloudstack_api_key),
+          locate_config_value(:cloudstack_secret_key)
+      )
+
+      host_list = [
+          ui.color('#Public IP', :bold),
+          ui.color('Host', :bold),
+          ui.color('FQDN', :bold)
+      ]
+
+      servers = connection.list_servers
+      pf_rules = connection.list_port_forwarding_rules
+      servers.each do |s|
+        host_list << (connection.get_server_public_ip(s, pf_rules) || '#')
+        host_list << (s['name'] || '')
+        host_list << (connection.get_server_fqdn(s) || '')
+      end
+      puts ui.list(host_list, :columns_across, 3)
+
+    end
+
+
+    def locate_config_value(key)
+      key = key.to_sym
+      Chef::Config[:knife][key] || config[key]
+    end
+
+  end
+end

data/lib/chef/knife/cs_network_list.rb

@@ -0,0 +1,84 @@
+#
+# Author:: Ryan Holmes (<rholmes@edmunds.com>)
+# Copyright:: Copyright (c) 2011 Edmunds, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'chef/knife'
+
+module KnifeCloudstack
+  class CsNetworkList < Chef::Knife
+
+    deps do
+      require 'knife-cloudstack/connection'
+    end
+
+    banner "knife cs network list (options)"
+
+    option :cloudstack_url,
+           :short => "-U URL",
+           :long => "--cloudstack-url URL",
+           :description => "The CloudStack endpoint URL",
+           :proc => Proc.new { |url| Chef::Config[:knife][:cloudstack_url] = url }
+
+    option :cloudstack_api_key,
+           :short => "-A KEY",
+           :long => "--cloudstack-api-key KEY",
+           :description => "Your CloudStack API key",
+           :proc => Proc.new { |key| Chef::Config[:knife][:cloudstack_api_key] = key }
+
+    option :cloudstack_secret_key,
+           :short => "-K SECRET",
+           :long => "--cloudstack-secret-key SECRET",
+           :description => "Your CloudStack secret key",
+           :proc => Proc.new { |key| Chef::Config[:knife][:cloudstack_secret_key] = key }
+
+    def run
+
+      connection = CloudstackClient::Connection.new(
+          locate_config_value(:cloudstack_url),
+          locate_config_value(:cloudstack_api_key),
+          locate_config_value(:cloudstack_secret_key)
+      )
+
+      network_list = [
+          ui.color('Name', :bold),
+          ui.color('Type', :bold),
+          ui.color('Default', :bold),
+          ui.color('Shared', :bold),
+          ui.color('Gateway', :bold),
+          ui.color('Netmask', :bold)
+      ]
+
+      networks = connection.list_networks
+      networks.each do |n|
+        network_list << n['name']
+        network_list << n['type']
+        network_list << n['isdefault'].to_s
+        network_list << n['isshared'].to_s
+        network_list << (n['gateway'] || '')
+        network_list << (n['netmask'] || '')
+      end
+      puts ui.list(network_list, :columns_across, 6)
+
+    end
+
+    def locate_config_value(key)
+      key = key.to_sym
+      Chef::Config[:knife][key] || config[key]
+    end
+
+  end
+end