cs_instance - Manages instances and virtual machines on Apache CloudStack based clouds.

Synopsis

Deploy, start, update, scale, restart, restore, stop and destroy instances.

Requirements (on host that executes module)

• python >= 2.6
• cs >= 0.6.10

Options

Examples

# Create a instance from an ISO
# NOTE: Names of offerings and ISOs depending on the CloudStack configuration.
- local_action:
    module: cs_instance
    name: web-vm-1
    iso: Linux Debian 7 64-bit
    hypervisor: VMware
    project: Integration
    zone: ch-zrh-ix-01
    service_offering: 1cpu_1gb
    disk_offering: PerfPlus Storage
    disk_size: 20
    networks:
      - Server Integration
      - Sync Integration
      - Storage Integration

# For changing a running instance, use the 'force' parameter
- local_action:
    module: cs_instance
    name: web-vm-1
    display_name: web-vm-01.example.com
    iso: Linux Debian 7 64-bit
    service_offering: 2cpu_2gb
    force: yes

# Create or update a instance on Exoscale's public cloud using display_name.
# Note: user_data can be used to kickstart the instance using cloud-init yaml config.
- local_action:
    module: cs_instance
    display_name: web-vm-1
    template: Linux Debian 7 64-bit
    service_offering: Tiny
    ssh_key: john@example.com
    tags:
      - { key: admin, value: john }
      - { key: foo,   value: bar }
    user_data: |
        #cloud-config
        packages:
          - nginx

# Create an instance with multiple interfaces specifying the IP addresses
- local_action:
    module: cs_instance
    name: web-vm-1
    template: Linux Debian 7 64-bit
    service_offering: Tiny
    ip_to_networks:
      - {'network': NetworkA, 'ip': '10.1.1.1'}
      - {'network': NetworkB, 'ip': '192.168.1.1'}

# Ensure an instance is stopped
- local_action: cs_instance name=web-vm-1 state=stopped

# Ensure an instance is running
- local_action: cs_instance name=web-vm-1 state=started

# Remove an instance
- local_action: cs_instance name=web-vm-1 state=absent

Return Values

Common return values are documented here Common Return Values, the following are the fields unique to this module:

Notes

This is an Extras Module

For more information on what this means please read Extras Modules

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