ansible-ruby 1.0.5 → 1.0.6

data/lib/ansible/ruby/modules/custom/files/fetch.rb

@@ -0,0 +1,15 @@
+# VALIDATED_CHECKSUM: XnE8GWD1W+6fTdW5t7bKPNb3fXbB03qRJOOfU5UjbUk=
+# See LICENSE.txt for license
+
+require 'ansible/ruby/modules/generated/core/files/fetch'
+
+module Ansible
+  module Ruby
+    module Modules
+      class Fetch
+        remove_existing_validations :flat
+        validates :flat, inclusion: { in: [:yes, :no], message: '%{value} needs to be :yes, :no' }, allow_nil: true
+      end
+    end
+  end
+end

data/lib/ansible/ruby/modules/custom/files/file.rb

@@ -0,0 +1,15 @@
+# VALIDATED_CHECKSUM: AdFa02QGpVTJzxok0diPJdAEUBApm3x9juB4vVByHyY=
+# see LICENSE.txt in project root
+
+require 'ansible/ruby/modules/generated/core/files/file'
+require 'ansible/ruby/modules/missing_file_stuff'
+
+module Ansible
+  module Ruby
+    module Modules
+      class File
+        include MissingFileStuff
+      end
+    end
+  end
+end

data/lib/ansible/ruby/modules/custom/files/template.rb

@@ -0,0 +1,15 @@
+# VALIDATED_CHECKSUM: uKMw8+w4NpzVQ2lgEzhz4oIL+HNRv+7w4fIDdY4IOc0=
+# see LICENSE.txt in project root
+
+require 'ansible/ruby/modules/generated/core/files/template'
+require 'ansible/ruby/modules/missing_file_stuff'
+
+module Ansible
+  module Ruby
+    module Modules
+      class Template
+        include MissingFileStuff
+      end
+    end
+  end
+end

data/lib/ansible/ruby/modules/custom/network/basics/get_url.rb

@@ -0,0 +1,26 @@
+# VALIDATED_CHECKSUM: 8ktTiahMAzMVSxRLVLLtblQnW5xqxnjEx/VLO7Z0mSQ=
+require 'ansible/ruby/modules/generated/core/network/basics/get_url'
+
+module Ansible
+  module Ruby
+    module Modules
+      class Get_url
+        remove_existing_validations :headers
+        # @return [Hash, nil] Add custom HTTP headers to a request in the format "key:value,key:value"
+        validates :headers, type: Hash
+
+        def to_h
+          result = super
+          data = result[:get_url]
+          # Ansible expects a string for some reason
+          if data.include? :headers
+            data[:headers] = data[:headers].map do |key, value|
+              "#{key}:#{value}"
+            end.join ','
+          end
+          result
+        end
+      end
+    end
+  end
+end

data/lib/ansible/ruby/modules/custom/utilities/logic/set_fact.rb

@@ -0,0 +1,23 @@
+# VALIDATED_CHECKSUM: ll8+xKFXcp3iwGYU5NT8lS5UILPidMibzeZcwgzedcM=
+require 'ansible/ruby/modules/generated/core/utilities/logic/set_fact'
+require 'ansible/ruby/modules/free_form'
+
+module Ansible
+  module Ruby
+    module Modules
+      class Set_fact
+        # key_value is on the module but it really needs to function like free_form
+        attribute :free_form
+        include FreeForm
+        remove_existing_validations :key_value
+        remove_existing_validations :free_form
+        # free_form is usually a Hash
+        validates :free_form,
+                  type: {
+                    type: Hash,
+                    message: 'set_fact(%{value}), %{value} is expected to be a Hash but was a %{type}'
+                  }
+      end
+    end
+  end
+end

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/cloudformation.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Launches an AWS CloudFormation stack and waits for it complete.
       class Cloudformation < Base
         # @return [String] name of the cloudformation stack
         attribute :stack_name

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates or terminates ec2 instances.
       class Ec2 < Base
         # @return [String, nil] key pair to use on the instance
         attribute :key_name

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_ami.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates or deletes ec2 images.
       class Ec2_ami < Base
         # @return [String, nil] instance id of the image to create
         attribute :instance_id

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_ami_find.rb

@@ -5,6 +5,10 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Returns list of matching AMIs with AMI ID, along with other useful information
+      # Can search AMIs with different owners
+      # Can search by matching tag(s), by AMI name and/or other criteria
+      # Results can be sorted and sliced
       class Ec2_ami_find < Base
         # @return [Object] The AWS region to use.
         attribute :region

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_ami_search.rb

