right_agent 2.0.7-x86-mingw32

data/lib/right_agent/core_payload_types/recipe_instantiation.rb

@@ -0,0 +1,73 @@
+#
+# Copyright (c) 2009-2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightScale
+
+  # Recipe with json
+  class RecipeInstantiation
+
+    include Serializable
+
+    # (String) Recipe nickname
+    attr_accessor :nickname
+
+    # (Hash) Recipe override attributes (JSON string for RightLink v5.0)
+    attr_accessor :attributes
+
+    # (Integer) Recipe id
+    attr_accessor :id
+
+    # (Boolean) Whether recipe inputs are ready
+    attr_accessor :ready
+
+    # (Array of SecureDocumentLocation) attributes that must be resolved by the instance
+    attr_accessor :external_inputs
+
+    # (Hash) nil or Hash of input name to flags (array of string tokens) indicating additional
+    # boolean properties of the input which are useful to the instance. the presence of the
+    # flag means true, absence means false.
+    attr_accessor :input_flags
+
+    def initialize(*args)
+      @nickname        = args[0] if args.size > 0
+      @attributes      = args[1] if args.size > 1
+      @id              = args[2] if args.size > 2
+      @ready           = args[3] if args.size > 3
+      @external_inputs = args[4] if args.size > 4
+      @input_flags     = args[5] if args.size > 5
+    end
+
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @nickname, @attributes, @id, @ready, @external_inputs, @input_flags ]
+    end
+
+    # Human readable title
+    #
+    # === Return
+    # @return [String] title for display
+    def title
+      nickname
+    end
+  end
+end

data/lib/right_agent/core_payload_types/repositories_bundle.rb

@@ -0,0 +1,50 @@
+#
+# Copyright (c) 2009-2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightScale
+  
+  # Software repositories together with audit id
+  # The instance agent can use the audit created by the core agent to audit messages
+  # associated with the processing of the software repositories
+  class RepositoriesBundle
+
+    include Serializable
+
+    # (Array) Repositories instantiations
+    attr_accessor :repositories
+
+    # (Integer) ID of corresponding audit entry
+    attr_accessor :audit_id
+
+    def initialize(*args)
+      @repositories = args[0]
+      @audit_id     = args[1]
+    end
+    
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @repositories, @audit_id ]
+    end
+
+  end
+end

data/lib/right_agent/core_payload_types/right_script_attachment.rb

@@ -0,0 +1,95 @@
+#
+# Copyright (c) 2009-2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+require 'digest/sha1'
+require 'uri'
+
+module RightScale
+
+  # RightScript attachment
+  class RightScriptAttachment
+
+    include Serializable
+
+    # (String) S3 attachment URL
+    attr_accessor :url
+
+    # (String) Attachment file name
+    attr_accessor :file_name
+
+    # (String) Cache identifier
+    attr_accessor :etag
+
+    # (Binary string) Repose token for attachment
+    attr_accessor :token
+
+    # (String) Content digest
+    attr_accessor :digest
+
+    def initialize(*args)
+      @url       = args[0] if args.size > 0
+      @file_name = args[1] if args.size > 1
+      @etag      = args[2] if args.size > 2
+      @token     = args[3] if args.size > 3
+      @digest    = args[4] if args.size > 4
+    end
+
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @url, @file_name, @etag, @token, @digest ]
+    end
+
+    # Return the Repose hash for this attachment.
+    def to_hash
+      RightScriptAttachment.hash_for(@url, @file_name, @etag)
+    end
+
+    # Fill out the session cookie appropriately for this attachment.
+    def fill_out(session)
+      session['scope'] = "attachments"
+      if @digest
+        session['resource'] = @digest
+      else
+        session['resource'] = to_hash
+        session['url'] = @url
+        session['etag'] = @etag
+      end
+      @token = session.to_s
+    end
+
+    # Return the Repose hash for the given URL/filename/ETag triple.
+    #
+    # === Parameters
+    # url(String):: URL to request
+    # filename(String):: local filename
+    # etag(String):: expected ETag
+    #
+    # === Return
+    # String:: hashed token suitable for communicating to Repose
+    def self.hash_for(url, filename, etag)
+      uri = URI::parse(url).dup
+      uri.query = nil
+      Digest::SHA1.hexdigest("#{uri}\000#{etag}")
+    end
+  end
+end

data/lib/right_agent/core_payload_types/right_script_instantiation.rb

