aws_sdk 3.1.5

data/lib/aws/elb/config.rb

@@ -0,0 +1,18 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. 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. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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.
+
+AWS::Core::Configuration.module_eval do
+
+  add_service 'ELB', 'elb', 'elasticloadbalancing.us-east-1.amazonaws.com'
+
+end

data/lib/aws/elb/errors.rb

@@ -0,0 +1,26 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. 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. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class ELB
+    module Errors
+
+      extend Core::LazyErrorClasses
+
+      def self.error_class code 
+        super(code.sub(/^ElasticLoadBalancing\./, ''))
+      end
+
+    end
+  end
+end

data/lib/aws/elb/instance_collection.rb

@@ -0,0 +1,174 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. 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. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class ELB
+
+    class InstanceCollection
+      
+      include Core::Collection::Simple
+
+      def initialize load_balancer, options = {}
+        @load_balancer = load_balancer
+        super
+      end
+
+      # Returns an {EC2::Instance} object with 3 extra methods added:
+      #
+      # * +#load_balancer+
+      #
+      # * +#remove_from_load_balancer+
+      #
+      # * +#elb_health+
+      #
+      # See {#health} for more information about what +#elb_health+ returns.
+      #
+      # @return [EC2::Instance] Return an EC2::Instance object with additional
+      #   methods added.
+      #
+      def [] instance_id
+
+        load_balancer = self.load_balancer
+
+        instance = EC2.new(:config => config).instances[instance_id]
+
+        Core::MetaUtils.extend_method(instance, :load_balancer) do
+          load_balancer
+        end
+
+        Core::MetaUtils.extend_method(instance, :elb_health) do
+          health = load_balancer.instances.health(id).first
+          health.delete(:instance)
+          health
+        end
+
+        Core::MetaUtils.extend_method(instance, :remove_from_load_balancer) do
+          load_balancer.instances.deregister(self)
+        end
+
+        instance
+        
+      end
+
+      # Returns an array of instance health descriptions.  Each description
+      # is a hash with the following entries:
+      #
+      #   * +:instance+ - The {EC2::Instance} being described.
+      #
+      #   * +:description+ - Provides a description of the instance.
+      #
+      #   * +:state+ - Specifies the current state of the instance.
+      #
+      #   * +:reason_code+ - Provides information about the cause of 
+      #     OutOfService instances. Specifically, it indicates whether the 
+      #     cause is Elastic Load Balancing or the instance behind the 
+      #     load balancer.
+      #
+      # You can get the health of all instances for this load balancer
+      # by passing no arguments to this method:
+      #
+      #   # get the health of all instances in the collection
+      #   load_balancer.instances.health.each do |instance_health|
+      #      puts "Instance: "    + instance_health[:instance].id
+      #      puts "description: " + instance_health[:description]
+      #      puts "state: "       + instance_health[:state]
+      #      puts "reason code: " + instance_health[:reason_code]
+      #   end
+      #
+      # If you want the health of a specific list of instances, pass
+      # instance ids or instance objects to this method:
+      #
+      #   # get the health for a few specific instances
+      #   load_balancer.instances.health('i-12345', 'i-67890').each{|h| ... }
+      #
+      # == Health for a Single Instance
+      #
+      # If you want the health of a single instance you can use the {#[]} 
+      # instead:
+      #
+      #   load_balancer.instances['i-123456'].elb_health
+      #   # => { :state => ..., :reason_code => ..., :description => ... }
+      #
+      # @param [String,EC2::Instance] instances A list of instances to
+      #   receive health information for.
+      #
+      # @return [Array<Hash>] Returns an array of hashes.  Each hash represents
+      #   the health of a single instance.  Each hash includes the following
+      #   entries:
+      #
+      def health *instances
+
+        instance_ids = instance_ids(instances)
+
+        opts = {}
+        opts[:load_balancer_name] = load_balancer.name
+        opts[:instances] = instance_ids unless instance_ids.empty?
+
+        client.describe_instance_health(opts).instance_states.map do |state|
+          {
+            :instance => self[state.instance_id],
+            :description => state.description,
+            :state => state.state,
+            :reason_code => state.reason_code,
+          }
+        end
+
+      end
+
+      # @return [LoadBalancer] Returns the load balancer this collection 
+      #   belongs to.
+      attr_reader :load_balancer
+
+      def register *instances
+
+        client.register_instances_with_load_balancer(
+          :load_balancer_name => load_balancer.name,
+          :instances => instance_ids(instances))
+
+        nil
+
+      end
+      alias_method :add, :register
+
+      def deregister *instances
+
+        client.deregister_instances_from_load_balancer(
+          :load_balancer_name => load_balancer.name,
+          :instances => instance_ids(instances))
+
+        nil
+
+      end
+      alias_method :remove, :deregister
+
+      protected
+      def instance_ids instances
+        instances.flatten.collect do |instance|
+          case instance
+          when EC2::Instance then { :instance_id => instance.id }
+          else { :instance_id => instance }
+          end
+        end
+      end
+
+      protected
+      def _each_item options = {}
+        load_balancer.instance_descriptions.each do |instance|
+          instance = self[instance.instance_id]
+          yield(instance)
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/elb/listener.rb

