A set of roles for spinning up simple libvirt virtual machines for labs. This is primarily used in labs for spinning up machines for running Kubernetes, so some of the VMs used you'll note are tailored to this situation.
The host you run this against should be a CentOS (or potentially Fedora may work) host capable of running virtual machines.
An example inclusion of this role may look like:
- hosts: servers
roles:
- { role: redhat-nfvpe.vm-spinup }
By default, this role will spin up virtual machines, should you wish to remove those, use the teardown variable set to true.
# default to spin up, but, if teardown is true, tear down the VMs.
teardown: false
By default we spin up 4 machines. You may
ssh_proxy_enabled: false
ssh_proxy_user: root
system_default_ram_mb: 2048
system_default_cpus: 4
virtual_machines:
- name: kube-master
node_type: master
- name: kube-node-1
node_type: nodes
- name: kube-node-2
node_type: nodes
- name: kube-node-3
node_type: nodes
# Disk options -----------------------------------------
# Spare disk sizes (for virtual machines)
spare_disk_attach: true
spare_disk_size_megs: 10240
spare_disk_location: "/var/lib/libvirt/images"
spare_disk_dev: vdb
network_type indicates network environment for the virtual machines. "default" has one bridge and others are different for each purpose.
Note that this creates a bridge on the host as the name specified by bridge_network_name.
The virtual machines will be bridged to the bridge specified by bridge_name.
# Network type (default/ipv6)
network_type: "default"
# Enables a bridge to the outside LAN
# (as opposed to using virbr0)
bridge_name: virbr0
bridge_networking: false
# Virtualization host options.
bridge_physical_nic: "enp1s0f1"
bridge_network_name: "br0"
bridge_network_cidr: 192.168.1.0/24
# Creates a secondary nic on each VM with IPv6 addressing.
ipv6_enabled: false
You can define a static_ip for the virtual_machines list (see previous
section). If you do that, then that IP address will be passed to the
spinup.sh script that instantiates the virtual machine. In order for
networking to work with bridged networking and static IP addresses, you'll need
to define some extra networking configuration.
system_network: 192.168.1.0
system_netmask: 255.255.255.0
system_broadcast: 192.168.1.255
system_gateway: 192.168.1.254
system_nameservers: 192.168.1.1
system_dns_search: example.local
If you make use of static_ip configuration, you use it like this:
virtual_machines:
- name: openshift-lb
node_type: lb
system_ram_mb: 4096
static_ip: 192.168.1.64
- name: openshift-master-2
node_type: nodes
system_ram_mb: 8192
static_ip: 192.168.1.66
...
Options to control how you setup the host.
images_directory: /home/images
centos_genericcloud_url: "http://cloud.centos.org/centos/7/images/CentOS-7-x86_64-GenericCloud-1611.qcow2"
image_destination_name: CentOS-7-x86_64-GenericCloud.qcow2
# Allows one to skip the steps to initially setup a virthost
# convenient when iterating quickly.
skip_virthost_depedencies: false
One less used option is in the case of nested virtualization and using QEMU,
you may need to work-around setting the vCPUs, and can do so by setting, which
will cause there to be no --vcpus flag set during virt-install.
nested_virt_qemu_skip_vcpus: true
Apache v2.0
NFVPE @ Red Hat, Inc.