@@ -0,0 +1,94 @@
+#
+# Copyright (c) 2009-2013 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightScale
+  
+  # RightScript with parameters and attachments
+  class RightScriptInstantiation
+
+    include Serializable  
+
+    # (String) RightScript name
+    attr_accessor :nickname
+
+    # (String) RightScript source
+    attr_accessor :source
+
+    # (Hash) RightScript parameters
+    # Hash of parameters names with associated value
+    attr_accessor :parameters  
+    
+    # (Array) RightScript attachments URLs, array of RightScriptAttachment
+    attr_accessor :attachments
+    
+    # (String) RightScripts required packages as a space-delimited list of package names or empty
+    attr_accessor :packages
+
+    # (Integer) RightScript id
+    attr_accessor :id
+
+    # (Boolean) Whether script inputs are ready
+    attr_accessor :ready
+
+    # (Hash) a map of input names to CredentialLocations which must be retrieved by the instance or nil or empty
+    attr_accessor :external_inputs
+
+    # (Hash) nil or Hash of input name to flags (array of string tokens) indicating additional
+    # boolean properties of the input which are useful to the instance. the presence of the
+    # flag means true, absense means false.
+    attr_accessor :input_flags
+
+    # (String) Displayable version for RightScript (revision, etc.) or nil
+    attr_accessor :display_version
+
+    def initialize(*args)
+      @nickname        = args[0] if args.size > 0
+      @source          = args[1] if args.size > 1
+      @parameters      = args[2] if args.size > 2
+      @attachments     = args[3] if args.size > 3
+      @packages        = args[4] if args.size > 4
+      @id              = args[5] if args.size > 5
+      @ready           = args[6] if args.size > 6
+      @external_inputs = args[7] if args.size > 7
+      @input_flags     = args[8] if args.size > 8
+      @display_version = args[9] if args.size > 9
+    end
+    
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @nickname, @source, @parameters, @attachments, @packages, @id, @ready, @external_inputs, @input_flags, @display_version ]
+    end
+
+    # Human readable title
+    #
+    # === Return
+    # @return [String] title for display
+    def title
+      if @display_version
+        "'#{nickname}' #{@display_version}"
+      else
+        nickname
+      end
+    end
+  end
+end

data/lib/right_agent/core_payload_types/runlist_policy.rb

@@ -0,0 +1,44 @@
+#
+# Copyright (c) 2009-2012 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightScale
+
+  class RunlistPolicy
+    include Serializable
+    
+    attr_accessor :policy_name, :thread_name, :audit_period
+
+    # Initialize fields from given arguments
+    def initialize(*args)
+      @policy_name     = args[0]
+      @thread_name     = args[1]
+      @audit_period    = args[2]
+    end
+
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @policy_name, @thread_name, @audit_period ]
+    end
+
+  end
+end

data/lib/right_agent/core_payload_types/secure_document.rb

@@ -0,0 +1,66 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightScale
+
+  # Class encapsulating the actual value of a credential.
+  class SecureDocument
+
+    include Serializable
+
+    # (String) Namespace-unique identifier for this credential value
+    attr_accessor :name
+
+    # (Integer) Monotonic version number of this document
+    attr_accessor :version
+
+    # The content of this document; if envelope_mime_type is not nil, then this value
+    # is actually an envelope that contains the document value
+    attr_accessor :content
+
+    # (String) Name of the storage policy used to encrypt this document (if any).
+    attr_accessor :storage_policy_name
+
+    # (String) MIME type of the document itself e.g. "text/plain"
+    attr_accessor :mime_type
+
+    # (String) MIME type of the value's envelope, e.g. an encoding or encryption format,
+    # or nil if there is no envelope MIME type.
+    attr_accessor :envelope_mime_type
+
+    # Initialize fields from given arguments
+    def initialize(*args)
+      @name                = args[0] if args.size > 0
+      @version             = args[1] if args.size > 1
+      @content             = args[2] if args.size > 2
+      @storage_policy_name = args[3] if args.size > 3
+      @mime_type           = args[4] if args.size > 4
+      @envelope_mime_type  = args[5] if args.size > 5
+    end
+
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @name, @version, @content, @storage_policy_name, @mime_type, @envelope_mime_type ]
+    end
+  end
+end

data/lib/right_agent/core_payload_types/secure_document_location.rb

@@ -0,0 +1,63 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightScale
+
+  # Everything necessary to retrieve a SecureDocument from a RightNet agent.
+  class SecureDocumentLocation
+
+    include Serializable
+
+    # (String):: Namespace within which the document resides
+    attr_accessor :namespace
+
+    # (String):: Namespace-unique identifier of the document that should be retrieved.
+    attr_accessor :name
+
+    # (Integer):: Monotonic version of the document to be requested
+    attr_accessor :version
+
+    # (String):: Access token that should be used to fetch the document
+    attr_accessor :ticket
+
+    # Array(String):: Identities of RightNet agents capable of providing the document.
+    # If nil, then no target should be specified when sending RightNet requests;
+    # this is used to route requests to "trusted infrastructure" nodes at the
+    # discretion of the RightNet router.
+    attr_accessor :targets
+
+    # Initialize fields from given arguments
+    def initialize(*args)
+      @namespace = args[0] if args.size > 0
+      @name      = args[1] if args.size > 1
+      @version   = args[2] if args.size > 2
+      @ticket    = args[3] if args.size > 3
+      @targets   = args[4] if args.size > 4
+    end
+
+    # Array of serialized fields given to constructor
+    def serialized_members
+      [ @namespace, @name, @version, @ticket, @targets ]
+    end
+  end
+end