@@ -5,6 +5,11 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Look up the most recent AMI on AWS for a given operating system.
+      # Returns C(ami), C(aki), C(ari), C(serial), C(tag)
+      # If there is no AKI or ARI associated with an image, these will be C(null).
+      # Only supports images from cloud-images.ubuntu.com
+      # Example output: C({"ami": "ami-69f5a900", "changed": false, "aki": "aki-88aa75e1", "tag": "release", "ari": null, "serial": "20131024"})
       class Ec2_ami_search < Base
         # @return [:ubuntu] Linux distribution (e.g., C(ubuntu))
         attribute :distro

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_asg.rb

@@ -5,6 +5,8 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Can create or delete AWS Autoscaling Groups
+      # Works with the ec2_lc module to manage Launch Configurations
       class Ec2_asg < Base
         # @return [:present, :absent] register or deregister the instance
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_eip.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # This module associates AWS EC2 elastic IP addresses with instances
       class Ec2_eip < Base
         # @return [String, nil] The id of the device for the EIP. Can be an EC2 Instance id or Elastic Network Interface (ENI) id.
         attribute :device_id

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_elb.rb

@@ -5,6 +5,9 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # This module de-registers or registers an AWS EC2 instance from the ELBs that it belongs to.
+      # Returns fact "ec2_elbs" which is a list of elbs attached to the instance if state=absent is passed as an argument.
+      # Will be marked changed when called only if there are ELBs found to operate on.
       class Ec2_elb < Base
         # @return [:present, :absent] register or deregister the instance
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_elb_lb.rb

@@ -5,6 +5,8 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Returns information about the load balancer.
+      # Will be marked changed when called only if state is changed.
       class Ec2_elb_lb < Base
         # @return [:present, :absent] Create or destroy the ELB
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_facts.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # This module fetches data from the metadata servers in ec2 (aws) as per http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html. The module must be called from within the EC2 instance itself.
       class Ec2_facts < Base
         # @return [:yes, :no, nil] If C(no), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
         attribute :validate_certs

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_group.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # maintains ec2 security groups. This module has a dependency on python-boto >= 2.5
       class Ec2_group < Base
         # @return [String] Name of the security group.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_key.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # maintains ec2 key pairs. This module has a dependency on python-boto >= 2.5
       class Ec2_key < Base
         # @return [String] Name of the key pair.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_lc.rb

@@ -5,6 +5,8 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Can create or delete AWS Autoscaling Configurations
+      # Works with the ec2_asg module to manage Autoscaling Groups
       class Ec2_lc < Base
         # @return [:present, :absent] register or deregister the instance
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_metric_alarm.rb

@@ -5,6 +5,8 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Can create or delete AWS metric alarms
+      # Metrics you wish to alarm on must already exist
       class Ec2_metric_alarm < Base
         # @return [:present, :absent] register or deregister the alarm
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_scaling_policy.rb

@@ -5,6 +5,8 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Can create or delete scaling policies for autoscaling groups
+      # Referenced autoscaling groups must already exist
       class Ec2_scaling_policy < Base
         # @return [:present, :absent] register or deregister the policy
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_snapshot.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # creates an EC2 snapshot from an existing EBS volume
       class Ec2_snapshot < Base
         # @return [String, nil] volume from which to take the snapshot
         attribute :volume_id

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_tag.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates, removes and lists tags from any EC2 resource.  The resource is referenced by its resource id (e.g. an instance being i-XXXXXXX). It is designed to be used with complex args (tags), see the examples.  This module has a dependency on python-boto.
       class Ec2_tag < Base
         # @return [String] The EC2 resource id.
         attribute :resource

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_vol.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # creates an EBS volume and optionally attaches it to an instance.  If both an instance ID and a device name is given and the instance has a device at the device name, then no volume is created and no attachment is made.  This module has a dependency on python-boto.
       class Ec2_vol < Base
         # @return [String, nil] instance ID if you wish to attach the volume. Since 1.9 you can set to None to detach.
         attribute :instance

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_vpc.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Create or terminates AWS virtual private clouds.  This module has a dependency on python-boto.
       class Ec2_vpc < Base
         # @return [Object, nil] The cidr block representing the VPC, e.g. 10.0.0.0/16, required when I(state) is 'present'.
         attribute :cidr_block

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2_vpc_net.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Create or terminate AWS virtual private clouds.  This module has a dependency on python-boto.
       class Ec2_vpc_net < Base
         # @return [String] The name to give your VPC. This is used in combination with the cidr_block paramater to determine if a VPC already exists.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/elasticache.rb

