molecule-kubevirt 0.0.5

Driver

This driver supports Ansible 2, 3 and 4.

# Ansible >2
python3 -m pip install molecule-kubevirt

# Ansible 2
python3 -m pip install molecule-kubevirt 'openshift<0.12.0' 'kubernetes<12.0'

KubeVirt Installation

Follow KubeVirt guides for kind, minkube, or cloud providers

NodePort

NodePort can be set. Static nodePort can be defined, also host target for port can be set:

ssh_service:
  type: NodePort
  # optional static port
  nodePort: 32569
  # host where nodePort can be reached
  nodePort_host: localhost

ClusterIP

Default SSH Service is ClusterIP and a static clusterIP can be set:

ssh_service:
  type: ClusterIP
  clusterIP: 10.96.102.231

Molecule then needs to be able to ssh on the ClusterIP ip:

• if running local Kubernetes with Kind:

IP=$(docker container inspect kind-control-plane   --format '{{ .NetworkSettings.Networks.kind.IPAddress }}')
sudo ip route add 10.96.0.0/12 via $IP # Linux
# sudo route -n add 10.96.0.0/12 $IP # MacOSX

• if running local Kubernetes with Minikube, no known solution yet.

• if running molecule inside the target Kubernetes cluster, routing is ensured by CNI.

Full example

VirtualMachines setup can be fine tuned:

• annotations is empty by default

• domain is combined recursive with default, defaults lists are prepend

• user_data cloud-config is combined recursive with default, defaults lists are prepend

• volumes are appended to defaults

• networks is empty by default

This example configures a specific network, adds a disk backed by an empty volume, then disk is formated and mounted via cloud config:

# ask for static IP with Calico
annotations:
  - cni.projectcalico.org/ipAddrs: "[\"10.244.25.25\"]"
# combine domain to default
domain:
  devices:
    disks:
      # add a new disk
      - name: emptydisk
        disk:
          bus: virtio
    interfaces:
      # prefer masquerade instead of default bridge
      - masquerade: {}
        name: default
networks:
  - name: default
    # prefer multus instead of pod network as first network
    multus:
      default: true
      networkName: macvlan-test
volumes:
  - name: emptydisk
    # create a disk inside the VM Pod
    # can also be backed by PVC, hotspath, etc...
    emptyDisk:
      capacity: 2Gi
# custom cloud config - additional disks starts at index 3
# because both boot and cloud-config disks are created by driver
# therefore example additional disk is named 'vd**c**'
user_data:
  fs_setup:
    - label: data_disk
      filesystem: 'ext4'
      device: /dev/vdc
      overwrite: true
  mounts:
   - [ /dev/vdc, /var/lib/software, "auto", "defaults,nofail", "0", "0" ]

Please take a look at KubeVirt examples to get more information about more uses cases including PersistenVolumes, Multus, Multi node bridge, and more.