vas 0.3.0

data/lib/vas/tc_server/groups.rb

@@ -0,0 +1,42 @@
+#--
+# 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 groups.
+  class Groups < Shared::Groups
+
+    def initialize(location, client) #:nodoc:#
+      super(location, client, Group)
+    end
+
+  end
+
+  # A tc Server group
+  class Group < Shared::MutableGroup
+
+    # The group's instances
+    attr_reader :instances
+
+    def initialize(location, client) #:nodoc:#
+      super(location, client, Node, Installations)
+      @instances = Instances.new(Util::LinkUtils.get_link_href(details, "group-instances"), client)
+    end
+
+  end
+
+end

data/lib/vas/tc_server/installation_images.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, create, and delete tc Server installation images.
+  class InstallationImages < Shared::InstallationImages
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, InstallationImage)
+    end
+
+  end
+  
+  # A tc Server installation image
+  class InstallationImage < Shared::InstallationImage
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Installation)
+    end
+
+  end
+
+end

data/lib/vas/tc_server/installations.rb

@@ -0,0 +1,54 @@
+#--
+# 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 installations.
+  class Installations < Shared::Installations
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client, Installation)
+    end
+    
+  end
+  
+  # A tc Server installation
+  class Installation < Shared::Installation
+
+    # The versions of the tc Server runtime that are supported by the installation
+    attr_reader :runtime_versions
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, InstallationImage, Group)
+
+      @runtime_versions = details["runtime-versions"]
+      @templates_location = Util::LinkUtils.get_link_href(details, "templates")
+    end
+    
+    # The installation's templates
+    def templates
+      Templates.new(@templates_location, client)
+    end
+
+    # An array of the instances that are using the installation
+    def instances
+      retrieve_instances("group-instance", Instance);
+    end
+    
+  end
+  
+end

data/lib/vas/tc_server/instances.rb

@@ -0,0 +1,102 @@
+#--
+# 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 instances.
+  class Instances < Shared::MutableCollection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "group-instances", Instance)
+    end
+
+    # Creates a new instance named +name+, using the Installation +installation+.
+    # Creation can be customized using +options+.
+    #
+    # Recognized options are:
+    #
+    # properties::      A hash of properties
+    # runtime_version:: The version of the runtime to be used by the instance.
+    #                   Must be one of the runtime_versions available in the Installation.
+    #                   Defaults to the latest available version.
+    # templates::       An array of templates to use when creating the instance. Each Template
+    #                   must be present in the Installation.
+    # layout::          The layout to use when creating the instance. Valid values are +COMBINED+
+    #                   and +SEPARATE+. Defaults to +SEPARATE+.
+    def create(installation, name, options = {})
+      payload = { :installation => installation.location, :name => name }
+      
+      if options.has_key?(:properties)
+        payload[:properties] = options[:properties]
+      end
+      
+      if options.has_key?(:runtime_version)
+        payload["runtime-version"] = options[:runtime_version]
+      end
+      
+      if options.has_key?(:templates)
+        template_locations = []
+        options[:templates].each { |template| template_locations << template.location }
+        payload[:templates] = template_locations
+      end
+      
+      if options.has_key?(:layout)
+        payload[:layout] = options[:layout]
+      end
+      
+      Instance.new(client.post(location, payload, "group-instance"), client)
+    end
+
+  end
+
+  # A tc Server instance
+  class Instance < Shared::Instance
+    
+    # The instance's layout
+    attr_reader :layout
+    
+    # The version of runtime used by the instance
+    attr_reader :runtime_version
+    
+    # The instance's services
+    attr_reader :services
+
+    # The instance's Applications
+    attr_reader :applications
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Group, Installation, LiveConfigurations, PendingConfigurations, NodeInstance, 'node-instance')
+
+      @layout = details["layout"]
+      @runtime_version = details["runtime-version"]
+      @services = details["services"]
+      @applications = Applications.new(Util::LinkUtils.get_link_href(details, "group-applications"), client)
+
+    end
+
+    # Updates the instance to use the given +installation+ and, optionally, to use the given +runtime_version+
+    def update(installation, runtime_version = nil)
+      payload = { :installation => installation.location }
+      if (!runtime_version.nil?)
+        payload['runtime-version'] = runtime_version
+      end
+      client.post(location, payload);
+    end
+
+  end
+
+end

data/lib/vas/tc_server/live_configurations.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
+
+  # Used to enumerate an instance's live configuration
+  class LiveConfigurations < Shared::Collection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "live-configurations", Configuration)
+    end
+
+  end
+
+end

data/lib/vas/tc_server/logs.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 a tc Server node instance's logs
+  class Logs < Shared::Logs
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Log)
+    end
+
+  end
+
+  # A log file in a tc Server node instance
+  class Log < Shared::Log
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, 'node-instance', NodeInstance)
+    end
+
+  end
+
+end

data/lib/vas/tc_server/node_applications.rb

@@ -0,0 +1,76 @@
+#--
+# 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 a NodeInstance's NodeApplication s
+  class NodeApplications < Shared::Collection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "applications", NodeApplication)
+    end
+
+  end
+
+  # A node application
+  class NodeApplication < 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 NodeRevisions
+    attr_reader :revisions
+
+    # The Application that this node application is a member of
+    attr_reader :group_application
+
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+
+      @revisions = NodeRevisions.new(Util::LinkUtils.get_link_href(details, "node-revisions"), client)
+
+      @context_path = details["context-path"]
+      @name = details["name"]
+      @service = details["service"]
+      @host = details["host"]
+
+      @instance_location = Util::LinkUtils.get_link_href(details, "node-instance")
+
+      @group_application = Application.new(Util::LinkUtils.get_link_href(details, "group-application"), client)
+    end
+
+    # The node instance that contains the application
+    def instance
+      NodeInstance.new(@instance_location, client)
+    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/node_instances.rb

@@ -0,0 +1,55 @@
+#--
+# 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 instances on an individual node
+  class NodeInstances < Shared::NodeInstances
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "node-instances", NodeInstance)
+    end
+
+  end
+
+  # A tc Server node instance
+  class NodeInstance < Shared::NodeInstance
+    
+    # The instance's layout
+    attr_reader :layout
+    
+    # The version of runtime used by the instance
+    attr_reader :runtime_version
+    
+    # The instance's services
+    attr_reader :services
+
+    # The instance's NodeApplications
+    attr_reader :applications
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Node, Logs, Instance, 'group-instance')
+
+      @layout = details["layout"]
+      @runtime_version = details["runtime-version"]
+      @services = details["services"]
+      @applications = NodeApplications.new(Util::LinkUtils.get_link_href(details, "node-applications"), client)
+    end
+
+  end
+
+end

data/lib/vas/tc_server/node_revisions.rb

@@ -0,0 +1,55 @@
+#--
+# 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 Node Revision s
+  class NodeRevisions < Shared::Collection
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client, 'revisions', NodeRevision)
+    end
+    
+  end
+
+  # A revision of a NodeApplication
+  class NodeRevision < Shared::StateResource
+
+    # The Revision's version
+    attr_reader :version
+
+    # The Revision's application
+    attr_reader :application
+
+    # The revision's group revision
+    attr_reader :group_revision
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client)
+      
+      @version = details['version']
+      @application = NodeApplication.new(Util::LinkUtils.get_link_href(details, 'node-application'), client)
+      @group_revision = Revision.new(Util::LinkUtils.get_link_href(details, 'group-revision'), client)
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} version='#@version'>"
+    end
+
+  end
+
+end