@@ -5,6 +5,8 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Manage cache clusters in Amazon Elasticache.
+      # Returns information about the specified cache cluster.
       class Elasticache < Base
         # @return [:present, :absent, :rebooted] C(absent) or C(present) are idempotent actions that will create or destroy a cache cluster as needed. C(rebooted) will reboot the cluster, resulting in a momentary outage.
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/elasticache_subnet_group.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates, modifies, and deletes Elasticache subnet groups. This module has a dependency on python-boto >= 2.5.
       class Elasticache_subnet_group < Base
         # @return [:present, :absent] Specifies whether the subnet should be present or absent.
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/iam.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Allows for the management of IAM users, user API keys, groups, roles.
       class Iam < Base
         # @return [:user, :group, :role] Type of IAM resource
         attribute :iam_type

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/iam_cert.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Allows for the management of server certificates
       class Iam_cert < Base
         # @return [String] Name of certificate to add, update or remove.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/iam_policy.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Allows uploading or removing IAM policies for IAM users, groups or roles.
       class Iam_policy < Base
         # @return [:user, :group, :role] Type of IAM resource
         attribute :iam_type

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/rds.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates, deletes, or modifies rds instances.  When creating an instance it can be either a new instance or a read-only replica of an existing instance. This module has a dependency on python-boto >= 2.5. The 'promote' command requires boto >= 2.18.0. Certain features such as tags rely on boto.rds2 (boto >= 2.26.0)
       class Rds < Base
         # @return [:create, :replicate, :delete, :facts, :modify, :promote, :snapshot, :reboot, :restore] Specifies the action to take. The 'reboot' option is available starting at version 2.0
         attribute :command

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/rds_param_group.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates, modifies, and deletes RDS parameter groups. This module has a dependency on python-boto >= 2.5.
       class Rds_param_group < Base
         # @return [:present, :absent] Specifies whether the group should be present or absent.
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/rds_subnet_group.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates, modifies, and deletes RDS database subnet groups. This module has a dependency on python-boto >= 2.5.
       class Rds_subnet_group < Base
         # @return [:present, :absent] Specifies whether the subnet should be present or absent.
         attribute :state

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/route53.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates and deletes DNS records in Amazons Route53 service
       class Route53 < Base
         # @return [:get, :create, :delete] Specifies the action to take.
         attribute :command

data/lib/ansible/ruby/modules/generated/core/cloud/amazon/s3.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # This module allows the user to manage S3 buckets and the objects within them. Includes support for creating and deleting both objects and buckets, retrieving objects as files or strings and generating download links. This module has a dependency on python-boto.
       class S3 < Base
         # @return [Object, nil] AWS access key id. If not set then the value of the AWS_ACCESS_KEY environment variable is used.
         attribute :aws_access_key

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Creates or terminates azure instances. When created optionally waits for it to be 'running'.
       class Azure < Base
         # @return [String] name of the virtual machine and associated cloud service.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure_rm_networkinterface.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Create, update or delete a network interface. When creating a network interface you must provide the name of an existing virtual network, the name of an existing subnet within the virtual network. A default security group and public IP address will be created automatically, or you can provide the name of an existing security group and public IP address. See the examples below for more details.
       class Azure_rm_networkinterface < Base
         # @return [String] Name of a resource group where the network interface exists or will be created.
         attribute :resource_group

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure_rm_networkinterface_facts.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Get facts for a specific network interface or all network interfaces within a resource group.
       class Azure_rm_networkinterface_facts < Base
         # @return [String, nil] Only show results for a specific network interface.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure_rm_publicipaddress.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Create, update and delete a Public IP address. Allows setting and updating the address allocation method and domain name label. Use the azure_rm_networkinterface module to associate a Public IP with a network interface.
       class Azure_rm_publicipaddress < Base
         # @return [String] Name of resource group with which the Public IP is associated.
         attribute :resource_group

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure_rm_publicipaddress_facts.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Get facts for a specific public IP or all public IPs within a resource group.
       class Azure_rm_publicip_facts < Base
         # @return [String, nil] Only show results for a specific Public IP.
         attribute :name

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure_rm_resourcegroup.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Create, update and delete a resource group.
       class Azure_rm_resourcegroup < Base
         # @return [Boolean, nil] Remove a resource group and all associated resources. Use with state 'absent' to delete a resource group that contains resources.
         attribute :force

data/lib/ansible/ruby/modules/generated/core/cloud/azure/azure_rm_resourcegroup_facts.rb

@@ -5,6 +5,7 @@ require 'ansible/ruby/modules/base'
 module Ansible
   module Ruby
     module Modules
+      # Get facts for a specific resource group or all resource groups.
       class Azure_rm_resouregroup_facts < Base
         # @return [String, nil] Limit results to a specific resource group.
         attribute :name