Documentation

rax_scaling_group - Manipulate Rackspace Cloud Autoscale Groups

New in version 1.7.

Synopsis

  • Manipulate Rackspace Cloud Autoscale Groups

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.
  • 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 file
  • RAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, …)

Status

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.