cfdns/README.md

24 lines
815 B
Markdown
Raw Normal View History

2020-08-22 06:45:15 +00:00
# cfdns
2022-04-21 04:28:58 +00:00
Sample Ansible role to create/remove CloudFlare DNS records
2020-08-22 06:45:15 +00:00
## Requirements
2021-12-19 03:52:07 +00:00
1) See `roles/create-records/vars/sample.yml` for sample DNS zone entry definitions -- change these as desired
2021-12-19 03:39:48 +00:00
2021-12-19 03:52:33 +00:00
To add a domain, define it in the `domains` list in `play.yml`.
This will load the correlating file at `roles/create-records/vars/{{domain}}.yml`.
2021-12-19 03:52:07 +00:00
The symbolic link `./domains` was provided to make these files more accessible, not used for function -- can be removed.
2021-12-19 03:39:48 +00:00
_TODO_: Load files created here dynamically
2020-08-22 06:45:15 +00:00
2) Your CloudFlare email address and API key must be stored in `~/.cloudflare.yml` like so for authentication:
```
---
cf_email: you@domain.com
cf_token: abcdef123456
```
If this is a shared system, `chmod -v 0600 ~/.cloudflare.yml` once created to avoid potentially leaking credentials.