Merge pull request #252 from microsoft/netplan

Add netplan-based network topology encoding

Author: abeltrano

CMakeLists.txt

@@ -161,6 +161,7 @@ if (WERROR)
   add_compile_options(-Werror)
 endif()
 
+add_subdirectory(config)
 add_subdirectory(packaging)
 add_subdirectory(src)
 

config/CMakeLists.txt

@@ -0,0 +1,2 @@
+
+add_subdirectory(linux)

config/linux/CMakeLists.txt

@@ -0,0 +1,2 @@
+
+add_subdirectory(network)

config/linux/network/CMakeLists.txt

@@ -0,0 +1,3 @@
+
+add_subdirectory(cloud)
+add_subdirectory(netplan)

config/linux/network/cloud/99-disable-network-config.cfg

@@ -0,0 +1 @@
+network: { config: disabled }

config/linux/network/cloud/CMakeLists.txt

@@ -0,0 +1,7 @@
+
+install(
+    FILES
+        ${CMAKE_CURRENT_LIST_DIR}/99-disable-network-config.cfg
+        DESTINATION ${CMAKE_INSTALL_SYSCONFDIR}/cloud/cloud.cfg.d
+        COMPONENT network-config
+)

config/linux/network/netplan/10-network-netremote-all.yaml

@@ -0,0 +1,36 @@
+#
+# This plan defines a network topology where a set of interfaces provide gateway services to wireless network clients.
+# 
+# Netplan YAML reference: https://netplan.readthedocs.io/en/stable/netplan-yaml/
+# 
+# Instructions:
+#   1. Identify all interfaces, ethernet or otherwise, that provide network services such as DHCP, DNS, etc. to wireless
+#   network clients. This will typically be, but is not limited to, a single ethernet interface.
+#   2. For each interface identified above:
+#     a. Add a network interface definition entry according to its type ('ethernets', 'vlans', etc.) which disables all
+#     IP addressing. See the netplan yaml reference URL above for complete options if necessary. 
+#     b. Add the interface name to the 'interfaces' property of the brgateway0 bridge definition to make the interface
+#     available to all bridge slaves.
+#   3. Re-generate ("render") the plan using 'sudo netplan generate'.
+#   4. Optionally validate the generated configuration using 'sudo netplan try'.
+#   5. Apply the generated configuration using 'sudo netplan apply'.
+#
+# The default template describes a plan where a single ethernet network interface 'eno2' provides all gateway services.
+#
+
+network:
+  version: 2
+  renderer: networkd
+  ethernets:
+    eno2: # ** Change this to the interface that provides gateway network services (DHCP, DNS, etc.). **
+      # Disable DHCP on all interfaces that will be part of the virtual bridge interface.
+      dhcp4: no
+      dhcp6: no
+  bridges:
+    # Define a bridge that will act as a gateway to wireless clients.
+    brgateway0:
+      # Configure the bridge to obtain its IP address using DHCP.
+      dhcp4: yes
+      # Include interfaces that provide the gateway services to wireless clients. DO NOT ADD wireless interfaces here.
+      interfaces:
+        - eno2

config/linux/network/netplan/CMakeLists.txt

@@ -0,0 +1,7 @@
+
+install(
+    FILES
+        ${CMAKE_CURRENT_LIST_DIR}/10-network-netremote-all.yaml
+        DESTINATION ${CMAKE_INSTALL_SYSCONFDIR}/netplan
+        COMPONENT network-config
+)

packaging/deb/CMakeLists.txt

@@ -13,6 +13,7 @@ set(CPACK_COMPONENTS_ALL
     server 
     hostapd
     dev
+    network-config
 )
 
 include(CPack)

src/linux/external/hostap/systemd/CMakeLists.txt

@@ -5,14 +5,8 @@ configure_file(
 )
 
 configure_file(
-    ${CMAKE_CURRENT_SOURCE_DIR}/[email protected]
-    ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
-    @ONLY
-)
-
-configure_file(
-    ${CMAKE_CURRENT_SOURCE_DIR}/[email protected]
-    ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
+    ${CMAKE_CURRENT_SOURCE_DIR}/[email protected]
+    ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
     @ONLY
 )
 
@@ -37,26 +31,14 @@ install(
 
 install(
     FILES
-        ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
-    CONFIGURATIONS Release
-    DESTINATION ${CMAKE_INSTALL_LIBDIR}/systemd/system
-    RENAME [email protected]
-    COMPONENT hostapd
-)
-
-install(
-    FILES
-        ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
-    CONFIGURATIONS Debug RelWithDebInfo MinSizeRel
+        ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
     DESTINATION ${CMAKE_INSTALL_LIBDIR}/systemd/system
-    RENAME [email protected]
     COMPONENT hostapd
 )
 
 install(
     FILES
         ${CMAKE_CURRENT_BINARY_DIR}/[email protected]
-    CONFIGURATIONS Debug RelWithDebInfo MinSizeRel
     DESTINATION ${CMAKE_INSTALL_LIBDIR}/systemd/system
     COMPONENT hostapd
 )