The Spot Cloud Modules Ansible collection includes Ansible modules to help automate the management of Spot resources.

Note: If you are migrating to this collection from the module in community.general or the previous Github repo, please read the migration guide below.

This collection has been tested against following Ansible versions: >=2.9.10.

Version 2 of Spot's Python SDK does not support Python 2.7 so this collection requires Python 3.6 or greater.

Version 1.0.0 of this collection requires at least version 2.1.15 of Spot's Python SDK.

You can install the Spot collection with the Ansible Galaxy CLI:

ansible-galaxy collection install spot.cloud_modules

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: spot.cloud_modules

The python module dependencies are not installed by ansible-galaxy. They can be manually installed using pip and from the collection project's root, running:

pip install requirements.txt

or:

pip install spotinst_sdk2>=2.1.15

You can either call modules by their Fully Qualified Collection Namespace (FQCN), such as spot.cloud_modules.aws_elastigroup, or you can call modules by their short name if you list the spot.cloud_modules collection in the playbook's collections keyword:

---
# FQCN 
  tasks:
    - name: Manage Elastigroup
      spot.cloud_modules.aws_elastigroup:

---
# collections keyword
 collections:
    - spot.cloud_modules
  
  tasks:
    - name: Manage Elastigroup
      aws_elastigroup:

This section does not apply to you if you are upgrading from a previous version of this collection.

If you are migrating either from community.general or from previously having our spotinst_aws_elastigroup installed manually, please take note of the following breaking changes:

• Python >=3.6 required.
• spotinst_sdk2 (v2) required (community.general.spotinst_aws_elastigroup required spotinst_sdk (v1)).
• The module community.general.spotinst_aws_elastigroup was renamed to spot.cloud_modules.aws_elastigroup in this collection.

• Python >=3.6 required.
• spotinst_sdk2 (v2) required (your version may have required spotinst_sdk (v1)).
• All references to modules should be changed to spot.cloud_modules.module_name, according to the module names in the modules section.
  • Note: all modules have been renamed.

Contributions to this collection are welcome.

Please be sure to read our Code of Conduct.