New in version 1.7.
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| api_key | no | Rackspace API key, overrides credentials. aliases: password | ||
| config_drive (added in 1.8)
| no |
| Attach read-only configuration drive to server as label config-2 | |
| cooldown | no | The period of time, in seconds, that must pass before any scaling can occur after the previous scaling. Must be an integer between 0 and 86400 (24 hrs). | ||
| credentials | no | File to find the Rackspace credentials in. Ignored if api_key and username are provided. aliases: creds_file | ||
| disk_config | no | auto |
| Disk partitioning strategy |
| env (added in 1.5)
| no | Environment as configured in ~/.pyrax.cfg, see https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration. | ||
| files | no | Files to insert into the instance. Hash of remotepath: localpath
| ||
| flavor | yes | flavor to use for the instance | ||
| image | yes | image to use for the instance. Can be an id, human_id or name
| ||
| key_name | no | key pair to use on the instance | ||
| loadbalancers | no | List of load balancer id and port hashes | ||
| max_entities | yes | The maximum number of entities that are allowed in the scaling group. Must be an integer between 0 and 1000. | ||
| meta | no | A hash of metadata to associate with the instance | ||
| min_entities | yes | The minimum number of entities that are allowed in the scaling group. Must be an integer between 0 and 1000. | ||
| name | yes | Name to give the scaling group | ||
| networks | no | [u'public', u'private'] | The network to attach to the instances. If specified, you must include ALL networks including the public and private interfaces. Can be id or label. | |
| region | no | DFW | Region to create an instance in. | |
| server_name | yes | The base name for servers created by Autoscale | ||
| state | no | present |
| Indicate desired state of the resource |
| user_data (added in 1.8)
| no | Data to be uploaded to the servers config drive. This option implies config_drive. Can be a file path or a string | ||
| username | no | Rackspace username, overrides credentials. | ||
| verify_ssl (added in 1.5)
| no | Whether or not to require SSL validation of API endpoints. | ||
| wait | no | no |
| wait for the scaling group to finish provisioning the minimum amount of servers |
| wait_timeout | no | 300 | how long before wait gives up, in seconds |
---
- hosts: localhost
gather_facts: false
connection: local
tasks:
- rax_scaling_group:
credentials: ~/.raxpub
region: ORD
cooldown: 300
flavor: performance1-1
image: bb02b1a3-bc77-4d17-ab5b-421d89850fca
min_entities: 5
max_entities: 10
name: ASG Test
server_name: asgtest
loadbalancers:
- id: 228385
port: 80
register: asg
Note
RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.RAX_CREDENTIALS and RAX_CREDS_FILE points to a credentials file appropriate for pyrax. See https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME and RAX_API_KEY obviate the use of a credentials fileRAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/rax_scaling_group_module.html