From 6e68d2623fe62201f288aee9490cebeb9665e4b3 Mon Sep 17 00:00:00 2001 From: Timothy Miller Date: Fri, 29 Oct 2021 22:22:57 -0400 Subject: [PATCH] Improved documentation around optional features --- README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 44 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5218c5d..bb8499d 100755 --- a/README.md +++ b/README.md @@ -10,9 +10,13 @@ A small, ๐Ÿ•ต๏ธ privacy centric, and โšก lightning fast multi-architecture Dock This script was written for the Raspberry Pi platform to enable low cost self hosting to promote a more decentralized internet. -## ๐Ÿงน More than just DDNS +### ๐Ÿงน Safe for use with existing records -`cloudflare-ddns` handles the busy work for you, so deploying web apps is less of a clickfest. Every 5 minutes, the script fetches public IPv4 and IPv6 addresses and then creates/updates DNS records for each subdomain in Cloudflare. Stale, duplicate DNS records are removed for housekeeping. +`cloudflare-ddns` handles the busy work for you, so deploying web apps is less of a clickfest. Every 5 minutes, the script fetches public IPv4 and IPv6 addresses and then creates/updates DNS records for each subdomain in Cloudflare. + +#### Optional features + +Stale, duplicate DNS records are removed for housekeeping. ## ๐Ÿ“Š Stats @@ -84,6 +88,10 @@ You can save yourself some trouble when hosting multiple domains pointing to the You can handle ddns for multiple domains (cloudflare zones) using the same docker container by separating your configs inside ```config.json``` like below: +### โš ๏ธ Note + +Do not include the base domain name in your `subdomains` config. Do not use the [FDQN](https://en.wikipedia.org/wiki/Fully_qualified_domain_name). + ```bash { "cloudflare": [ @@ -156,6 +164,40 @@ From the project root directory docker-compose up -d ``` +## ๐Ÿ‹ Kubernetes + + +Create config File + +``` bash +cp ../../config-example.json config.json +``` + +Edit config.jsonon (vim, nvim, nano... ) +``` bash +${EDITOR} config.json +``` + +Create config file as Secret. + +``` bash +kubectl create secret generic config-cloudflare-ddns --from-file=config.json --dry-run=client -oyaml -n ddns > config-cloudflare-ddns-Secret.yaml +``` + +apply this secret + +``` bash +kubectl apply -f config-cloudflare-ddns-Secret.yaml +rm config.json # recomended Just keep de secret on Kubernetes Cluster +``` + +apply this Deployment + +``` bash +kubectl apply -f cloudflare-ddns-Deployment.yaml +``` + + ## ๐Ÿง Deploy with Linux + Cron ### ๐Ÿƒ Running (all distros)