terraform-digitalocean-droplet

Terraform module which creates Droplet(s) and optionally, Block Storage Volumes, Floating IPs, Load Balancers and DNS Records on DigitalOcean.

These types of resources are used:

Usage Examples

Some examples can be found in this repository:

Note that examples may create resources which can cost money. Run terraform destroy when you don't need these resources.

If you're looking to try Digitalocean out, sign up here and get $100 free credit.

Droplet Sizes

A map of name to Droplet sizes exists to make specifying Droplet sizes simpler:

| Name | Droplet Size | | --------- | -------------- | | nano | s-1vcpu-1gb | | micro | s-2vcpu-2gb | | small | s-2vcpu-4gb | | medium | s-4vcpu-8gb | | large | s-6vcpu-16gb | | x-large | s-8vcpu-32gb | | xx-large | s-16vcpu-64gb | | xxx-large | s-24vcpu-128gb | | maximum | s-32vcpu-192gb |

See DigitalOcean Pricing for costs.

Providers

| Name | Version | |------|---------| | digitalocean | n/a |

Inputs

| Name | Description | Type | Default | Required | |------|-------------|------|---------|:-----:| | backups | (Optional) Boolean controlling if backups are made. Defaults to false. | bool | false | no | | block\storage\attach | (Optional) Whether to attach the volume using Terraform or not. | bool | true | no | | block\storage\count | (Optional) A count of block storage volume resources to create. | string | "" | no | | block\storage\filesystem\_label | (Optional) Initial filesystem label for the block storage volume. | string | "data" | no | | block\storage\filesystem\_type | (Optional) Initial filesystem type (xfs or ext4) for the block storage volume. | string | "xfs" | no | | block\storage\name | (Optional) Override filesystem name for the block storage volume. | string | "" | no | | block\storage\size | (Required) The size of the block storage volume in GiB. If updated, can only be expanded. | number | 0 | no | | custom\_image | Whether the image is custom or not (an official image) | bool | false | no | | droplet\_count | The number of droplets / other resources to create | number | 1 | no | | droplet\_name | The name of the droplet. If more than one droplet it is appended with the count, examples: stg-web, stg-web-01, stg-web-02 | any | n/a | yes | | droplet\_size | the size slug of a droplet size | string | "micro" | no | | floating\_ip | (Optional) Boolean to control whether floating IPs should be created. | bool | false | no | | floating\ip\assign | (Optional) Boolean controlling whether floatin IPs should be assigned to instances with Terraform. | bool | true | no | | floating\ip\count | Number of floating IPs to create. | string | "" | no | | image\_id | The id of an image to use. | string | "" | no | | image\_name | The image name or slug to lookup. | string | "ubuntu-18-04-x64" | no | | ipv6 | (Optional) Boolean controlling if IPv6 is enabled. Defaults to false. | bool | false | no | | loadbalancer | Boolean to control whether to create a Load Balancer. | bool | false | no | | loadbalancer\algorithm | The load balancing algorithm used to determine which backend Droplet will be selected by a client. It must be either round\robin or least\connections. | string | "roundrobin" | no | | loadbalancer\forwarding\rule | List of forwarding\rule maps to apply to the loadbalancer. | map |

{
  "entryport": 80,
  "entryprotocol": "http",
  "targetport": 80,
  "targetprotocol": "http",
  "tlspassthrough": false
}

| no | | loadbalancer\healthcheck | A healthcheck block to be assigned to the Load Balancer. Only 1 healthcheck is allowed. | map |

{
  "checkintervalseconds": 10,
  "healthythreshold": 5,
  "path": "/",
  "port": 80,
  "protocol": "http",
  "responsetimeoutseconds": 10,
  "unhealthy_threshold": 3
}

{
  "cookiename": null,
  "cookiettl_seconds": null,
  "type": "none"
}

Outputs

| Name | Description | |------|-------------| | droplet\_id | List of IDs of Droplets | | droplet\_ids | List of associated Droplet IDs of Volumes | | filesystem\_type | List of initial filesystem types of Volumes | | floating\ip\address | List of floating IP addresses created | | image | List of images of Droplets | | ipv4\_address | List of public IPv4 addresses assigned to the Droplets | | ipv4\address\private | List of private IPv4 addresses assigned to the Droplets, if applicable | | ipv6\_address | List of public IPv6 addresses assigned to the Droplets, if applicable | | loadbalancer\_id | ID of the loadbalancer | | loadbalancer\_ip | IP address of the loadbalancer | | name | List of names of Droplets | | private\_a | List of Droplet private DNS A record FQDNs. | | public\_a | List of Droplet public DNS A record FQDNs. | | public\_aaaa | List of Droplet public DNS AAAA record FQDNs. | | region | List of regions of Droplets | | size | List of sizes of Droplets | | tags | List of tags of Droplets | | volume\attachment\id | List of IDs of Volume Attachments | | volume\_id | List of IDs of Volumes |

🔗 More in this category