W3cubDocs

/Ansible

rax_scaling_group - Manipulate Rackspace Cloud Autoscale Groups

New in version 1.7.

Synopsis

Manipulate Rackspace Cloud Autoscale Groups

Requirements (on host that executes module)

  • python >= 2.6
  • pyrax

Options

parameter required default choices comments
api_key
no
Rackspace API key, overrides credentials.
aliases: password
config_drive
(added in 1.8)
no
  • yes
  • 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
  • auto
  • manual
Disk partitioning strategy
env
(added in 1.5)
no
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
  • present
  • absent
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
  • yes
  • 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

Examples

---
- 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

Notes

Note

The following environment variables can be used, RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.

Note

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

Note

RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

Note

RAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)

This is a Core Module

For more information on what this means please read Core Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/rax_scaling_group_module.html