Skip to main content

Rejviz [ray-veez], VM / disk image tools built on top of libguestfs-tools.

Currently rejviz-builder command is implemented.

Commands

rejviz-builder

A command that proxies to virt-builder and adds a custom –nic option, which allows to configure network interfaces on the image (files /etc/sysconfig/network-scripts/ifcfg-ethX). All other options are passed to virt-builder untouched.

The format of the –nic parameter is:

--nic name=NAME[,key=VALUE]...

key = {name|hwaddr|bootproto|ipaddr|network|netmask|broadcast}

The values which are not specified can often be inferred (or in case of hwaddr, autogenerated to a random KVM MAC address).

  • If only name is specified, the bootproto is ‘dhcp’.

  • If name and ipaddr is specified, the bootproto is ‘static’ and and the other values are inferred as for a /32 network.

Example usage:

rejviz-builder centos-7.0 \
    -o mycentos.qcow2 --format qcow2 --size 15G \
    --hostname mycentos --root-password password:mypassword \
    --nic name=eth0 \
    --nic name=eth1,ipaddr=192.168.122.15 \
    --nic name=eth2,ipaddr=192.168.123.15

Design doc

Use cases

  • Create a VM image

    • From base image

    • Having some size

    • With some script run

    • With network interfaces configured (some DHCP, some static IPs)

    • Subscribed via RHSM

  • Create a VM

    • With network interface MAC addresses matching the interfaces from the image

    • With some RAM and vCPUs

  • Amend existing VM image (or libvirt domain)

    • Reconfigure network interfaces

    • Re-subscribe via RHSM

  • Tell me something about an image (or libvirt domain)

    • List network interfaces and their basic config

    • Check that MACs on the domain match MACs in /etc/sysconfig/network-scripts

I/O view

  • Creating an image

    • In: params

    • Out: image

    • rejviz-builder command that proxies to virt-builder and adds custom params on top (RHSM, network interfaces)

  • Creating a VM

    • In: image and params

    • Out: domain XML or created domain (both through virt-install)

    • rejviz-install command that proxies to virt-install and determines some of the parameters from the image

  • Amending an image (or libvirt domain)

    • In: (image or domname) and params

    • Out: image edited in place

    • rejviz-customize command that proxies to virt-customize and adds custom params on top (RHSM, network interfaces)

  • Image/domain introspection

    • In: (image or domname) and params

    • Out: information printed

    • rejviz-peek

Release files for rejviz 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rejviz 0.0.1
File Size Uploaded
rejviz-0.0.1.tar.gz 17.5 kB Details

Release files / rejviz-0.0.1.tar.gz

Download URL rejviz-0.0.1.tar.gz
Size 17.5 kB
Tags Source
SHA-256 checksum
How to use checksums
5530f4485d2f4776692fd55492955857aa144b5c6eebd326fc2a51d04b0a4da8
BLAKE2b-256 checksum
How to use checksums
e0649d5d35aa7b6d500ceb44b4fd9b61aac3a8d59569e0a9fb66d8b57eaea724
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page