Merge branch 'release/0.3.0'

This commit is contained in:
Rostislav Raykov 2020-04-21 10:05:04 +02:00
commit 7cf8502fb9
4 changed files with 7 additions and 9 deletions

2
.vscode/launch.json vendored
View file

@ -2,7 +2,7 @@
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.1",
"version": "0.3.0",
"configurations": [
{
"type": "lldb",

2
Cargo.lock generated
View file

@ -121,7 +121,7 @@ dependencies = [
[[package]]
name = "cloudflare-ddns"
version = "0.2.1"
version = "0.3.0"
dependencies = [
"anyhow 1.0.28 (registry+https://github.com/rust-lang/crates.io-index)",
"env_logger 0.7.1 (registry+https://github.com/rust-lang/crates.io-index)",

View file

@ -1,6 +1,6 @@
[package]
name = "cloudflare-ddns"
version = "0.2.1"
version = "0.3.0"
authors = ["Rostislav Raykov <z@zbrox.org>"]
edition = "2018"
description = "A simple CLI tool to use Cloudflare's free DDNS service"

View file

@ -7,13 +7,12 @@ This is a simple CLI you can use to continuously update an A DNS record for a do
## Options
```
-k, --key <auth-key> The auth key you need to generate in your Cloudflare profile
-t, --token <api-token> The API token you need to generate in your Cloudflare profile
-c, --cache <cache> Cache file for previously reported IP address (if skipped the IP will be reported on every
execution)
-f, --config <config> Your TOML config file containing all the required options (email, auth_key, zone, domain)
which you can use instead of passing the arguments to the command line
-d, --domain <domain> The domain for which you want to report the current IP address
-e, --email <email> Your Cloudflare login email
-z, --zone <zone> The zone in which your domain is (usually that is your base domain name)
```
@ -22,8 +21,7 @@ This is a simple CLI you can use to continuously update an A DNS record for a do
You Can pass a path to a configuration file (`-f` or `--config`) instead of each option as a command line argument. The configuration should be a [TOML](https://github.com/toml-lang/toml) file and hold the same options. Here's a sample:
```TOML
email = "example@example.com"
auth_key = "secretkey"
api_token = "secretkey"
domain = "example.example.com"
zone = "example.com"
```
@ -36,6 +34,6 @@ You need to do some preparatory work in Cloudflare. Firstly this assumes you're
You need to add a type `A` DNS record for your domain. The `Name` field you should fill in with the name of the subdomain. If you don't want to use a subdomain just type `@` then the base domain will be used. Then change the `Proxy status` field to be not `Proxied` but `DNS only`. This will allow you to input `0.0.0.0` in the `IPv4 Address` field. Then click the save button. You might need to wait sometime before the DNS record propagates.
### API key
### API token
We need to authenticate ourselves in front of the Cloudflare API. To do so we need to an auth key to pass along as a password together with our login email. You can find the global API key in `My profile > API Tokens`.
We need to authenticate ourselves in front of the Cloudflare API. To do so we need to an API token to pass along with every request. You can generate an API token to use specifically with this application on Cloudflare in `My profile > API Tokens > Create Token`.