CloudflareProvider provider for octoDNS
An octoDNS provider that targets Cloudflare.
Installation
Command line
pip install octodns_cloudflare
requirements.txt/setup.py
Pinning specific versions or SHAs is recommended to avoid unplanned upgrades.
Versions
# Start with the latest versions and don't just copy what's here
octodns==0.9.14
octodns_cloudflare==0.0.1
SHAs
# Start with the latest/specific versions and don't just copy what's here
-e git+https://[email protected]/octodns/[email protected]#egg=octodns
-e git+https://[email protected]/octodns/octodns_cloudflare.gi[email protected]#egg=octodns_powerdns
Configuration
providers:
cloudflare:
class: octodns_cloudflare.CloudflareProvider
# The api key (required)
# Your Cloudflare account email address (required, optional if using token)
email: env/CLOUDFLARE_EMAIL
token: env/CLOUDFLARE_TOKEN
# Import CDN enabled records as CNAME to {}.cdn.cloudflare.net. Records
# ending at .cdn.cloudflare.net. will be ignored when this provider is
# not used as the source and the cdn option is enabled.
#
# See: https://support.cloudflare.com/hc/en-us/articles/115000830351
#cdn: false
# Optional. Default: 4. Number of times to retry if a 429 response
# is received.
#retry_count: 4
# Optional. Default: 300. Number of seconds to wait before retrying.
#retry_period: 300
# Optional. Default: 50. Number of zones per page.
#zones_per_page: 50
# Optional. Default: 100. Number of dns records per page.
#records_per_page: 100
Note: The "proxied" flag of "A", "AAAA" and "CNAME" records can be managed via the YAML provider like so:
name:
octodns:
cloudflare:
proxied: true
ttl: 120
type: A
value: 1.2.3.4
Support Information
Records
CloudflareProvider supports A, AAAA, ALIAS, CAA, CNAME, LOC, MX, NS, PTR, SPF, SRV, TXT, and URLFWD. There are restrictions on CAA tag support.
Dynamic
CloudflareProvider does not support dynamic records.
Developement
See the /script/ directory for some tools to help with the development process. They generally follow the Script to rule them all pattern. Most useful is ./script/bootstrap which will create a venv and install both the runtime and development related requirements. It will also hook up a pre-commit hook that covers most of what's run by CI.
5 Sep 12, 2022
3 Apr 25, 2022
1 Nov 23, 2021
1 Jan 29, 2022
5 Mar 25, 2022
12 May 07, 2022
20 Nov 22, 2022
3 Apr 10, 2022
9 Aug 29, 2021
45 Nov 17, 2022
27 Dec 20, 2022
1 Feb 04, 2022
77 Dec 28, 2022
1 Jan 26, 2022
1 Oct 25, 2021
38 Nov 07, 2022
377 Jan 03, 2023
59 Mar 31, 2022
17 Nov 09, 2022
92 Jan 05, 2023