Class | Net::SSH::Multi::DynamicServer |
In: |
lib/net/ssh/multi/dynamic_server.rb
|
Parent: | Object |
Represents a lazily evaluated collection of servers. This will usually be created via Net::SSH::Multi::Session#use(&block), and is useful for creating server definitions where the name or address of the servers are not known until run-time.
session.use { lookup_ip_address_of_server }
This prevents lookup_ip_address_of_server from being invoked unless the server is actually needed, at which point it is invoked and the result cached.
The callback should return either nil (in which case no new servers are instantiated), a String (representing a connection specification), an array of Strings, or an array of Net::SSH::Multi::Server instances.
callback | [R] | The Proc object to call to evaluate the server(s) |
master | [R] | The Net::SSH::Multi::Session instance that owns this dynamic server record. |
options | [R] | The hash of options that will be used to initialize the server records. |
Create a new DynamicServer record, owned by the given Net::SSH::Multi::Session master, with the given hash of options, and using the given Proc callback to lazily evaluate the actual server instances.
Returns the value for the given key in the :properties hash of the options. If no :properties hash exists in options, this returns nil.
Sets the given key/value pair in the +:properties+ key in the options hash. If the options hash has no :properties key, it will be created.
Iterates over every instantiated server record in this dynamic server. If the servers have not yet been instantiated, this does nothing (e.g., it does not automatically invoke evaluate!).