knife-vcloud 0.1.0

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+Changes
+==
+2012-12-21 (0.1.0)
+--
+
+Initial release
+
+* Add support for main operations:
+ * login (useful for testing connectivity/credentials)
+ * organization _list/show_
+ * vdc _show_
+ * catalog _show_
+ * catalog item _show_
+ * vapp _create/delete/startup/shutdown_

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.md

@@ -0,0 +1,218 @@
+knife-vcloud
+===========
+
+DESCRIPTION
+--
+A knife plugin for the VMWare® vCloud API.
+
+It uses [vcloud-rest](https://github.com/astratto/vcloud-rest) to communicate with a VMWare vCloud Server.
+
+This code is BETA QUALITY.
+
+INSTALLATION
+--
+This plugin is distributed as a Ruby Gem. To install it, run:
+
+    gem install knife-vcloud
+
+Depending on your system's configuration, you may need to run this command with root privileges.
+
+
+FEATURES
+--
+- login/logout
+- list/show Organizations
+- show VDCs
+- show Catalogs
+- show Catalog Items
+- create/start/stop/delete vApps
+
+PREREQUISITES
+--
+- chef >= 0.10.0
+- knife-windows
+- vcloud-rest"
+
+USAGE
+--
+
+###Available commands
+
+    knife vc catalog item show [ITEM_ID] (options)
+    knife vc catalog show [CATALOG_ID] (options)
+    knife vc login (options)
+    knife vc org list (options)
+    knife vc org show [ORG_ID] (options)
+    knife vc vapp create [VDC_ID] [NAME] [DESCRIPTION] [TEMPLATE_ID] (options)
+    knife vc vapp delete [VAPP_ID] (options)
+    knife vc vapp start [VAPP_ID] (options)
+    knife vc vapp stop [VAPP_ID] (options)
+    knife vc vdc show [VDC_ID] (options)
+
+###Configuration
+All commands accept the following options:
+
+    --vcloud-url URL
+    --vcloud-user USER
+    --vcloud-password SECRET
+    --vcloud-organization ORGANIZATION
+    --vcloud-api-version API_VERSION
+
+In addition, those options can be specified inside your _.chef/knife.rb_ file.
+
+####Knife.rb configuration:
+
+    knife[:vcloud_url] = 'https://vcloud.server.org'
+    knife[:vcloud_org] = 'vcloud_organization'
+    knife[:vcloud_user] = 'vcloud_user'
+    knife[:vcloud_password] = 'vcloud_password'
+    (OPTIONAL) knife[:vcloud_api_version] = '1.5'
+
+###Login
+This command can be used to verify that the vCloud Server can be reached and credentials are correct.
+
+_Example:_
+
+    $ knife vc login
+    Authenticated successfully, code: 9NkgOPh8tH6hPmujAvc99UBSyuqm713/23mFW1f7lJ0=
+
+###List organizations
+This command lists the available organizations.
+
+_Example:_
+
+    $ knife vc org list
+    Name                    ID
+    TEST-ORG                9f3ac2a8-92dd-4921-b48b-85b42f4d247c
+
+###Show organization's details
+This command shows details about a given organization.
+
+_Example:_
+
+    $ knife vc org show 9f3ac2a8-92dd-4921-b48b-85b42f4d247c
+    CATALOGS
+    Name                    ID
+    Catalog_1               7414bc46-44fc-44ed-9844-0aa6ea9f5cf9
+    Catalog_2               97a1e07f-7c1a-49fe-9cda-6ccfd4658ab7
+
+    VDCs
+    Name                    ID
+    Test_vDC_1              440d5134-d2dd-4be7-8692-79a28c86f55b
+
+    NETWORKS
+    Name                    ID
+    TestNet_1               35e5bed1-8475-4fd9-b495-ed1f062ca9c1
+    TestNet_2               d56d8035-4b9e-454e-aa75-6ff450fb432d
+
+    TASKLISTS
+    Name                    ID
+    <unnamed list>          9f3ac2a8-92dd-4921-b48b-85b42f4d247c
+
+###Show catalog's details
+This command shows details about a given catalog.
+
+_Example:_
+
+    $ knife vc catalog show 7414bc46-44fc-44ed-9844-0aa6ea9f5cf9
+    Description: Test Catalog description
+    Name                    ID
+    CentOS 6.3              40e5e071-8231-46c1-92b7-fbe8f633e259
+    ...
+
+###Show catalog item's details
+This command shows details about a given catalog item.
+e.g., retrieve a template ID
+
+_Example:_
+
+    $ knife vc catalog item show 40e5e071-8231-46c1-92b7-fbe8f633e259
+    Description: Linux CentOS 64 bit 6 update 3
+    Name                    Template ID
+    CentOS 6.3              edb5bb2f-58bc-4a44-aaf6-c244543e4a1b
+
+###Show vDC's details
+This command shows details about a given vDC.
+
+_Example:_
+
+    $ knife vc vdc show 440d5134-d2dd-4be7-8692-79a28c86f55b
+    Description:
+    vAPPS
+    Name                    ID                                    Status    IP
+    TestKnife (1 VMs)       09551b42-dca9-474d-aa50-201b223522db  running   10.102.46.237
+    TestCENTOS (1 VMs)      4338a436-19fc-47b9-aaba-024841acfd66  stopped   10.102.46.23
+
+###Startup vApp
+This command starts up a given vApp.
+
+_Example:_
+
+    $ knife vc vapp start 4338a436-19fc-47b9-aaba-024841acfd66
+    vApp startup...Done!
+    Summary: Status: success - started at 2012-12-19T16:50:31.030+01:00 and ended at 2012-12-19T16:50:38.487+01:00
+
+###Shutdown vApp
+This command halts a given vApp.
+
+_Example:_
+
+    $ knife vc vapp $ knife vc vapp stop 09551b42-dca9-474d-aa50-201b223522db
+    vApp shutdown...Done!
+    Summary: Status: success - started at 2012-12-19T16:56:31.100+01:00 and ended at 2012-12-19T16:56:38.667+01:00
+
+###Delete vApp
+This command deletes a given vApp.
+
+_Example:_
+
+    $ knife vc vapp delete c1bad644-6c4d-40fc-a46b-7624ff6d5e75
+    Do you really want to DELETE vApp c1bad644-6c4d-40fc-a46b-7624ff6d5e75?? (Y/N) Y
+    vApp deletion...Done!
+    Summary: Status: success - started at 2012-12-19T17:00:20.503+01:00 and ended at 2012-12-19T17:00:21.133+01:00
+
+###Create vApp from template
+This command creates a vApp starting from a template (see catalog item).
+
+_Example:_
+
+    $ knife vc vapp create 440d5134-d2dd-4be7-8692-79a28c86f55b TestVM "Test vm description" 14b63ef2-fe93-4d0b-91f0-ccbd3847c665
+    vApp creation...Done!
+    Summary: Status: success - started at 2012-12-19T17:02:32.797+01:00 and ended at 2012-12-19T17:02:53.943+01:00
+    vApp created with ID: 9cdd92ad-ab65-467f-abe1-075e35c050ec
+
+###Show vApp's details
+This command shows details about a given vApp.
+
+_Example:_
+
+    $ knife vc vapp show 4338a436-19fc-47b9-aaba-024841acfd66
+    Name: TEST_CENTOS
+    Status: running
+    IP: 10.102.46.237
+    Name                  Status         IPs             ID
+    CENTOS63              running        10.102.46.237   8b943bf9-a8ca-4d41-b97f-316c3aa891ea
+
+LICENSE
+--
+
+Author:: Stefano Tortarolo <stefano.tortarolo@gmail.com>
+
+Copyright:: Copyright (c) 2012
+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.
+
+CREDITS
+--
+This code was inspired by [knife-cloudstack](https://github.com/CloudStack-extras/knife-cloudstack).

data/lib/chef/knife/common.rb

@@ -0,0 +1,56 @@
+#
+# Author:: Stefano Tortarolo (<stefano.tortarolo@gmail.com>)
+# Copyright:: Copyright (c) 2012
+# 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.
+#
+
+module KnifeVCloud
+  # Module for operations common among commands
+  module Common
+    def connection
+      unless @connection
+        @connection = VCloudClient::Connection.new(
+            locate_config_value(:vcloud_url),
+            locate_config_value(:vcloud_user),
+            locate_config_value(:vcloud_password),
+            locate_config_value(:vcloud_org),
+            locate_config_value(:vcloud_api_version)
+        )
+      end
+      @connection
+    end
+
+    def msg(label, value)
+      if value && !value.empty?
+        puts "#{ui.color(label, :cyan)}: #{value}"
+      end
+    end
+
+    def locate_config_value(key)
+      key = key.to_sym
+      Chef::Config[:knife][key] || config[key]
+    end
+
+    def wait_task(connection, task_id)
+      status, errormsg, start_time, end_time = connection.wait_task_completion task_id
+      puts "Done!"
+      msg("Summary", "Status: #{ui.color(status, :cyan)} - started at #{start_time} and ended at #{end_time}")
+
+      if errormsg
+        puts ui.color("ATTENTION: #{errormsg}", :red)
+      end
+    end
+  end
+end

data/lib/chef/knife/vc_catalog_item_show.rb

@@ -0,0 +1,88 @@
+#
+# Author:: Stefano Tortarolo (<stefano.tortarolo@gmail.com>)
+# Copyright:: Copyright (c) 2012
+# 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 KnifeVCloud
+  class VcCatalogItemShow < Chef::Knife
+    include KnifeVCloud::Common
+
+    deps do
+      require 'vcloud-rest/connection'
+      require 'chef/api_client'
+    end
+
+    banner "knife vc catalog item show [CATALOG_ID] (options)"
+
+    option :vcloud_url,
+           :short => "-H URL",
+           :long => "--vcloud-url URL",
+           :description => "The vCloud endpoint URL",
+           :proc => Proc.new { |url| Chef::Config[:knife][:vcloud_url] = url }
+
+    option :vcloud_user,
+           :short => "-U USER",
+           :long => "--vcloud-user USER",
+           :description => "Your vCloud User",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_user] = key }
+
+    option :vcloud_password,
+           :short => "-P SECRET",
+           :long => "--vcloud-password SECRET",
+           :description => "Your vCloud secret key",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_password] = key }
+
+    option :vcloud_org,
+           :short => "-O ORGANIZATION",
+           :long => "--vcloud-organization ORGANIZATION",
+           :description => "Your vCloud Organization",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_org] = key }
+
+    option :vcloud_api_version,
+           :short => "-A API_VERSION",
+           :long => "--vcloud-api-version API_VERSION",
+           :description => "vCloud API version (1.5 and 5.1 supported)",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_api_version] = key }
+
+    def run
+      $stdout.sync = true
+
+      item_id = @name_args.first
+
+      connection.login
+
+      header = [
+          ui.color('Name', :bold),
+          ui.color('Template ID', :bold)
+      ]
+
+      description, items = connection.show_catalog_item item_id
+      connection.logout
+
+      puts "#{ui.color('Description:', :cyan)} #{description}"
+      list = header
+      list.flatten!
+      items.each do |k, v|
+        list << (k || '')
+        list << (v || '')
+      end
+
+      puts ui.list(list, :columns_across, 2)
+    end
+  end
+end

