community.general.rax_scaling_group (3.8.10) — module

Manipulate Rackspace Cloud Autoscale Groups

Authors: Matt Martz (@sivel)

Install collection

Install with ansible-galaxy collection install community.general:==3.8.10


Add to requirements.yml

  collections:
    - name: community.general
      version: 3.8.10

Description

Manipulate Rackspace Cloud Autoscale Groups


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
---
- hosts: localhost
  gather_facts: false
  connection: local
  tasks:
    - community.general.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

Inputs

    
env:
    description:
    - Environment as configured in I(~/.pyrax.cfg), see U(https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration).
    type: str

meta:
    description:
    - A hash of metadata to associate with the instance
    type: dict

name:
    description:
    - Name to give the scaling group
    required: true
    type: str

wait:
    default: 'no'
    description:
    - wait for the scaling group to finish provisioning the minimum amount of servers
    type: bool

files:
    description:
    - 'Files to insert into the instance. Hash of C(remotepath: localpath)'
    type: dict

image:
    description:
    - image to use for the instance. Can be an C(id), C(human_id) or C(name)
    required: true
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Indicate desired state of the resource
    type: str

flavor:
    description:
    - flavor to use for the instance
    required: true
    type: str

region:
    description:
    - Region to create an instance in.
    type: str

api_key:
    aliases:
    - password
    description:
    - Rackspace API key, overrides I(credentials).
    type: str

cooldown:
    default: 300
    description:
    - 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).
    type: int

key_name:
    description:
    - key pair to use on the instance
    type: str

networks:
    default:
    - public
    - private
    description:
    - The network to attach to the instances. If specified, you must include ALL networks
      including the public and private interfaces. Can be C(id) or C(label).
    elements: str
    type: list

username:
    description:
    - Rackspace username, overrides I(credentials).
    type: str

tenant_id:
    description:
    - The tenant ID used for authentication.
    type: str

user_data:
    description:
    - Data to be uploaded to the servers config drive. This option implies I(config_drive).
      Can be a file path or a string
    type: str

credentials:
    aliases:
    - creds_file
    description:
    - File to find the Rackspace credentials in. Ignored if I(api_key) and I(username)
      are provided.
    type: path

disk_config:
    choices:
    - auto
    - manual
    description:
    - Disk partitioning strategy
    - If not specified, it will fallback to C(auto).
    type: str

server_name:
    description:
    - The base name for servers created by Autoscale
    required: true
    type: str

tenant_name:
    description:
    - The tenant name used for authentication.
    type: str

config_drive:
    default: 'no'
    description:
    - Attach read-only configuration drive to server as label config-2
    type: bool

max_entities:
    description:
    - The maximum number of entities that are allowed in the scaling group. Must be an
      integer between 0 and 1000.
    required: true
    type: int

min_entities:
    description:
    - The minimum number of entities that are allowed in the scaling group. Must be an
      integer between 0 and 1000.
    required: true
    type: int

wait_timeout:
    default: 300
    description:
    - how long before wait gives up, in seconds
    type: int

auth_endpoint:
    description:
    - The URI of the authentication service.
    - If not specified will be set to U(https://identity.api.rackspacecloud.com/v2.0/)
    type: str

identity_type:
    default: rackspace
    description:
    - Authentication mechanism to use, such as rackspace or keystone.
    type: str

loadbalancers:
    description:
    - List of load balancer C(id) and C(port) hashes
    elements: dict
    type: list

validate_certs:
    aliases:
    - verify_ssl
    description:
    - Whether or not to require SSL validation of API endpoints.
    type: bool