Ansible is an open-source provisioning and configuration tool that supports infrastructure as code. Spot integration with Ansible allows you to use Ansible modules for creating, updating, and deleting Spot resources. This article explains how to roll an Elastigroup using Ansible instead of the Spot UI, using the Spot Ansible Cloud Modules collection.

Prerequisites and Setup

• Install Ansible, Python, and the Python SDK on your local system.

• Ensure you have the Spot modules installed from Ansible Galaxy:

  ansible-galaxy collection install spot.cloud_modules

• Verify the modules installation with:

  ansible-galaxy collection list

• Optionally, include the Spot collection in a requirements.yml file and install:

  --- collections: - name: spot.cloud_modules ansible-galaxy collection install -r requirements.yml

• Ensure your credentials file (creds.yaml) contains a valid Spot token and account ID.

Performing the Roll

1. Prepare the playbook by defining a task using the spot.cloud_modules.aws_elastigroup module.

2. Update a property, such as image_id, and set the state to present. Changing the image ID typically triggers a roll.

Example playbook structure:

- hosts: localhost
  tasks: - name: Update and Roll Elastigroup
           spot.cloud_modules.aws_elastigroup:
             credentials_path: /path/to/creds.yaml
             id: sig-12345678 # The Elastigroup ID to roll 
             state: present 
             image_id: ami-new-image-id # Changing this triggers the roll 
             # Include additional required configurations here 
register: result 

- debug: var=result

1. Execute the playbook:

   ansible-playbook your-playbook-name.yaml

Roll Configuration Options

If you need advanced roll configurations, you can add the roll_config object in the Ansible configuration:

roll_config:
  description:
    - (Object) Roll configuration; used to roll the group after updating.
    Accepts: 
      batch_size_percentage (Integer, Required)
      grace_period (Integer, Required) 
      health_check_type (String, Optional)

Key Considerations

• Health Signals: Some Ansible module versions may not wait for "green instances" before proceeding. Implement a waitForCompletion logic or add a delay if needed.

• Roll Behavior: Elastigroup roll is usually controlled by updating parameters like image_id or using deployment strategies.

• Credentials: Ensure your credentials file is correctly configured with Spot token and account ID.