Skip to content

Releases

ZSphere / ZSvirt Packer Plugin v0.1.0

Choose a tag to compare

@github-actions github-actions released this 16 Oct 15:04
010d0b3

ZSphere / ZSvirt Packer plugin v0.1.0

Initial release of the ZSphere / ZSvirt plugin for HashiCorp Packer.

Builders

  • zsvirt: provision a VM from an existing image or an imported image URL, then create a root-volume template.
  • zsvirt-iso: install an OS using unattended ISO media, verify hard-disk reboot, provision the guest, and create a template.
  • zsvirt-snapshot: convert an existing root-volume snapshot into an image without starting a VM or running provisioners.

Supports account or access-key authentication, port-group and L3 network selection, placement and sizing, SSH/WinRM, image export, and cleanup of build-owned temporary resources. Canceled builds halt before starting a guest shutdown command.

Installation

Packer 1.16.1 was used for installation and template-validation checks.

packer {
  required_plugins {
    zsvirt = {
      source  = "github.com/ZSvirt/zsvirty"
      version = "= 0.1.0"
    }
  }
}

Run packer init on your template directory. Keep the local alias zsvirt to use the three builder names above. Configure your own credentials and resources using the examples and documentation.

Release assets and verification

Prebuilt binaries are provided for Linux and FreeBSD (amd64, 386, arm, arm64), Windows (amd64, 386), and macOS (amd64, arm64). Cross-compilation does not certify guest compatibility for every target platform.

Download the ZIP for your Packer runner, packer-plugin-zsvirty_v0.1.0_SHA256SUMS, its .sig file, and packer-plugin-zsvirty-signing-key.asc. The release signing fingerprint is:

A1EA 6E02 2326 F885 099B 018F 6CBF E3F9 DB0C 13CC

Inspect the public key and compare its fingerprint with the one approved by the maintainers before importing it:

gpg --show-keys --with-fingerprint packer-plugin-zsvirty-signing-key.asc
gpg --import packer-plugin-zsvirty-signing-key.asc
gpg --verify packer-plugin-zsvirty_v0.1.0_SHA256SUMS.sig packer-plugin-zsvirty_v0.1.0_SHA256SUMS

Then compare the SHA-256 of your downloaded ZIP with its entry in the verified checksum file. For example, on macOS:

shasum -a 256 packer-plugin-zsvirty_v0.1.0_x5.0_darwin_arm64.zip

Validation and known limitations

The release candidate passed unit tests, the race detector, vet, SDK compatibility checks, Packer loading/template validation, generated-documentation checks, and cross-platform packaging/signature verification. Local acceptance records include complete Windows 11 24H2 and Windows Server 2022 unattended ISO, hard-disk reboot, HTTPS WinRM, image export, and output-template boot workflows in the tested environment.

  • ARM64 guest end-to-end acceptance has not been completed because an ARM64 host was unavailable. ARM64 binaries are cross-compiled.
  • The tested platform rejects creating a Ceph-backed image from a LocalStorage root volume when the required storage mediator is unavailable. Choose a platform-supported source/target storage combination.
  • On the tested ZSphere 5.5.38 ImageStore backend, the delete-export API reported success while the exported raw file remained downloadable. Set skip_export = true when a download copy is unnecessary; verify export cleanup on your backend. The Ceph deletion probe passed. See the acceptance guide.
  • Output images include the root disk only. Windows generalization/Sysprep and installation credential rotation remain the image author's responsibility.
  • Registration in the HashiCorp integrations directory is separate from GitHub release installation and is pending.