vas 0.3.0

data/lib/vas/shared/mutable_collection.rb

@@ -0,0 +1,27 @@
+#--
+# 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 Shared
+  class MutableCollection < Collection
+
+    # Deletes the item
+    def delete(entry)
+      client.delete(entry.location)
+    end
+
+  end
+end

data/lib/vas/shared/node_instances.rb

@@ -0,0 +1,58 @@
+#--
+# 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 Shared
+
+  class NodeInstances < Shared::Collection
+
+    def initialize(location, client, type, entry_class) #:nodoc:
+      super(location, client, type, entry_class)
+    end
+
+  end
+
+  class NodeInstance < Shared::StateResource
+
+    # The instance's name
+    attr_reader :name
+
+    # The node that contains this instance
+    attr_reader :node
+
+    # The instance's Logs
+    attr_reader :logs
+
+    # The node instance's group instance
+    attr_reader :group_instance
+
+    def initialize(location, client, node_class, logs_class, group_instance_class, group_instance_type) #:nodoc:
+      super(location, client)
+
+      @name = details["name"]
+
+      @node = node_class.new(Util::LinkUtils.get_link_href(details, "node"), client)
+      @logs = logs_class.new(Util::LinkUtils.get_link_href(details, "logs"), client)
+      @group_instance = group_instance_class.new(Util::LinkUtils.get_link_href(details, group_instance_type), client)
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name'>"
+    end
+
+  end
+
+end

data/lib/vas/shared/nodes.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 Shared
+
+  # A node
+  class Node < Shared::Resource
+    
+    # The location of the vFabric Administration agent
+    attr_reader :agent_home
+    
+    # The architecture of the node's operating system
+    attr_reader :architecture
+    
+    # The node's host names
+    attr_reader :host_names
+    
+    # The node's IP addresses
+    attr_reader :ip_addresses
+    
+    # The node's metadata
+    attr_reader :metadata
+    
+    # The node's operating system
+    attr_reader :operating_system
+
+    def initialize(location, client)  #:nodoc:
+      super(location, client)
+      
+      @agent_home = details["agent-home"]
+      @architecture = details["architecture"]
+      @host_names = details["host-names"]
+      @ip_addresses = details["ip-addresses"]
+      @metadata = details["metadata"]
+      @operating_system = details["operating-system"]
+    end
+
+  end
+
+  class GroupableNode < Node
+
+    def initialize(location, client, group_class)
+      super(location, client)
+      @group_class = group_class
+    end
+
+    # An array of the groups which contain this node
+    def groups
+      groups = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), 'group').each {
+          |group_location| groups << @group_class.new(group_location, client)}
+      groups
+    end
+  end
+
+end

data/lib/vas/shared/pending_configuration.rb

@@ -0,0 +1,40 @@
+#--
+# 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 Shared
+
+  class PendingConfigurations < MutableCollection
+
+    # Creates a configuration with the given +path+ in the instance and the given +content+
+    def create(path, content)
+      entry_class.new(client.post_image(location, content, { :path => path }), client)
+    end
+
+  end
+
+  # A configuration file that is pending and will be made live the next time its instance is started
+  class PendingConfiguration < Configuration
+
+    # Updates the configuration to contain +new_content+
+    def content=(new_content)
+      client.post(content_location, new_content)
+      @size = client.get(location)['size']
+    end
+
+  end
+
+end

data/lib/vas/shared/resource.rb

@@ -0,0 +1,44 @@
+#--
+# 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 Shared
+  
+  class Resource
+    
+    attr_reader :location #:nodoc:
+  
+    # The Resource's Security
+    attr_reader :security
+
+    private
+    attr_reader :client
+
+    attr_reader :details
+    
+    def initialize(location, client)  #:nodoc:
+      @location = location
+      @client = client
+
+      @details = client.get(location)
+
+      @security = Security.new(Util::LinkUtils.get_link_href(@details, 'security'), client)
+
+    end
+  
+  end
+  
+end

data/lib/vas/shared/security.rb

@@ -0,0 +1,51 @@
+#--
+# 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 Shared
+  
+  # The security configuration for a resource
+  class Security
+
+    # The permissions of the resource
+    attr_reader :permissions
+
+    # The owner of the resource
+    attr_reader :owner
+
+    # The group of the resource
+    attr_reader :group
+
+    attr_reader :location #:nodoc:
+
+    private
+    attr_reader :client
+  
+    def initialize(location, client) #:nodoc:
+      json = client.get(location)
+      @location = location;
+      @owner = json["owner"]
+      @group = json["group"]
+      @permissions = json["permissions"]
+    end
+  
+    def to_s #:nodoc:
+      "#<#{self.class} owner='#@owner' group='#@group' permissions='#@permissions'>"
+    end
+    
+  end
+  
+end

data/lib/vas/shared/state_resource.rb

@@ -0,0 +1,44 @@
+#--
+# 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 Shared
+  
+  class StateResource < Resource
+
+    def initialize(location, client)  #:nodoc:
+      super(location, client)
+      @state_location = Util::LinkUtils.get_link_href(details, 'state')
+    end
+
+    # Starts the resource
+    def start
+      client.post(@state_location, { :status => 'STARTED' })
+    end
+
+    # Stops the resource
+    def stop
+      client.post(@state_location, { :status => 'STOPPED' })
+    end
+
+    # The state of the resource
+    def state
+      client.get(@state_location)['status']
+    end
+  
+  end
+  
+end

data/lib/vas/tc_server/applications.rb

@@ -0,0 +1,89 @@
+#--
+# 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 applications.
+  class Applications < Shared::MutableCollection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "applications", Application)
+    end
+
+    # Creates an Application named +name+ with the given +context_path+. The application will deploy its revisions to the given
+    # +service+ and +host+.
+    def create(name, context_path, service, host)
+      Application.new(client.post(location, {"context-path" => context_path, :name => name, :host => host, :service => service}, "group-application"), client)
+    end
+
+    private
+    def create_entry(json)
+      Application.new(Util::LinkUtils.get_self_link_href(json), client)
+    end
+  end
+
+  # An application
+  class Application < Shared::Resource
+
+    # The application's context path
+    attr_reader :context_path
+
+    # The application's name
+    attr_reader :name
+
+    # The service the application will deploy its revisions to
+    attr_reader :service
+
+    # The host the application will deploy its revisions to
+    attr_reader :host
+
+    # The application's Revisions
+    attr_reader :revisions
+
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+
+      @revisions = Revisions.new(Util::LinkUtils.get_link_href(details, "group-revisions"), client)
+
+      @context_path = details["context-path"]
+      @name = details["name"]
+      @service = details["service"]
+      @host = details["host"]
+
+      @instance_location = Util::LinkUtils.get_link_href(details, "group-instance")
+    end
+
+    # The instance that contains the application
+    def instance
+      Instance.new(@instance_location, client)
+    end
+
+    # An array of the application's individual node applications
+    def node_applications
+      node_applications = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), 'node-application').each {
+          |node_application_location| node_applications << NodeApplication.new(node_application_location, client)}
+      node_applications
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name' context_path='#@context_path' service='#@service' host='#@host'>"
+    end
+
+  end
+
+end

data/lib/vas/tc_server/configuration.rb

@@ -0,0 +1,29 @@
+#--
+# 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
+
+  # A configuration file in a tc Server instance
+  class Configuration < Shared::Configuration
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "group-instance", Instance)
+    end
+
+  end
+
+end