59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# dnsmadeeasy_record
|
|
|
|
Manages DNS records in DNS Made Easy via the `community.general.dnsmadeeasy` module.
|
|
|
|
Accepts a list of record entries and creates or updates each one.
|
|
|
|
## Requirements
|
|
|
|
- `community.general` collection
|
|
- DNS Made Easy account credentials
|
|
|
|
## Role Variables
|
|
|
|
| Variable | Default | Description |
|
|
|---|---|---|
|
|
| `dnsmadeeasy_record_account_key` | *required* | DNS Made Easy account key |
|
|
| `dnsmadeeasy_record_account_secret` | *required* | DNS Made Easy account secret (sensitive) |
|
|
| `dnsmadeeasy_record_entries` | `[]` | List of DNS record entries (see below) |
|
|
|
|
### Entry format
|
|
|
|
Each entry in `dnsmadeeasy_record_entries` requires:
|
|
|
|
| Field | Required | Default | Description |
|
|
|---|---|---|---|
|
|
| `domain` | yes | | DNS zone (e.g. `openshift.toal.ca`) |
|
|
| `record_name` | yes | | Record name within the zone |
|
|
| `record_type` | yes | | DNS record type (A, CNAME, etc.) |
|
|
| `record_value` | yes | | Target value |
|
|
| `record_ttl` | no | `1800` | TTL in seconds |
|
|
|
|
## Example Playbook
|
|
|
|
```yaml
|
|
- name: Configure public DNS records
|
|
hosts: sno.openshift.toal.ca
|
|
gather_facts: false
|
|
connection: local
|
|
|
|
roles:
|
|
- role: dnsmadeeasy_record
|
|
dnsmadeeasy_record_account_key: "{{ dme_account_key }}"
|
|
dnsmadeeasy_record_account_secret: "{{ dme_account_secret }}"
|
|
dnsmadeeasy_record_entries:
|
|
- domain: openshift.toal.ca
|
|
record_name: api.sno
|
|
record_type: A
|
|
record_value: 203.0.113.1
|
|
record_ttl: 300
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|
|
|
|
## Author
|
|
|
|
ptoal
|