DefinedNet / nebula-docs

Documentation for the Nebula open source project
https://nebula.defined.net/docs
12 stars 10 forks source link

Document DNS + Nebula #68

Closed jasikpark closed 1 year ago

jasikpark commented 1 year ago

Fixes #66 Fixes slackhq/nebula/#110

https://deploy-preview-68--nebula-docs-dn.netlify.app/docs/guides/using-lighthouse-dns/

netlify[bot] commented 1 year ago

Deploy Preview for nebula-docs-dn ready!

Name Link
Latest commit 76bf10b55035e6235d0929ab98e404538cb24c61
Latest deploy log https://app.netlify.com/sites/nebula-docs-dn/deploys/6393941dced584000886389f
Deploy Preview https://deploy-preview-68--nebula-docs-dn.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

jasikpark commented 1 year ago

Not totally ready for review, but at a point to where it contains most of the info I know to contain / I need to work on the layout of the document...

johnmaguire commented 1 year ago

This looks pretty good. It's nice that it walks through how to set up the DNS server, its caveats, and how to query it. It's too bad we don't have better resources to point to for how to configure system DNS, but this is probably highly specific to each environment (e.g. configuring it via provisioning tools vs. manual config on each distro, etc.) and should be left out, at least for now.

jasikpark commented 1 year ago

how to configure system DNS, but this is probably highly specific to each environment (e.g. configuring it via provisioning tools vs. manual confi

this is also hard to do since the lighthouse DNS does not resolve queries recursively and only responds about nebula ips / hosts

johnmaguire commented 1 year ago

how to configure system DNS, but this is probably highly specific to each environment (e.g. configuring it via provisioning tools vs. manual confi

this is also hard to do since the lighthouse DNS does not resolve queries recursively and only responds about nebula ips / hosts

Right, you'd need a tool like dnsmasq or something probably.

jasikpark commented 1 year ago

Okay, I tried to address all of your comments John, thanks for the feedback!

jasikpark commented 1 year ago

I feel like providing that dnsmasq guide would be helpful if easily implemented

johnmaguire commented 1 year ago

LGTM. I wish we could use ping instead of the HTTP example since it wouldn't involve standing up an HTTP server (which isn't covered in the tutorial), but I don't see any way to get ping to use a DNS resolver.

Thanks for writing this guide! I think it'll be useful to a lot of users.

jasikpark commented 1 year ago

lol