data/lib/chef/knife/vc_catalog_show.rb

@@ -0,0 +1,88 @@
+#
+# Author:: Stefano Tortarolo (<stefano.tortarolo@gmail.com>)
+# Copyright:: Copyright (c) 2012
+# 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 KnifeVCloud
+  class VcCatalogShow < Chef::Knife
+    include KnifeVCloud::Common
+
+    deps do
+      require 'vcloud-rest/connection'
+      require 'chef/api_client'
+    end
+
+    banner "knife vc catalog show [CATALOG_ID] (options)"
+
+    option :vcloud_url,
+           :short => "-H URL",
+           :long => "--vcloud-url URL",
+           :description => "The vCloud endpoint URL",
+           :proc => Proc.new { |url| Chef::Config[:knife][:vcloud_url] = url }
+
+    option :vcloud_user,
+           :short => "-U USER",
+           :long => "--vcloud-user USER",
+           :description => "Your vCloud User",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_user] = key }
+
+    option :vcloud_password,
+           :short => "-P SECRET",
+           :long => "--vcloud-password SECRET",
+           :description => "Your vCloud secret key",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_password] = key }
+
+    option :vcloud_org,
+           :short => "-O ORGANIZATION",
+           :long => "--vcloud-organization ORGANIZATION",
+           :description => "Your vCloud Organization",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_org] = key }
+
+    option :vcloud_api_version,
+           :short => "-A API_VERSION",
+           :long => "--vcloud-api-version API_VERSION",
+           :description => "vCloud API version (1.5 and 5.1 supported)",
+           :proc => Proc.new { |key| Chef::Config[:knife][:vcloud_api_version] = key }
+
+    def run
+      $stdout.sync = true
+
+      catalog_id = @name_args.first
+
+      connection.login
+
+      header = [
+          ui.color('Name', :bold),
+          ui.color('ID', :bold)
+      ]
+
+      description, items = connection.show_catalog catalog_id
+      connection.logout
+
+      puts "#{ui.color('Description:', :cyan)} #{description}"
+      list = header
+      list.flatten!
+      items.each do |k, v|
+        list << (k || '')
+        list << (v || '')
+      end
+
+      puts ui.list(list, :columns_across, 2)
+    end
+  end
+end