@@ -0,0 +1,189 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. 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. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class ELB
+
+    class Listener
+
+      include Core::Model
+
+      # @param [LoadBalancer] load_balancer The load balancer this listener
+      #   belongs to.
+      #
+      # @param [Integer] port The external load balancer port number.
+      #
+      # @param [Hash] options
+      #
+      # @option (see ListenerCollection#create)
+      #
+      def initialize load_balancer, port, options = {}
+
+        @load_balancer = load_balancer
+        @port = port.to_i
+        @protocol = options[:protocol]
+        @instance_port = options[:instance_port]
+        @instance_protocol = options[:instance_protocol]
+
+        super
+
+      end
+
+      # @return [LoadBalancer]
+      attr_reader :load_balancer
+
+      # @return [Integer] 
+      attr_reader :port
+
+      # @return [Symbol] Returns the protocl for this listener.
+      def protocol
+        proto = @protocol || _description.listener.protocol
+        proto.to_s.downcase.to_sym
+      end
+
+      # @return [Integer]
+      def instance_port
+        @instance_port || _description.listener.instance_port
+      end
+
+      # @return [Symbol]
+      def instance_protocol
+        proto = @instance_protocol || _description.listener.instance_protocol
+        proto.to_s.downcase.to_sym
+      end
+
+      # Sets the certificate that terminates the specified listener's SSL 
+      # connections. The specified certificate replaces any prior 
+      # certificate for this listener.
+      #
+      # @param [String,IAM::ServerCertificate] server_certificate The ARN 
+      #   of an IAM::ServerCertificate or an IAM::ServerCertificate object.
+      #
+      # @return [nil]
+      #
+      def server_certificate= server_certificate
+
+        arn = server_certificate.is_a?(IAM::ServerCertificate) ?
+          server_certificate.arn : server_certificate
+
+        client.set_load_balancer_listener_ssl_certificate(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_port => port,
+          :ssl_certificate_id => arn)
+
+        nil
+
+      end
+
+      # @return [IAM::ServerCertificate,nil] Returns the IAM::ServerCertificate
+      #   associated with this listener, or nil if there is none.
+      def server_certificate
+        desc = _description
+        if desc.listener.respond_to?(:ssl_certificate_id)
+          AWS.memoize do
+            arn = desc.listener.ssl_certificate_id
+            iam = IAM.new(:config => config)
+            iam.server_certificates.find{|cert| cert.arn == arn }
+          end
+        else
+          nil
+        end
+      end
+
+      # @return [LoadBalancerPolicy,nil] Returns the current policy for this
+      #   listener.  Returns nil if no load balancer policy has been 
+      #   associated with it.
+      def policy
+        policy_name = _description.policy_names.first
+        policy_name ? load_balancer.policies[policy_name] : nil
+      end
+
+      # @param [String,LoadBalancerPolicy] policy_or_policy_name Sets
+      #   the policy for this listener.
+      # @return [LoadBalancerPolicy]
+      def policy= policy_or_policy_name
+
+        policy_name = policy_or_policy_name.is_a?(LoadBalancerPolicy) ?
+          policy_or_policy_name.name : policy_or_policy_name.to_s
+      
+        client.set_load_balancer_policies_of_listener(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_port => port,
+          :policy_names => [policy_name])
+
+        LoadBalancerPolicy.new(load_balancer, policy_name, :config => config)
+
+      end
+
+      # Removes the current policy from this listener.
+      # @return [nil]
+      def remove_policy
+
+        client.set_load_balancer_policies_of_listener(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_port => port,
+          :policy_names => [])
+
+        nil
+
+      end
+
+      # Returns true if this listener exists.
+      #
+      #   load_balancer = ELB.new.load_balancers['my-load-balancer']
+      #   listener = load_balancer.listeners[80] # port 80
+      #   listener.exists?
+      #
+      # @return [Boolean] Returns true if the load balancer has a listener
+      #   on this port.
+      def exists?
+        !_description.nil?
+      rescue AWS::Core::Resource::NotFound
+        false
+      end
+
+      # Deletes the listener from its load balancer.
+      # @return [nil]
+      def delete
+
+        client.delete_load_balancer_listeners(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_ports => [port])
+
+        nil
+
+      end
+
+      # @private
+      def inspect
+        "#{self.class.name} port:#{port}>"
+      end
+
+      # @private
+      def eql? other
+        other.is_a?(Listener) and 
+        other.load_balancer == load_balancer and
+        other.port == port
+      end
+      alias_method :==, :eql?
+
+      protected
+      def _description
+        load_balancer.listener_descriptions.find do |desc| 
+          desc.listener.load_balancer_port == port
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/elb/listener_collection.rb

