Skip to content

Latest commit

 

History

History
53 lines (38 loc) · 1.89 KB

README.md

File metadata and controls

53 lines (38 loc) · 1.89 KB
Raw

ec2-start-stop

Role to start/stop EC2 instance(s) and conditionally associate/disassociate elastic IP(s) to the same.

Requirements

  • Python 2.7
  • boto
  • AWS access keys with EC2FullAccess privileges

Role Variables

  • AWS_ACCESS_KEY_ID: Access key with EC2FullAccess privileges being set as environment variable as shown in the sample below
  • AWS_SECRET_ACCESS_KEY: Corresponding secret access key to AWS_ACCESS_KEY_ID
  • EC2_REGION: The AWS region of your infrastructure
  • action: start/stop. Whether the instance(s) is/are to be started/stopped. Default: start
  • reuse_existing_ip_allowed: yes/no. Re-use unassociated IP(s) allocated to your account. Default: yes
  • release_on_disassociation: yes/no. Release the IP on disassociation. Default: yes
  • roles_directory: roles. The directory in which the role is present. Default: roles
  • instances.tags: Tags of the instance(s) you want to start/stop
  • instances.elastic_ip: yes/no. Whether you want an elastic_ip is to be associated or not. Elastic IP will be associated while starting and disassociated on stopping. Re-use & release are based on reuse_existing_ip_allowed & release_on_disassociation respectively.

Example Playbook

ansible-playbook ec2-start-stop.yml -e "action=start reuse_existing_ip_allowed=yes"

ansible-playbook ec2-start-stop.yml -e "action=stop release_on_disassociation=no"

- hosts: localhost
  connection: local
  environment:
    AWS_ACCESS_KEY_ID: "{{AWS_ACCESS_KEY_ID}}"
    AWS_SECRET_ACCESS_KEY: "{{AWS_SECRET_ACCESS_KEY}}"
    EC2_REGION: "{{EC2_REGION}}"
  roles:
  - {role: ec2-start-stop}

License

MIT

Author Information

The role was created in 2016 by Mikhail Advani

Twitter Handle: @mikhail_advani