https://github.com/hashicorp/packer-plugin-kubevirt
Packer plugin for building KubeVirt images
https://github.com/hashicorp/packer-plugin-kubevirt
doormat-managed
Last synced: 5 months ago
JSON representation
Packer plugin for building KubeVirt images
- Host: GitHub
- URL: https://github.com/hashicorp/packer-plugin-kubevirt
- Owner: hashicorp
- Created: 2025-08-25T15:19:46.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-27T06:10:45.000Z (10 months ago)
- Last Synced: 2025-08-27T15:07:15.306Z (10 months ago)
- Topics: doormat-managed
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Packer Plugin KubeVirt
The `KubeVirt` plugin can be used with [HashiCorp Packer](https://www.packer.io) to create KubeVirt images.
**Note**: This plugin is under development and is not production ready.
## Packer
[Packer](https://developer.hashicorp.com/packer) is a tool for creating identical machine images from a single source template.
To get started, see the [Packer installation guide](https://developer.hashicorp.com/packer/install).
## Prerequisites
- [Packer](https://packer.io)
- [Kubernetes](https://kubernetes.io) with [KubeVirt](https://kubevirt.io) installed
## Plugin Features
- **HCL Templating** – Use HashiCorp Configuration Language (HCL2) for defining infrastructure as code.
- **ISO Installation** – Build VM golden images from ISO using the `kubevirt-iso` builder.
- **ISO Media Files** – Embed additional files into installation process (e.g. `ks.cfg` or `unattend.xml`).
- **Boot Command** – Automate the VM boot process using a set of commands (via a VNC connection).
- **Integrated SSH/WinRM Access** – Allows VM provisioning and customization via SSH or WinRM.
## Components
- `kubevirt-iso` - This builder starts from a ISO file and builds virtual machine image on a KubeVirt cluster.
### Design
## Installation
### Automatic Installation
Packer supports automatic installation of the Packer plugins.
To install this plugin, copy and paste this code into your Packer configuration:
```hcl
packer {
required_plugins {
kubevirt = {
source = "github.com/hashicorp/kubevirt"
version = ">= 0.8.0"
}
}
}
```
And now run `packer init` command. The plugin will be installed automatically.
### Manual Installation
Download the latest release from the [Releases](https://github.com/hashicorp/packer-plugin-kubevirt/releases) page and then install the plugin:
```shell
$ packer plugins install --path packer-plugin-kubevirt github.com/hashicorp/kubevirt
```
### Building From Source
Clone the repository and build the plugin from the root directory:
```shell
$ go build -ldflags="-X github.com/hashicorp/packer-plugin-kubevirt/version.Version=0.7.0" -o packer-plugin-kubevirt
```
Then install the compiled plugin:
```shell
$ packer plugins install --path packer-plugin-kubevirt github.com/hashicorp/kubevirt
```
## Usage
Refer to the usage guidance in the [examples](./examples/builder/kubevirt-iso) of this plugin.