Adding content for configuring IP addresses (statis or dynamic) for VMs

Author: aburdenthehand

_topic_map.yml

@@ -2569,6 +2569,8 @@ Topics:
       File: virt-using-the-default-pod-network-with-virt
     - Name: Attaching a virtual machine to multiple networks
       File: virt-attaching-vm-multiple-networks
+    - Name: Configuring IP addresses for virtual machines
+      File: virt-configuring-ip-for-vms
     - Name: Configuring an SR-IOV network device for virtual machines
       File: virt-configuring-sriov-device-for-vms
     - Name: Defining an SR-IOV network

modules/virt-configuring-ip-for-new-vm-cloud-init.adoc

@@ -0,0 +1,49 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/vm_networking/virt-configuring-ip-for-vms.adoc
+
+[id="virt-configuring-ip-for-new-vm-cloud-init_{context}"]
+= Configuring an IP address for a new virtual machine using cloud-init
+
+You can use cloud-init to configure an IP address when you create a virtual machine. The IP address can be dynamically or statically provisioned.
+
+.Procedure
+
+* Create a virtual machine configuration and include the cloud-init network details in the `spec.volumes.cloudInitNoCloud.networkData` field of the virtual machine configuration:
+
+.. To configure a dynamic IP, specify the interface name and the `dhcp4` boolean:
++
+[source,yaml]
+----
+kind: VirtualMachine
+spec:
+...
+  volumes:
+  - cloudInitNoCloud:
+      networkData: |
+        version: 2
+        ethernets: 
+          eth1: <1>
+            dhcp4: true <2>
+----
+<1> The interface name.
+<2> Uses DHCP to provision an IPv4 address.
+
+.. To configure a static IP, specify the interface name and the IP address:
++
+[source,yaml]
+----
+kind: VirtualMachine
+spec:
+...
+  volumes:
+  - cloudInitNoCloud:
+      networkData: |
+        version: 2
+        ethernets:
+          eth1: <1>
+            addresses:
+            - 10.10.10.14/24 <2>
+----
+<1> The interface name.
+<2> The static IP address for the virtual machine.

virt/virtual_machines/vm_networking/virt-attaching-vm-multiple-networks.adoc

@@ -45,3 +45,8 @@ in the previous section.
 include::modules/virt-vm-create-nic-web.adoc[leveloffset=+1]
 
 include::modules/virt-networking-wizard-fields-web.adoc[leveloffset=+1]
+
+[id="{context}_additional-resources"]
+== Additional resources
+
+* xref:../../../virt/virtual_machines/vm_networking/virt-configuring-ip-for-vms.adoc#virt-configuring-ip-for-vms[Configuring IP addresses for virtual machines]

virt/virtual_machines/vm_networking/virt-configuring-ip-for-vms.adoc

@@ -0,0 +1,16 @@
+[id="virt-configuring-ip-for-vms"]
+= Configuring IP addresses for virtual machines
+include::modules/virt-document-attributes.adoc[]
+:context: virt-configuring-ip-for-vms
+toc::[]
+
+You can configure either dynamically or statically provisioned IP addresses for virtual machines.
+
+.Prerequisites
+
+* The virtual machine can connect to a xref:../../../virt/virtual_machines/vm_networking/virt-attaching-vm-multiple-networks.adoc#attaching-to-multiple-networks[secondary network]
+
+* To configure a dynamic IP for the virtual machine, you must have a DHCP server available on the secondary network.
+
+include::modules/virt-configuring-ip-for-new-vm-cloud-init.adoc[leveloffset=+1]
+