×

You can configure an IP address when you create a virtual machine (VM). The IP address is provisioned with cloud-init.

You can view the IP address of a VM by using the OKD web console or the command line. The network information is collected by the QEMU guest agent.

Configuring IP addresses for virtual machines

You can configure a static IP address when you create a virtual machine (VM) by using the web console or the command line.

You can configure a dynamic IP address when you create a VM by using the command line.

The IP address is provisioned with cloud-init.

Configuring an IP address when creating a virtual machine by using the command line

You can configure a static or dynamic IP address when you create a virtual machine (VM). The IP address is provisioned with cloud-init.

If the VM is connected to the pod network, the pod network interface is the default route unless you update it.

Prerequisites
  • The virtual machine is connected to a secondary network.

  • You have a DHCP server available on the secondary network to configure a dynamic IP for the virtual machine.

Procedure
  • Edit the spec.template.spec.volumes.cloudInitNoCloud.networkData stanza of the virtual machine configuration:

    • To configure a dynamic IP address, specify the interface name and enable DHCP:

      kind: VirtualMachine
      spec:
      # ...
        template:
        # ...
          spec:
            volumes:
            - cloudInitNoCloud:
                networkData: |
                  version: 2
                  ethernets:
                    eth1: (1)
                      dhcp4: true
      1 Specify the interface name.
    • To configure a static IP, specify the interface name and the IP address:

      kind: VirtualMachine
      spec:
      # ...
        template:
        # ...
          spec:
            volumes:
            - cloudInitNoCloud:
                networkData: |
                  version: 2
                  ethernets:
                    eth1: (1)
                      addresses:
                      - 10.10.10.14/24 (2)
      1 Specify the interface name.
      2 Specify the static IP address.

Viewing IP addresses of virtual machines

You can view the IP address of a VM by using the OKD web console or the command line.

The network information is collected by the QEMU guest agent.

Viewing the IP address of a virtual machine by using the web console

You can view the IP address of a virtual machine (VM) by using the OKD web console.

You must install the QEMU guest agent on a VM to view the IP address of a secondary network interface. A pod network interface does not require the QEMU guest agent.

Procedure
  1. In the OKD console, click VirtualizationVirtualMachines from the side menu.

  2. Select a VM to open the VirtualMachine details page.

  3. Click the Details tab to view the IP address.

Viewing the IP address of a virtual machine by using the command line

You can view the IP address of a virtual machine (VM) by using the command line.

You must install the QEMU guest agent on a VM to view the IP address of a secondary network interface. A pod network interface does not require the QEMU guest agent.

Procedure
  • Obtain the virtual machine instance configuration by running the following command:

    $ oc describe vmi <vmi_name>
    Example output
    # ...
    Interfaces:
       Interface Name:  eth0
       Ip Address:      10.244.0.37/24
       Ip Addresses:
         10.244.0.37/24
         fe80::858:aff:fef4:25/64
       Mac:             0a:58:0a:f4:00:25
       Name:            default
       Interface Name:  v2
       Ip Address:      1.1.1.7/24
       Ip Addresses:
         1.1.1.7/24
         fe80::f4d9:70ff:fe13:9089/64
       Mac:             f6:d9:70:13:90:89
       Interface Name:  v1
       Ip Address:      1.1.1.1/24
       Ip Addresses:
         1.1.1.1/24
         1.1.1.2/24
         1.1.1.4/24
         2001:de7:0:f101::1/64
         2001:db8:0:f101::1/64
         fe80::1420:84ff:fe10:17aa/64
       Mac:             16:20:84:10:17:aa

Additional resources