community.digitalocean.digital_ocean_droplet – Create and delete a DigitalOcean droplet

Note

This plugin is part of the community.digitalocean collection (version 1.0.0).

To install it use: ansible-galaxy collection install community.digitalocean.

To use it in a playbook, specify: community.digitalocean.digital_ocean_droplet.

Synopsis

• Create and delete a droplet in DigitalOcean and optionally wait for it to be active.

Requirements

The below requirements are needed on the host that executes this module.

• python >= 2.6

Parameters

Parameter	Choices/Defaults	Comments
backups boolean	Choices: no ← yes	indicates whether automated backups should be enabled.
id string		Numeric, the droplet id you want to operate on. aliases: droplet_id
image string		This is the slug of the image you would like the droplet created with. aliases: image_id
ipv6 boolean	Choices: no ← yes	enable IPv6 for your droplet.
monitoring boolean	Choices: no ← yes	indicates whether to install the DigitalOcean agent for monitoring.
name string		String, this is the name of the droplet - must be formatted by hostname rules.
oauth_token string / required		DigitalOcean OAuth token. Can be specified in DO_API_KEY, DO_API_TOKEN, or DO_OAUTH_TOKEN environment variables aliases: API_TOKEN
private_networking boolean	Choices: no ← yes	add an additional, private network interface to droplet for inter-droplet communication.
region string		This is the slug of the region you would like your server to be created in. aliases: region_id
size string		This is the slug of the size you would like the droplet created with. aliases: size_id
ssh_keys string		array of SSH key Fingerprint that you would like to be added to the server.
state string	Choices: present ← absent	Indicate desired state of the target.
tags string		List, A list of tag names as strings to apply to the Droplet after it is created. Tag names can either be existing or new tags.
unique_name boolean	Choices: no ← yes	require unique hostnames. By default, DigitalOcean allows multiple hosts with the same name. Setting this to "yes" allows only one host per name. Useful for idempotence.
user_data string		opaque blob of data which is made available to the droplet
volumes string		List, A list including the unique string identifier for each Block Storage volume to be attached to the Droplet.
vpc_uuid string added in 0.1.0 of community.digitalocean		A string specifying the UUID of the VPC to which the Droplet will be assigned. If excluded, Droplet will be assigned to the account's default VPC for the region.
wait boolean	Choices: no yes ←	Wait for the droplet to be active before returning. If wait is "no" an ip_address may not be returned.
wait_timeout string	Default: 120	How long before wait gives up, in seconds, when creating a droplet.

Examples

- name: Create a new droplet
  community.digitalocean.digital_ocean_droplet:
    state: present
    name: mydroplet
    oauth_token: XXX
    size: 2gb
    region: sfo1
    image: ubuntu-16-04-x64
    wait_timeout: 500
    ssh_keys: [ .... ]
  register: my_droplet

- debug:
    msg: "ID is {{ my_droplet.data.droplet.id }}, IP is {{ my_droplet.data.ip_address }}"

- name: Ensure a droplet is present
  community.digitalocean.digital_ocean_droplet:
    state: present
    id: 123
    name: mydroplet
    oauth_token: XXX
    size: 2gb
    region: sfo1
    image: ubuntu-16-04-x64
    wait_timeout: 500

- name: Ensure a droplet is present with SSH keys installed
  community.digitalocean.digital_ocean_droplet:
    state: present
    id: 123
    name: mydroplet
    oauth_token: XXX
    size: 2gb
    region: sfo1
    ssh_keys: ['1534404', '1784768']
    image: ubuntu-16-04-x64
    wait_timeout: 500

Return Values

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

Key	Returned	Description
data dictionary	changed	a DigitalOcean Droplet Sample: {'droplet': {'backup_ids': [], 'created_at': '2014-11-14T16:36:31Z', 'disk': 20, 'features': ['virtio'], 'id': 3164494, 'image': {}, 'kernel': {'id': 2233, 'name': 'Ubuntu 14.04 x64 vmlinuz-3.13.0-37-generic', 'version': '3.13.0-37-generic'}, 'locked': True, 'memory': 512, 'name': 'example.com', 'networks': {}, 'region': {}, 'size': {}, 'size_slug': '512mb', 'snapshot_ids': [], 'status': 'new', 'tags': ['web'], 'vcpus': 1, 'volume_ids': []}, 'ip_address': '104.248.118.172', 'ipv6_address': '2604:a880:400:d1::90a:6001', 'private_ipv4_address': '10.136.122.141'}

Authors

• Gurchet Rai (@gurch101)