An ansible role that creates a DigitalOcean droplet and add the droplet's IP address to the inventory file.
None.
ansible-galaxy install jasonheecs.digitalocean
Role variables are listed in defaults/main.yml, and sensitive variables (like your DigitalOcean API token) should be listed in vars/private.yml.
Available variables are listed below, along with default values (see defaults/main.yml and vars/private.yml.example):
# SSH Key identifier in your DigitalOcean account
do_ssh_key_name: Ansible SSH Key
# Public SSH key to be added to your account
do_ssh_pub_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
# Private key used to ssh into your droplet
do_ssh_private_key: "~/.ssh/id_rsa"
# Name of the droplet
droplet_name: test-droplet
# This is the slug of the region you would like your server to be created in.
droplet_region_id: sgp1
# This is the slug of the size you would like the droplet to be created with.
droplet_size_id: 512mb
# This is the slug of the image you would like the droplet to be created with.
droplet_image_id: ubuntu-18-04-x64
# Location of your ansible inventory file
ansible_inventory_file: hosts.ini
# The group name that is used for grouping your droplets in your inventory file
droplets_inventory_group: do_droplets
# Your DigitalOcean Personal Access Token (https://www.digitalocean.com/community/tutorials/how-to-use-the-digitalocean-api-v2)
do_api_token: inserttokenhere
# Additional SSH Keys to add to the droplet during the creation process (https://developers.digitalocean.com/documentation/v2/#ssh-keys)
droplet_additional_ssh_key_ids: []None.
A playbook that runs this role on a remote machine:
- hosts: all
become: no
roles:
- { role: jasonheecs.digitalocean }A playbook that runs this role on your local machine:
- hosts: localhost
connection: local
become: no
roles:
- { role: jasonheecs.digitalocean }Refer to a sample playbook here.
Automated testing is done via Test Kitchen, Kitchen Ansible and Kitchen Docker
To run the tests, make sure Ruby and Docker are installed and run the following:
gem install bundler && bundle exec kitchen test
Refer to the travis.yml file and Travis build logs for details on the test build process and expected outputs.
This ansible role has been tested against the following platforms:
- macOS Sierra
- macOS High Sierra
- Ubuntu 16.04
- Ubuntu 14.04
- CentOS 7
- Debian 9
MIT