@@ -0,0 +1,119 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. 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. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class ELB
+
+    class ListenerCollection
+
+      include ListenerOpts
+      include Core::Collection::Simple
+
+      def initialize load_balancer, options = {}
+        @load_balancer = load_balancer
+        super
+      end
+
+      # @return [LoadBalancer]
+      attr_reader :load_balancer
+
+      # @param [Hash] options
+      #
+      # @option options [Integer] :port Specifies the external
+      #   load balancer port number. This property cannot be modified for 
+      #   the life of the LoadBalancer.
+      #
+      # @option options [String,Symbol] :protocol Specifies the load balancer
+      #   transport protocol to use for routing.  Valid values include:
+      #
+      # @option options [Integer] :instance_port Specifies the TCP port on 
+      #   which the instance server is listening. This property cannot be 
+      #   modified for the life of the load balancer.
+      #
+      # @option options [String,Symbol] :instance_protocol Specifies the 
+      #   protocol to use for routing traffic to back-end instances.  Valid 
+      #   values include:
+      #
+      #   * :http, 'HTTP'
+      #   * :https, 'HTTPS'
+      #   * :tcp, 'TCP'
+      #   * :ssl, 'SSL'
+      #
+      #   This property cannot be modified for the life of the load balacner.
+      #
+      #   NOTE: If the front-end protocol is HTTP or HTTPS, +:instance_protocol+
+      #   has to be at the same protocol layer, i.e., HTTP or HTTPS. Likewise,
+      #   if the front-end protocol is TCP or SSL, +:instance_protocol+ has 
+      #   to be TCP or SSL.
+      #
+      #   NOTE: If there is another listener with the same +:instance_port+
+      #   whose +:instance_protocol+ is secure, i.e., HTTPS or SSL, the 
+      #   listener's +:instance_protocol+ has to be secure, i.e., HTTPS 
+      #   or SSL. If there is another listener with the same +:instance_port+
+      #   whose +:instance_protocol+ is HTTP or TCP, the listener's 
+      #   +:instance_protocol+ must be either HTTP or TCP.
+      #
+      #   * :tcp, 'TCP'
+      #   * :http, 'HTTP'
+      #
+      #   This property cannot be modified for the life of the load balancer.
+      #
+      # @option options [String,IAM::ServerCertificate] :server_certificate The
+      #   ARN string of an IAM::ServerCertifcate or an IAM::ServerCertificate 
+      #   object.  Reqruied for HTTPs listeners.
+      #
+      # @return [Listener]
+      def create options = {}
+        
+        format_listener_opts(options)
+
+        client.create_load_balancer_listeners(
+          :load_balancer_name => load_balancer.name,
+          :listeners => [options])
+
+        Listener.new(load_balancer, 
+          options[:load_balancer_port], 
+          options.merge(:config => config))
+
+      end
+
+      # @return [Listener]
+      def [] port
+        Listener.new(load_balancer, port, :config => config)
+      end
+
+      protected
+      def _each_item options = {}
+        load_balancer.listener_descriptions.each do |desc|
+
+          desc = desc.listener
+
+          opts = {}
+          opts[:config] = config
+          opts[:protocol] = desc.protocol
+          opts[:instance_port] =  desc.instance_port
+          opts[:instance_protocol] = desc.instance_protocol
+          opts[:ssl_certificate_id] = desc.ssl_certificate_id if
+            desc.respond_to?(:ssl_certificate_id)
+
+          listener = Listener.new(load_balancer, desc.load_balancer_port, opts)
+
+          yield(listener)
+
+        end
+      end
+      
+    end
+
+  end
+end