vas 0.3.0

data/lib/vas/tc_server/nodes.rb

@@ -0,0 +1,50 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+  
+  # Used to enumerate tc Server nodes
+  class Nodes < Shared::Collection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "nodes", Node)
+    end
+
+  end
+
+  # A tc Server node
+  class Node < Shared::GroupableNode
+
+    # The Node's Java home
+    attr_reader :java_home
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Group)
+      @java_home = details["java-home"]
+    end
+
+    def instances
+      @instances = NodeInstances.new(Util::LinkUtils.get_link_href(details, "node-instances"), client)
+    end
+    
+    def to_s #:nodoc:
+      "#<#{self.class} host_names='#{host_names}' ip_addresses='#{ip_addresses}' operating_system='#{operating_system}' architecture='#{architecture}' agent_home='#{agent_home}' java_home='#{java_home}' metadata='#{metadata}'>"
+    end
+
+  end
+
+end

data/lib/vas/tc_server/pending_configurations.rb

@@ -0,0 +1,38 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+
+  # Used to enumerate an instance's pending configuration
+  class PendingConfigurations < Shared::PendingConfigurations
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, 'pending-configurations', PendingConfiguration)
+    end
+
+  end
+
+  # A configuration file that is pending
+  class PendingConfiguration < Shared::PendingConfiguration
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, 'group-instance', Instance)
+    end
+
+  end
+
+end

data/lib/vas/tc_server/revision_images.rb

@@ -0,0 +1,67 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+
+  # Used to enumerate, create, and delete tc Server revision images.
+  class RevisionImages < Shared::MutableCollection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "revision-images", RevisionImage)
+    end
+    
+    # Creates a RevisionImage named +name+ with the version +version+ by uploading the WAR file at the given +path+
+    def create(path, name, version)
+      RevisionImage.new(client.post_image(location, path, { :name => name, :version => version }), client)
+    end
+    
+  end
+  
+  # A revision image, i.e. a WAR file
+  class RevisionImage < Shared::Resource
+
+    # The revision image's name
+    attr_reader :name
+
+    # The revision image's version
+    attr_reader :version
+
+    # The revision image's size
+    attr_reader :size
+
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+
+      @name = details["name"]
+      @version = details["version"]
+      @size = details['size']
+    end
+
+    # The revisions that have been created from this revision image
+    def revisions
+      revisions = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), "group-revision").each { |revision_location| revisions << Revision.new(revision_location, client)}
+      revisions
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name' version='#@version'>"
+    end
+
+  end
+
+end

data/lib/vas/tc_server/revisions.rb

@@ -0,0 +1,71 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+
+  # Used to enumerate, create, and delete application revisions.
+  class Revisions < Shared::MutableCollection
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client, "revisions", Revision)
+    end
+
+    # Creates a Revision by deploying the RevisionImage +revision_image+
+    def create(revision_image)
+      Revision.new(client.post(location, { :image => revision_image.location}, 'group-revision'), client)
+    end
+    
+  end
+
+  # A revision of an Application
+  class Revision < Shared::StateResource
+
+    # The Revision's version
+    attr_reader :version
+
+    # The Revision's application
+    attr_reader :application
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+      
+      @version = details['version']
+      @revision_image_location = Util::LinkUtils.get_link_href(details, 'revision-image')
+      @application = Application.new(Util::LinkUtils.get_link_href(details, 'group-application'), client)
+    end
+
+    # The revision image, if any, that was used to create the revision
+    def revision_image
+      if (!@revision_image_location.nil?)
+        RevisionImage.new(@revision_image_location, client)
+      end
+    end
+
+    # An array of the revision's individual node revisions
+    def node_revisions
+      node_revisions = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), 'node-revision').each {
+          |node_revision_location| node_revisions << NodeRevision.new(node_revision_location, client)}
+      node_revisions
+    end
+    
+    def to_s #:nodoc:
+      "#<#{self.class} version='#@version'>"
+    end
+  end
+
+end

data/lib/vas/tc_server/tc_server.rb

@@ -0,0 +1,50 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+  
+  # The entry point to the API for administering tc Server
+  class TcServer
+
+    # The tc Server Groups
+    attr_reader :groups
+
+    # The tc Server InstallationImages
+    attr_reader :installation_images
+
+    # The tc Server Nodes
+    attr_reader :nodes
+
+    # The tc Server RevisionImages
+    attr_reader :revision_images
+
+    # The tc Server TemplateImages
+    attr_reader :template_images
+    
+    def initialize(location, client) #:nodoc:
+
+      json = client.get(location)
+      
+      @groups = Groups.new(Util::LinkUtils.get_link_href(json, "groups"), client)
+      @installation_images = InstallationImages.new(Util::LinkUtils.get_link_href(json, "installation-images"), client)
+      @nodes = Nodes.new(Util::LinkUtils.get_link_href(json, "nodes"), client)
+      @revision_images = RevisionImages.new(Util::LinkUtils.get_link_href(json, "revision-images"), client)
+      @template_images = TemplateImages.new(Util::LinkUtils.get_link_href(json, "template-images"), client)
+    end
+    
+  end
+end

data/lib/vas/tc_server/template_images.rb

