From 21dd45783dc9fe7bdea4b2c5417f372d928ad716 Mon Sep 17 00:00:00 2001 From: Rodrigo Coutinho Date: Tue, 28 Nov 2017 14:45:02 -0200 Subject: Configuration instructions on readme --- README.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8243116..ca8c2df 100644 --- a/README.md +++ b/README.md @@ -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,18 @@ If [available in Hex](https://hex.pm/docs/publish), the package can be installed end ``` +## Configuration with env vars +Insert this in your Phoenix configuration files. Eg: `config.exs` +```elixir +config :powerdnsex, url: {:system, "POWERDNS_URL"}, + token: {:system, "POWERDNS_TOKEN"} +``` +Make sure you set those envinronment variables. + ## Example usage +### Zone Management + ```elixir # CREATE ZONE: zone_model = %PowerDNSex.Models.Zone{ @@ -39,7 +49,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 +100,4 @@ record = %{ } rrset = PowerDNSex.show_record("example.com", record) res = PowerDNSex.delete_record(zone, rrset) - ``` -- cgit v1.2.3