Oracle Linux Virtualization Manager (OLVM)

This plugin for HashiCorp Packer provides a builder for Oracle OLVM to create customized VM templates from either source templates, or source disk images. This may include, for example, Official Oracle Enterprise Linux OVA Templates, or compatible cloud disk images provided by many Linux distributions (Ubuntu, Debian, RockyLinux, CentOS, etc.)

Features

• VM template creation from either source templates or source disk images
• Support for Packer standard communicators and provisioners
• Optionally export template artifacts (in OVA format) for distribution
• Ability to troubleshoot build issues by disabling VM cleanup/deletion
• Configurable networking and OS network interface name
• Configurable storage interface (virtio-scsi, virtio)
• Automatic session reconnection for long-running provisioners with configurable retry limits

Installation

Prerequisites

• Packer >= v1.10.2
• Access to an OLVM environment
• Access/connectivity to the OLVM API

Using Pre-Built Releases

Using packer init (Preferred)

The packer init command automatically installs any required Packer plugins defined in your configuration. To install this plugin, copy and paste this code into your Packer configuration, then run packer init.

packer {
  required_plugins {
    olvm = {
      version = ">= 1.0.4"
      source  = "github.com/mikelaws/olvm"
    }
  }
}

Using packer plugins (Automatic)

Packer plugins may be installed automatically using the packer plugins command. Simply run the following command to automatically download and install the plugin, or see the Packer documentation for more details.

$ packer plugins install github.com/mikelaws/olvm

Using packer plugins (Manual)

Packer plugins may be installed manually using the packer plugins command. Please find the binary release of the OLVM plugin for your operating system/platform here, then uncompress the archive to find the pre-built binary file. Install the plugin binary file using the steps outlined in the Packer documentation.

Build From Source (Advanced)

If you prefer to build the plugin from source, clone the GitHub repository locally and run the command make build from the root of the repository tree. Upon successful compilation, the packer-plugin-olvm plugin binary file can be found in the bin/ directory. To install the compiled plugin, please follow the Packer plugins documentation.

git clone https://github.com/mikelaws/packer-plugin-olvm.git
cd packer-plugin-olvm
make build

Configuration

• Builder - Configuring the primary olvm builder used to create OLVM VM templates.

License

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for details.

Contributing

• Support/Bug Reports - If you think you've found a bug, or you hit a snag and need some help, please open an issue in this repository.
• Code Contributions - Contributions are also welcome! If you have an idea for a feature, or want to fix a bug, please start by opening an issue to capture the conversation, then fork this repository, push your changes to your fork, and finally open a Pull Request in this repository.