tutorials.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  6. <meta name="viewport" content="width=device-width,initial-scale=1">
  7. <meta http-equiv="x-ua-compatible" content="ie=edge">
  8. <meta name="lang:clipboard.copy" content="Copy to clipboard">
  9. <meta name="lang:clipboard.copied" content="Copied to clipboard">
  10. <meta name="lang:search.language" content="en">
  11. <meta name="lang:search.pipeline.stopwords" content="True">
  12. <meta name="lang:search.pipeline.trimmer" content="True">
  13. <meta name="lang:search.result.none" content="No matching documents">
  14. <meta name="lang:search.result.one" content="1 matching document">
  15. <meta name="lang:search.result.other" content="# matching documents">
  16. <meta name="lang:search.tokenizer" content="[\s\-]+">
  17. <link href="https://fonts.gstatic.com/" rel="preconnect" crossorigin>
  18. <link href="https://fonts.googleapis.com/css?family=Roboto+Mono:400,500,700|Roboto:300,400,400i,700&display=fallback" rel="stylesheet">
  19. <style>
  20. body,
  21. input {
  22. font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif
  23. }
  24. code,
  25. kbd,
  26. pre {
  27. font-family: "Roboto Mono", "Courier New", Courier, monospace
  28. }
  29. </style>
  30. <link rel="stylesheet" href="_static/stylesheets/application.css"/>
  31. <link rel="stylesheet" href="_static/stylesheets/application-palette.css"/>
  32. <link rel="stylesheet" href="_static/stylesheets/application-fixes.css"/>
  33. <link rel="stylesheet" href="_static/fonts/material-icons.css"/>
  34. <meta name="theme-color" content="#3f51b5">
  35. <script src="_static/javascripts/modernizr.js"></script>
  36. <title>Tutorials &#8212; Netmaker 0.3.5 documentation</title>
  37. <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  38. <link rel="stylesheet" href="_static/material.css" type="text/css" />
  39. <script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
  40. <script src="_static/jquery.js"></script>
  41. <script src="_static/underscore.js"></script>
  42. <script src="_static/doctools.js"></script>
  43. <link rel="index" title="Index" href="genindex.html" />
  44. <link rel="search" title="Search" href="search.html" />
  45. <link rel="next" title="API Usage" href="api.html" />
  46. <link rel="prev" title="Quick Start" href="quick-start.html" />
  47. </head>
  48. <body dir=ltr
  49. data-md-color-primary=indigo data-md-color-accent=light-blue>
  50. <svg class="md-svg">
  51. <defs data-children-count="0">
  52. <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448" viewBox="0 0 416 448" id="__github"><path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 22 8 38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0 37.25-1.75t35-7.375 30.5-15 20.25-25.75T360 304zm56-44q0 51.75-15.25 82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25 30.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34 99.5z"/></svg>
  53. </defs>
  54. </svg>
  55. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer">
  56. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search">
  57. <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
  58. <a href="#tutorials" tabindex="1" class="md-skip"> Skip to content </a>
  59. <header class="md-header" data-md-component="header">
  60. <nav class="md-header-nav md-grid">
  61. <div class="md-flex navheader">
  62. <div class="md-flex__cell md-flex__cell--shrink">
  63. <a href="index.html" title="Netmaker 0.3.5 documentation"
  64. class="md-header-nav__button md-logo">
  65. <i class="md-icon">&#xe869</i>
  66. </a>
  67. </div>
  68. <div class="md-flex__cell md-flex__cell--shrink">
  69. <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
  70. </div>
  71. <div class="md-flex__cell md-flex__cell--stretch">
  72. <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
  73. <span class="md-header-nav__topic">Netmaker Docs</span>
  74. <span class="md-header-nav__topic"> Tutorials </span>
  75. </div>
  76. </div>
  77. <div class="md-flex__cell md-flex__cell--shrink">
  78. <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
  79. <div class="md-search" data-md-component="search" role="dialog">
  80. <label class="md-search__overlay" for="__search"></label>
  81. <div class="md-search__inner" role="search">
  82. <form class="md-search__form" action="search.html" method="GET" name="search">
  83. <input type="text" class="md-search__input" name="q" placeholder="Search"
  84. autocapitalize="off" autocomplete="off" spellcheck="false"
  85. data-md-component="query" data-md-state="active">
  86. <label class="md-icon md-search__icon" for="__search"></label>
  87. <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
  88. &#xE5CD;
  89. </button>
  90. </form>
  91. <div class="md-search__output">
  92. <div class="md-search__scrollwrap" data-md-scrollfix>
  93. <div class="md-search-result" data-md-component="result">
  94. <div class="md-search-result__meta">
  95. Type to start searching
  96. </div>
  97. <ol class="md-search-result__list"></ol>
  98. </div>
  99. </div>
  100. </div>
  101. </div>
  102. </div>
  103. </div>
  104. <div class="md-flex__cell md-flex__cell--shrink">
  105. <div class="md-header-nav__source">
  106. <a href="https://github.com/gravitl/netmaker/" title="Go to repository" class="md-source" data-md-source="github">
  107. <div class="md-source__icon">
  108. <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width="28" height="28">
  109. <use xlink:href="#__github" width="24" height="24"></use>
  110. </svg>
  111. </div>
  112. <div class="md-source__repository">
  113. Netmaker
  114. </div>
  115. </a>
  116. </div>
  117. </div>
  118. <script src="_static/javascripts/version_dropdown.js"></script>
  119. <script>
  120. var json_loc = ""versions.json"",
  121. target_loc = "../",
  122. text = "Versions";
  123. $( document ).ready( add_version_dropdown(json_loc, target_loc, text));
  124. </script>
  125. </div>
  126. </nav>
  127. </header>
  128. <div class="md-container">
  129. <nav class="md-tabs" data-md-component="tabs">
  130. <div class="md-tabs__inner md-grid">
  131. <ul class="md-tabs__list">
  132. <li class="md-tabs__item"><a href="index.html" class="md-tabs__link">Netmaker 0.3.5 documentation</a></li>
  133. </ul>
  134. </div>
  135. </nav>
  136. <main class="md-main">
  137. <div class="md-main__inner md-grid" data-md-component="container">
  138. <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
  139. <div class="md-sidebar__scrollwrap">
  140. <div class="md-sidebar__inner">
  141. <nav class="md-nav md-nav--primary" data-md-level="0">
  142. <label class="md-nav__title md-nav__title--site" for="__drawer">
  143. <a href="index.html" title="Netmaker 0.3.5 documentation" class="md-nav__button md-logo">
  144. <i class="md-icon">&#xe869</i>
  145. </a>
  146. <a href="index.html"
  147. title="Netmaker 0.3.5 documentation">Netmaker Docs</a>
  148. </label>
  149. <div class="md-nav__source">
  150. <a href="https://github.com/gravitl/netmaker/" title="Go to repository" class="md-source" data-md-source="github">
  151. <div class="md-source__icon">
  152. <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width="28" height="28">
  153. <use xlink:href="#__github" width="24" height="24"></use>
  154. </svg>
  155. </div>
  156. <div class="md-source__repository">
  157. Netmaker
  158. </div>
  159. </a>
  160. </div>
  161. <ul class="md-nav__list">
  162. <li class="md-nav__item">
  163. <a href="introduction.html" class="md-nav__link">Introduction</a>
  164. <ul class="md-nav__list">
  165. <li class="md-nav__item">
  166. <a href="introduction.html#use-cases" class="md-nav__link">Use Cases</a>
  167. </li>
  168. <li class="md-nav__item">
  169. <a href="introduction.html#compatible-systems" class="md-nav__link">Compatible Systems</a>
  170. </li>
  171. <li class="md-nav__item">
  172. <a href="introduction.html#license" class="md-nav__link">License</a>
  173. </li>
  174. <li class="md-nav__item">
  175. <a href="introduction.html#contact" class="md-nav__link">Contact</a>
  176. </li></ul>
  177. </li>
  178. <li class="md-nav__item">
  179. <a href="quick-start.html" class="md-nav__link">Quick Start</a>
  180. </li>
  181. <li class="md-nav__item">
  182. <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  183. <label class="md-nav__link md-nav__link--active" for="__toc"> Tutorials </label>
  184. <a href="#" class="md-nav__link md-nav__link--active">Tutorials</a>
  185. <nav class="md-nav md-nav--secondary">
  186. <label class="md-nav__title" for="__toc">Contents</label>
  187. <ul class="md-nav__list" data-md-scrollfix="">
  188. <li class="md-nav__item"><a href="#tutorials--page-root" class="md-nav__link">Tutorials</a><nav class="md-nav">
  189. <ul class="md-nav__list">
  190. <li class="md-nav__item"><a href="#video-tutorials" class="md-nav__link">Video Tutorials</a>
  191. </li>
  192. <li class="md-nav__item"><a href="#written-tutorials" class="md-nav__link">Written Tutorials</a>
  193. </li></ul>
  194. </nav>
  195. </li>
  196. </ul>
  197. </nav>
  198. <ul class="md-nav__list">
  199. <li class="md-nav__item">
  200. <a href="#video-tutorials" class="md-nav__link">Video Tutorials</a>
  201. </li>
  202. <li class="md-nav__item">
  203. <a href="#written-tutorials" class="md-nav__link">Written Tutorials</a>
  204. </li></ul>
  205. </li>
  206. <li class="md-nav__item">
  207. <a href="api.html" class="md-nav__link">API Usage</a>
  208. </li>
  209. <li class="md-nav__item">
  210. <a href="api.html#authentication" class="md-nav__link">Authentication</a>
  211. </li>
  212. <li class="md-nav__item">
  213. <a href="api.html#format-of-calls-for-curl" class="md-nav__link">Format of Calls for Curl</a>
  214. </li>
  215. <li class="md-nav__item">
  216. <a href="api.html#api-documentation" class="md-nav__link">API Documentation</a>
  217. <ul class="md-nav__list">
  218. <li class="md-nav__item">
  219. <a href="api.html#networks-api" class="md-nav__link">Networks API</a>
  220. </li>
  221. <li class="md-nav__item">
  222. <a href="api.html#networks-api-call-examples" class="md-nav__link">Networks API Call Examples</a>
  223. </li>
  224. <li class="md-nav__item">
  225. <a href="api.html#access-keys-api" class="md-nav__link">Access Keys API</a>
  226. </li>
  227. <li class="md-nav__item">
  228. <a href="api.html#access-keys-api-call-examples" class="md-nav__link">Access Keys API Call Examples</a>
  229. </li>
  230. <li class="md-nav__item">
  231. <a href="api.html#nodes-api" class="md-nav__link">Nodes API</a>
  232. </li>
  233. <li class="md-nav__item">
  234. <a href="api.html#nodes-api-call-examples" class="md-nav__link">Nodes API Call Examples</a>
  235. </li>
  236. <li class="md-nav__item">
  237. <a href="api.html#users-api" class="md-nav__link">Users API</a>
  238. </li>
  239. <li class="md-nav__item">
  240. <a href="api.html#users-api-calls-examples" class="md-nav__link">Users API Calls Examples</a>
  241. </li>
  242. <li class="md-nav__item">
  243. <a href="api.html#server-management-api" class="md-nav__link">Server Management API</a>
  244. </li>
  245. <li class="md-nav__item">
  246. <a href="api.html#file-server-api" class="md-nav__link">File Server API</a>
  247. </li></ul>
  248. </li>
  249. <li class="md-nav__item">
  250. <a href="conduct.html" class="md-nav__link">Code of Conduct</a>
  251. <ul class="md-nav__list">
  252. <li class="md-nav__item">
  253. <a href="conduct.html#our-pledge" class="md-nav__link">Our Pledge</a>
  254. </li>
  255. <li class="md-nav__item">
  256. <a href="conduct.html#our-standards" class="md-nav__link">Our Standards</a>
  257. </li>
  258. <li class="md-nav__item">
  259. <a href="conduct.html#our-responsibilities" class="md-nav__link">Our Responsibilities</a>
  260. </li>
  261. <li class="md-nav__item">
  262. <a href="conduct.html#scope" class="md-nav__link">Scope</a>
  263. </li>
  264. <li class="md-nav__item">
  265. <a href="conduct.html#enforcement" class="md-nav__link">Enforcement</a>
  266. </li>
  267. <li class="md-nav__item">
  268. <a href="conduct.html#attribution" class="md-nav__link">Attribution</a>
  269. </li></ul>
  270. </li>
  271. </ul>
  272. </nav>
  273. </div>
  274. </div>
  275. </div>
  276. <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
  277. <div class="md-sidebar__scrollwrap">
  278. <div class="md-sidebar__inner">
  279. <nav class="md-nav md-nav--secondary">
  280. <label class="md-nav__title" for="__toc">Contents</label>
  281. <ul class="md-nav__list" data-md-scrollfix="">
  282. <li class="md-nav__item"><a href="#tutorials--page-root" class="md-nav__link">Tutorials</a><nav class="md-nav">
  283. <ul class="md-nav__list">
  284. <li class="md-nav__item"><a href="#video-tutorials" class="md-nav__link">Video Tutorials</a>
  285. </li>
  286. <li class="md-nav__item"><a href="#written-tutorials" class="md-nav__link">Written Tutorials</a>
  287. </li></ul>
  288. </nav>
  289. </li>
  290. </ul>
  291. </nav>
  292. </div>
  293. </div>
  294. </div>
  295. <div class="md-content">
  296. <article class="md-content__inner md-typeset" role="main">
  297. <h1 id="tutorials--page-root">Tutorials<a class="headerlink" href="#tutorials--page-root" title="Permalink to this headline">¶</a></h1>
  298. <p>Members of the community have created helpful tutorials for getting started with Netmaker. Below are some selected tutorials on different topics.</p>
  299. <h2 id="video-tutorials">Video Tutorials<a class="headerlink" href="#video-tutorials" title="Permalink to this headline">¶</a></h2>
  300. <ul class="simple">
  301. <li><p><a class="reference external" href="https://youtu.be/PWLPT320Ybo">Intro/Overview</a>: Tutorial on first-time usage, setting up a mesh network.</p></li>
  302. <li><p><a class="reference external" href="https://youtu.be/krCKBJhwwDk">Site-to-Site Gateway</a>: Tutorial on setting up site-to-site connections, allowing peers to access external networks via gateways.</p></li>
  303. <li><p><a class="reference external" href="https://youtu.be/b4diaKWUcXI">IPv6 and Private DNS</a>: Tutorial on dual-stack IPv6 in Netmaker and Private DNS management (separate topics).</p></li>
  304. <li><p><a class="reference external" href="https://youtu.be/z2jvlFVU3dw">Kubernetes Networking</a>: Tutorial on setting up cross-cloud Kubernetes clusters using Netmaker.</p></li>
  305. </ul>
  306. <h2 id="written-tutorials">Written Tutorials<a class="headerlink" href="#written-tutorials" title="Permalink to this headline">¶</a></h2>
  307. <ul class="simple">
  308. <li><p><a class="reference external" href="https://itnext.io/how-to-deploy-a-single-kubernetes-cluster-across-multiple-clouds-using-k3s-and-wireguard-a5ae176a6e81">Kubernetes Networking</a>: Tutorial on setting up cross-cloud Kubernetes clusters using Netmaker.</p></li>
  309. </ul>
  310. </article>
  311. </div>
  312. </div>
  313. </main>
  314. </div>
  315. <footer class="md-footer">
  316. <div class="md-footer-nav">
  317. <nav class="md-footer-nav__inner md-grid">
  318. <a href="quick-start.html" title="Quick Start"
  319. class="md-flex md-footer-nav__link md-footer-nav__link--prev"
  320. rel="prev">
  321. <div class="md-flex__cell md-flex__cell--shrink">
  322. <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
  323. </div>
  324. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
  325. <span class="md-flex__ellipsis">
  326. <span
  327. class="md-footer-nav__direction"> Previous </span> Quick Start </span>
  328. </div>
  329. </a>
  330. <a href="api.html" title="API Usage"
  331. class="md-flex md-footer-nav__link md-footer-nav__link--next"
  332. rel="next">
  333. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"><span
  334. class="md-flex__ellipsis"> <span
  335. class="md-footer-nav__direction"> Next </span> API Usage </span>
  336. </div>
  337. <div class="md-flex__cell md-flex__cell--shrink"><i
  338. class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
  339. </div>
  340. </a>
  341. </nav>
  342. </div>
  343. <div class="md-footer-meta md-typeset">
  344. <div class="md-footer-meta__inner md-grid">
  345. <div class="md-footer-copyright">
  346. <div class="md-footer-copyright__highlight">
  347. &#169; Copyright 2021, Alex Feiszli.
  348. </div>
  349. Created using
  350. <a href="http://www.sphinx-doc.org/">Sphinx</a> 3.5.4.
  351. and
  352. <a href="https://github.com/bashtage/sphinx-material/">Material for
  353. Sphinx</a>
  354. </div>
  355. </div>
  356. </div>
  357. </footer>
  358. <script src="_static/javascripts/application.js"></script>
  359. <script>app.initialize({version: "1.0.4", url: {base: ".."}})</script>
  360. </body>
  361. </html>