Skip to content

Latest commit

 

History

History
81 lines (69 loc) · 3.44 KB

index.md

File metadata and controls

81 lines (69 loc) · 3.44 KB
Raw
page_title
Provider: DigitalOcean

DigitalOcean Provider

The DigitalOcean (DO) provider is used to interact with the resources supported by DigitalOcean. The provider needs to be configured with the proper credentials before it can be used.

Use the navigation to the left to read about the available resources.

Example Usage

terraform {
  required_providers {
    digitalocean = {
      source = "digitalocean/digitalocean"
      version = "~> 2.0"
    }
  }
}

# Set the variable value in *.tfvars file
# or using -var="do_token=..." CLI option
variable "do_token" {}

# Configure the DigitalOcean Provider
provider "digitalocean" {
  token = var.do_token
}

# Create a web server
resource "digitalocean_droplet" "web" {
  # ...
}

-> Note for Module Developers Although provider configurations are shared between modules, each module must declare its own provider requirements. See the module development documentation for additional information.

Argument Reference

The following arguments are supported:

  • token - (Required) This is the DO API token. Alternatively, this can also be specified using environment variables ordered by precedence:
    • DIGITALOCEAN_TOKEN
    • DIGITALOCEAN_ACCESS_TOKEN
  • spaces_access_id - (Optional) The access key ID used for Spaces API operations (Defaults to the value of the SPACES_ACCESS_KEY_ID environment variable).
  • spaces_secret_key - (Optional) The secret access key used for Spaces API operations (Defaults to the value of the SPACES_SECRET_ACCESS_KEY environment variable).
  • api_endpoint - (Optional) This can be used to override the base URL for DigitalOcean API requests (Defaults to the value of the DIGITALOCEAN_API_URL environment variable or https://api.digitalocean.com if unset).
  • spaces_endpoint - (Optional) This can be used to override the endpoint URL used for DigitalOcean Spaces requests. (It defaults to the value of the SPACES_ENDPOINT_URL environment variable or https://{{.Region}}.digitaloceanspaces.com if unset.) The provider will replace {{.Region}} (via Go's templating engine) with the slug of the applicable Spaces region.
  • requests_per_second - (Optional) This can be used to enable throttling, overriding the limit of API calls per second to avoid rate limit errors, can be disabled by setting the value to 0.0 (Defaults to the value of the DIGITALOCEAN_REQUESTS_PER_SECOND environment variable or 0.0 if unset).
  • http_retry_max - (Optional) This can be used to override the maximum number of retries on a failed API request (client errors, 422, 500, 502...), can be disabled by the http_retry_wait_min and http_retry_wait_max arguments (Defaults to the value of the DIGITALOCEAN_HTTP_RETRY_MAX environment variable or 0 if unset).
  • http_retry_wait_min - (Optional) This can be used to configure the minimum waiting time (in seconds) between failed requests for the backoff strategy (Defaults to the value of the DIGITALOCEAN_HTTP_RETRY_WAIT_MIN environment variable or 1.0 if unset).
  • http_retry_wait_max - (Optional) This can be used to configure the maximum waiting time (in seconds) between failed requests for the backoff strategy (Defaults to the value of the DIGITALOCEAN_HTTP_RETRY_WAIT_MAX environment variable or 30.0 if unset).