blob: 52e373dea96cb5b19cafc08bb3259469d90c8091 [file] [log] [blame]
Charles Chancaebcf32021-09-20 22:17:52 -07001Development Guide
2=================
Charles Chaneeb2dc52021-10-07 12:29:41 -07003
4Background Knowledge
5--------------------
6
7NG-SDN Tutorial
8^^^^^^^^^^^^^^^
9We highly recommend people to go through the **NG-SDN Tutorial** as preparation for the SD-Fabric development work.
10You will learn all the required background knowledge and get opportunities
11to run hands-on experiments as part of the tutorial.
12The tutorial is free and publicly available at: https://github.com/opennetworkinglab/ngsdn-tutorial
13
14Reading Materials
15^^^^^^^^^^^^^^^^^
16- `SD-Fabric Techinar 2021 <https://opennetworking.org/events/sd-fabric-techinar/>`_
17
18 Introduction to the SD-Fabric project.
19
20- `Software-Defined Networks: A Systems Approach <https://sdn.systemsapproach.org>`_
21
22 Book about SDN in the context of P4, Stratum ONOS, whitebox switches, etc.
23 Even if you are already familiar with most of the concepts,
24 it should give you full-stack view of how we use programmable data planes at ONF.
25
26- `5G Mobile Networks: A Systems Approach <https://5g.systemsapproach.org>`_
27
28 Same as the SDN book but related to 5G architecture, a very good starting point to
29 get aligned with other ONF engineers around architecture and terminology for mobile networks.
30 Optional if your work will not be strictly related to Aether.
31
32- `Aether overview <https://youtu.be/ZzwFQCSmOJg>`_
33
34 There are many videos available on YouTube, this one should be the most recent.
35 Optional if your work will not be strictly related to Aether.
36
37- UP4 architecture
38
39 UP4 is the codename for our P4-based UPF project. Optional if your work will not be strictly related to Aether.
40
41 - `Blog post (Sep 2021) <https://opennetworking.org/news-and-events/blog/using-p4-and-programmable-switches-to-implement-a-4g-5g-upf-in-aether/>`_
42 - `Paper (Sep 2021) <https://www.cs.princeton.edu/~macdavid/media/up4-sosr21.pdf>`_
43 - `Slide deck <https://docs.google.com/presentation/d/1IlxsGKXPtqfFFAqORZV-N5OuCvoLloXQuKjvaL5Xf7M>`_
44
45- `Trellis architecture <https://docs.trellisfabric.org/1.12/architecture.html>`_
46
47 This document is based on an outdated, OF-DPA based data plane. But the control plane design logic remains the same.
48
49.. note::
50 We are working on development guides for ``fabric-tna`` pipeline and SD-Fabric control applications (``SegmentRouting``, ``UPF``, ``INT``).
51 More contents will be available shortly.