1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Tom Limoncelli 533eabedf5 Update docs for the "plan a" change (#1499)
* Update docs
2022-05-08 14:41:33 -04:00

48 lines
1.2 KiB
Markdown

---
name: DigitalOcean
title: DigitalOcean Provider
layout: default
jsId: DIGITALOCEAN
---
# DigitalOcean Provider
## Configuration
To use this provider, add an entry to `creds.json` with `TYPE` set to `DIGITALOCEAN`
along with your [DigitalOcean OAuth Token](https://cloud.digitalocean.com/settings/applications).
Example:
```json
{
"mydigitalocean": {
"TYPE": "DIGITALOCEAN",
"token": "your-digitalocean-ouath-token"
}
}
```
## Metadata
This provider does not recognize any special metadata fields unique to DigitalOcean.
## Usage
An example `dnsconfig.js` configuration:
```js
var REG_NONE = NewRegistrar("none");
var DSP_DIGITALOCEAN = NewDnsProvider("mydigitalocean");
D("example.tld", REG_NONE, DnsProvider(DSP_DIGITALOCEAN),
A("test", "1.2.3.4")
);
```
## Activation
[Create OAuth Token](https://cloud.digitalocean.com/settings/applications)
## Limitations
- Digitalocean DNS doesn't support `;` value with CAA-records ([DigitalOcean documentation](https://www.digitalocean.com/docs/networking/dns/how-to/create-caa-records/))
- While Digitalocean DNS supports TXT records with multiple strings,
their length is limited by the max API request of 512 octets.