@@ -0,0 +1,67 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+
+  # Used to enumerate, create, and delete tc Server template images.
+  class TemplateImages < Shared::MutableCollection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "template-images", TemplateImage)
+    end
+    
+    # Creates a TemplateImage named +name+ with the version +version+ by uploading the file at the given +path+
+    def create(path, name, version)
+      TemplateImage.new(client.post_image(location, path, { :name => name, :version => version }), client)
+    end
+    
+  end
+  
+  # A template image
+  class TemplateImage < Shared::Resource
+
+    # The template image's name
+    attr_reader :name
+
+    # The template image's version
+    attr_reader :version
+
+    # The template image's size
+    attr_reader :size
+
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+
+      @name = details["name"]
+      @version = details["version"]
+      @size = details['size']
+    end
+
+    # The Template s that have been created from this TemplateImage
+    def templates
+      templates = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), "template").each { |template_location| templates << Template.new(template_location, client)}
+      templates
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name' version='#@version'>"
+    end
+
+  end
+
+end

data/lib/vas/tc_server/templates.rb

@@ -0,0 +1,70 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 TcServer
+
+  # Used to enumerate, create, and delete tc Server templates.
+  class Templates < Shared::MutableCollection
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client, "templates", Template)
+    end
+    
+    # Creates a template from the +template_image+
+    def create(template_image)
+      Template.new(client.post(location, { :image => template_image.location }, "template"), client)
+    end
+    
+  end
+  
+  # A tc Server template
+  class Template < Shared::Resource
+
+    # The template's version
+    attr_reader :version
+    
+    # The template's name
+    attr_reader :name
+
+    # The template image, if any, that this template was created from
+    attr_reader :template_image
+
+    # The template's installation
+    attr_reader :installation
+
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+
+      @version = details["version"]
+      @name = details["name"]
+
+      template_image_location = Util::LinkUtils.get_link_href(details, "template-image")
+      if (!template_image_location.nil?)
+        @template_image = TemplateImage.new(template_image_location, client)
+      end
+
+      @installation = Installation.new(Util::LinkUtils.get_link_href(details, 'installation'), client)
+
+    end
+    
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name' version='#@version'>"
+    end
+    
+  end
+  
+end

data/lib/vas/util/client.rb

@@ -0,0 +1,159 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# 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 Util #:nodoc: all
+
+  class Client
+  
+    TASK_POLLING_INTERVAL = 1
+  
+    def initialize(username, password)
+      @username = username
+      @password = password
+    end
+  
+    def get(location)
+  
+      req = Net::HTTP::Get.new(location)
+  
+      do_request(req) { |res|
+        case res.code
+          when "200"
+            return JSON.parse(res.body)
+          else
+            raise_vas_exception(res)
+        end
+      }
+  
+    end
+  
+    def get_stream(location, &block)
+  
+      req = Net::HTTP::Get.new(location)
+  
+      do_request(req) { |res|
+        case res.code
+          when "200"
+            return res.read_body(&block)
+          else
+            raise_vas_exception(res)
+        end
+      }
+  
+    end
+  
+    def delete(location)
+      req = Net::HTTP::Delete.new(location)
+  
+      do_request(req) { |res|
+        case res.code
+          when "200"
+            return
+          when "202"
+            await_task(res["Location"])
+          else
+            raise_vas_exception(res)
+        end
+      }
+    end
+  
+    def post(location, payload, rel = nil)
+  
+      req = Net::HTTP::Post.new(location)
+  
+      req['Content-Type'] = "application/json"
+      req.body = payload.to_json
+  
+      do_request(req) { |res|
+        case res.code
+          when "202"
+            return await_task(res["Location"], rel)
+          else
+            raise_vas_exception(res)
+        end
+      }
+    end
+  
+    def post_image(location, path, metadata = nil)
+      File.open(path) { |image|
+        if (metadata.nil?)
+          req = Net::HTTP::Post::Multipart.new(location, :data => UploadIO.new(image, "application/octet-stream"))
+        elsif
+          req = Net::HTTP::Post::Multipart.new(location, :data => UploadIO.new(image, "application/octet-stream"), :metadata => UploadIO.new(StringIO.new(metadata.to_json), "application/json", "metadata.json"))
+        end
+
+        do_request(req) { |res|
+          case res.code
+            when "201"
+              return res["Location"]
+            else
+              raise_vas_exception(res)
+          end
+        }
+      }
+    end
+  
+    private
+    def do_request(req)
+      req.basic_auth(@username, @password)
+
+      uri = URI(req.path)
+
+      https = Net::HTTP.new(uri.host, uri.port)
+      https.use_ssl = true
+      https.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+      https.start() { |https|
+        https.request(req) { |res|
+          yield res
+        }
+      }
+  
+    end
+  
+    def await_task(task_location, rel = nil)
+      while true
+        task = get(task_location)
+        case task["status"]
+          when "PENDING"
+          when "IN_PROGRESS"
+            sleep TASK_POLLING_INTERVAL
+          when "SUCCESS"
+            if rel
+              return LinkUtils.get_link_hrefs(task, rel)[0]
+            else
+              return
+            end
+          else
+            raise VasException.new([task["message"], task["detail"]])
+        end
+      end
+    end
+  
+    def raise_vas_exception(res)
+      messages = []
+      begin
+        json = JSON.parse(res.body)
+        json["reasons"].each { |reason| messages << reason["message"]}
+      ensure
+        raise VasException.new(messages, res.code)
+      end
+    end
+    
+  end
+  
+end