config: add Network type

Adds the basic network configuration that downstream components may wish
to configure.

config/v1/types_network.go

@@ -13,20 +13,50 @@ type Network struct {
 	// Standard object's metadata.
 	metav1.ObjectMeta `json:"metadata,omitempty"`
 
-	// spec holds user settable values for configuration
+	// Spec holds user settable values for configuration.
 	Spec NetworkSpec `json:"spec"`
-	// status holds observed values from the cluster. They may not be overridden.
+	// Status holds observed values from the cluster. They may not be overridden.
 	Status NetworkStatus `json:"status"`
 }
 
+// NetworkSpec is the desired network configuration.
+// As a general rule, this SHOULD NOT be used directly. Instead, you should
+// consume the NetworkStatus, as it indicates the currently deployed configuration.
 type NetworkSpec struct {
-	// serviceCIDR
-	// servicePortRange
-	// vxlanPort
-	// 	ClusterNetworks    []ClusterNetworkEntry `json:"clusterNetworks"`
+	// IP address pool to use for pod IPs.
+	ClusterNetworks []ClusterNetwork `json:"clusterNetworks"`
+
+	// IP address pool for services.
+	// Currently, we only support a single entry here.
+	ServiceNetworks []string `json:"serviceNetworks"`
+
+	// NetworkType is the plugin that is to be deployed (e.g. OpenShiftSDN).
+	// N.B. changing this is currently not supported.
+	NetworkType string `json:"networkType"`
 }
 
+// NetworkStatus is the current network configuration.
 type NetworkStatus struct {
+	// IP address pool to use for pod IPs.
+	ClusterNetworks []ClusterNetwork `json:"clusterNetworks"`
+
+	// IP address pool for services.
+	// Currently, we only support a single entry here.
+	ServiceNetworks []string `json:"serviceNetworks"`
+
+	// NetworkType is the plugin that is deployed (e.g. OpenShiftSDN).
+	NetworkType string `json:"networkType"`
+}
+
+// ClusterNetwork is a contiguous block of IP addresses from which pod IPs are
+// allocated.
+type ClusterNetwork struct {
+	// The complete block for pod IPs.
+	CIDR string `json:"cidr"`
+
+	// The size of subnet (in bits) to allocate to each node for pod allocations.
+	// For example, 8 indicates a /24 will be given to each node.
+	HostSubnetLength uint32 `json:"hostSubnetLength"`
 }
 
 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object