gravitl/netmaker
1
1
Fork 0
mirror of https://github.com/gravitl/netmaker.git synced 2024-09-21 15:56:07 +08:00
Code Issues Packages Projects Releases Wiki Activity

coredns prereqs

Browse source
This commit is contained in:
afeiszli 2021-05-18 19:00:29 -04:00
parent 0a79929ac3
commit 0880d35610
6 changed files with 34 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
docs/_build/doctrees/environment.pickle vendored
View file

Binary file not shown.

BIN
docs/_build/doctrees/server-installation.doctree vendored
View file

Binary file not shown.

10
docs/_build/html/_sources/server-installation.rst.txt vendored
View file

@ -36,8 +36,16 @@ To run a non-docker installation, you are running the Netmaker binary, CoreDNS b
DNS Mode Prereqisite Setup (Ubuntu)
====================================
If you plan on running the
If you plan on running the server in DNS Mode, you will be deploying a CoreDNS server. We recommend binding CoreDNS to port 53 of the host system (which it will do by default). On some systems, this will conflift with existing processes. Specifically on linux systems running systemd-resolved, there may be a service consuming port 53. The below steps will disable systemd-resolved, and replace it with a generic (e.g. Google) nameserver. The following was tested on Ubuntu 20.04. This may have consequences for existing private DNS so proceed with caution:
1. systemctl stop systemd-resolved
2. systemctl disable systemd-resolved
3. vim /etc/systemd/resolved.conf
* uncomment DNS and add 8.8.8.8 or whatever reachable nameserver is your preference
* uncomment DNSStubListener and set to "no"
4. sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf
Port 53 should now be available for CoreDNS to use.
Docker Compose Install
=======================

2
docs/_build/html/searchindex.js vendored
View file

File diff suppressed because one or more lines are too long

16
docs/_build/html/server-installation.html vendored
View file

@ -812,7 +812,21 @@
<h2 id="dns-mode-prereqisite-setup-ubuntu">DNS Mode Prereqisite Setup (Ubuntu)<a class="headerlink" href="#dns-mode-prereqisite-setup-ubuntu" title="Permalink to this headline"></a></h2>
<p>If you plan on running the</p>
<p>If you plan on running the server in DNS Mode, you will be deploying a CoreDNS server. We recommend binding CoreDNS to port 53 of the host system (which it will do by default). On some systems, this will conflift with existing processes. Specifically on linux systems running systemd-resolved, there may be a service consuming port 53. The below steps will disable systemd-resolved, and replace it with a generic (e.g. Google) nameserver. The following was tested on Ubuntu 20.04. This may have consequences for existing private DNS so proceed with caution:</p>
<ol class="arabic simple">
<li><p>systemctl stop systemd-resolved</p></li>
<li><p>systemctl disable systemd-resolved</p></li>
<li><dl class="simple">
<dt>vim /etc/systemd/resolved.conf</dt><dd><ul class="simple">
<li><p>uncomment DNS and add 8.8.8.8 or whatever reachable nameserver is your preference</p></li>
<li><p>uncomment DNSStubListener and set to “no”</p></li>
</ul>
</dd>
</dl>
</li>
<li><p>sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf</p></li>
</ol>
<p>Port 53 should now be available for CoreDNS to use.</p>
<h2 id="docker-compose-install">Docker Compose Install<a class="headerlink" href="#docker-compose-install" title="Permalink to this headline"></a></h2>

10
docs/server-installation.rst
View file

@ -36,8 +36,16 @@ To run a non-docker installation, you are running the Netmaker binary, CoreDNS b
DNS Mode Prereqisite Setup (Ubuntu)
====================================
If you plan on running the
If you plan on running the server in DNS Mode, you will be deploying a CoreDNS server. We recommend binding CoreDNS to port 53 of the host system (which it will do by default). On some systems, this will conflift with existing processes. Specifically on linux systems running systemd-resolved, there may be a service consuming port 53. The below steps will disable systemd-resolved, and replace it with a generic (e.g. Google) nameserver. The following was tested on Ubuntu 20.04. This may have consequences for existing private DNS so proceed with caution:
1. systemctl stop systemd-resolved
2. systemctl disable systemd-resolved
3. vim /etc/systemd/resolved.conf
* uncomment DNS and add 8.8.8.8 or whatever reachable nameserver is your preference
* uncomment DNSStubListener and set to "no"
4. sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf
Port 53 should now be available for CoreDNS to use.
Docker Compose Install
=======================