diff options
-rw-r--r-- | README.md | 26 |
1 files changed, 24 insertions, 2 deletions
@@ -1,6 +1,6 @@ # PowerDNSex -**TODO: Add description** +A client to [PowerDNS 4 API](https://doc.powerdns.com/md/httpapi/README/), with all CRUD operations to manage zones and records. ## Installation @@ -22,8 +22,25 @@ If [available in Hex](https://hex.pm/docs/publish), the package can be installed end ``` +## Configuration +Insert this in your configuration files. Eg: `config.exs` + +```elixir +config :powerdnsex, url: "localhost:8081", + token: "sometoken" +``` + +You can also use ENV vars to configure PowerDNSex. +```elixir +config :powerdnsex, url: {:system, "POWERDNS_URL"}, + token: {:system, "POWERDNS_TOKEN"} +``` +Make sure you set those environment variables. + ## Example usage +### Zone Management + ```elixir # CREATE ZONE: zone_model = %PowerDNSex.Models.Zone{ @@ -39,7 +56,12 @@ zone_model = %PowerDNSex.Models.Zone{ # DELETE ZONE: res = PowerDNSex.delete_zone("example.com") +``` + + +### Record management +```elixir # CREATE RECORD: {:ok, zone} = PowerDNSex.show_zone("example.com") record = %{ @@ -85,5 +107,5 @@ record = %{ } rrset = PowerDNSex.show_record("example.com", record) res = PowerDNSex.delete_record(zone, rrset) - ``` + |