From c609361422d0a296c048238dd72c0fc17eb6d12c Mon Sep 17 00:00:00 2001
From: Ron Stone <ronald.stone@windriver.com>
Date: Thu, 10 Mar 2022 14:27:31 -0500
Subject: [PATCH] IPv4 & 6 address requirements

Add reference table for IP address requirements on
various plaform networks.

Reimplements https://review.opendev.org/c/starlingx/docs/+/832800
on r5.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Ia6857ecfae206c88d7a56f393bb01e5afef02ef1
---
 doc/source/planning/kubernetes/index.rst      |  1 +
 ...k-addressing-requirements-2fac0035b878.rst | 99 +++++++++++++++++++
 2 files changed, 100 insertions(+)
 create mode 100644 doc/source/planning/kubernetes/network-addressing-requirements-2fac0035b878.rst

diff --git a/doc/source/planning/kubernetes/index.rst b/doc/source/planning/kubernetes/index.rst
index 612691473..f8b4a2b67 100755
--- a/doc/source/planning/kubernetes/index.rst
+++ b/doc/source/planning/kubernetes/index.rst
@@ -33,6 +33,7 @@ Network planning
    network-planning-the-pxe-boot-network
    the-cluster-host-network
    the-storage-network
+   network-addressing-requirements-2fac0035b878
 
 Internal management network
 ***************************
diff --git a/doc/source/planning/kubernetes/network-addressing-requirements-2fac0035b878.rst b/doc/source/planning/kubernetes/network-addressing-requirements-2fac0035b878.rst
new file mode 100644
index 000000000..17436a22d
--- /dev/null
+++ b/doc/source/planning/kubernetes/network-addressing-requirements-2fac0035b878.rst
@@ -0,0 +1,99 @@
+
+.. zff1612526659434
+.. _network-addressing-requirements-2fac0035b878:
+
+===============================
+Network Addressing Requirements
+===============================
+
+Network addressing requirements must be taken into consideration when planning
+a |prod-long| installation.
+
+
+.. _minimum_subnet_sizes-simpletable-kfn-qwk-nx:
+
+.. list-table:: IPv4 Network Addressing Requirements
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - Network
+     - Recommended Prefix Length
+     - Minimum Hosts
+     - Maximum Hosts
+     - Example
+   * - oam
+     - 24
+     - 3
+     - 2\ :superscript:`24`
+     - 10.10.10.0/24
+   * - pxeboot
+     - 24
+     - 3
+     - 2\ :superscript:`24`
+     - 169.254.202.0/24
+   * - management
+     - 24
+     - 4
+     - 2\ :superscript:`24`
+     - 192.168.204.0/24
+   * - multicast
+     - 28
+     - 4
+     - 2\ :superscript:`8`
+     - 239.1.1.0/28
+   * - cluster-host
+     - 24
+     - 3
+     - 2\ :superscript:`24`
+     - 192.168.206.0/24
+   * - cluster-pod
+     - 16
+     - 65536
+     - 2\ :superscript:`24`
+     - 172.16.0.0/16
+   * - cluster-service
+     - 12
+     - 65536
+     - 2\ :superscript:`20`
+     - 10.96.0.0/12
+
+.. list-table:: IPv6 Network Addressing Requirements
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - Network
+     - Recommended Prefix Length
+     - Minimum Hosts
+     - Maximum Hosts
+     - Example
+   * - oam
+     - 64
+     - 3
+     - 2\ :superscript:`64`
+     - 2001:db8:1::/64
+   * - management
+     - 64
+     - 4
+     - 2\ :superscript:`64`
+     - 2001:db8:2::/64
+   * - multicast
+     - 124
+     - 4
+     - 2\ :superscript:`8`
+     - ff08::1:1:0/124
+   * - cluster-host
+     - 64
+     - 3
+     - 2\ :superscript:`64`
+     - 2001:db8:3::/64
+   * - cluster-pod
+     - 64
+     - 65536
+     - 2\ :superscript:`64`
+     - 2001:db8:4::/64
+   * - cluster-service
+     - 112
+     - 65536
+     - 2\ :superscript:`20`
+     - 2001:db8:5::/112
+