Skip to content

feat: add local ovf/ova source support#751

Merged
tenthirtyam merged 1 commit into
mainfrom
feat/local-ovf-clone-source
Jul 9, 2026
Merged

feat: add local ovf/ova source support#751
tenthirtyam merged 1 commit into
mainfrom
feat/local-ovf-clone-source

Conversation

@tenthirtyam

@tenthirtyam tenthirtyam commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Summary

Note

Targeted for milestone v2.3.0.

Extends the vsphere-clone builder's ovf_source block to support local OVF/OVA files using path, alongside the existing remote OVF/OVA using url and related arguments..

Local OVF/OVA support lets users deploy virtual machines from .ovf (with sibling disks) or .ova archives on the host filesystem.

  • Adds path to ovf_source, mutually exclusive with url.
  • Requires the file to exist at prepare time; reject auth/TLS options when using path.
  • Adds shared OVF archive abstraction (remote + local) used by deploy and options validation.
  • Emits ource_ovf_path artifact metadata for local sources.
  • Updates documentation and related scripts on in-repo documentation.
  • Moves all OVF helper tests alongside the code in ovf_*_test.go files.

Type

  • fix: Bug Fix
  • feat: Feature or Enhancement
  • docs: Documentation
  • refactor: Refactoring
  • chore: Build, Dependencies, Workflows, etc.
  • other: Other (Please describe.)

Breaking Changes?

  • Yes, there are breaking changes.
  • No, there are no breaking changes.

Tests

  • Tests have been added or updated.

  • Tests have been completed.

    ✅ All added or updated unit tests have passed.

    ✅ All manual tests have passed.

    • Clone from local OVA from absolute path.
    • Clone from local OVA from relative path.
    • Clone from local OVF from absolute path.
    • Clone from local OVF from relative path.
    • Clone from local OVA with vApp Properties.
    • Clone from local OVF with vApp Properties.
    • Additionally, negative testing for expected conflicts and error messages.
    • Remote OVF/OVA regression testing.

Documentation

  • Documentation has been added or updated.
image

Issue References

Closes #567

Release Note

Additional Information

@tenthirtyam tenthirtyam added this to the v2.3.0 milestone Jul 8, 2026
@tenthirtyam tenthirtyam self-assigned this Jul 8, 2026
@tenthirtyam tenthirtyam requested a review from a team as a code owner July 8, 2026 18:35
@tenthirtyam tenthirtyam added the enhancement Enhancement label Jul 8, 2026
@github-actions github-actions Bot added documentation Documentation needs-review Needs Review size/xl Relative Sizing: Extra-Large labels Jul 8, 2026
@tenthirtyam tenthirtyam changed the title feat: add remote ovf/ova source support feat: add local ovf/ova source support Jul 8, 2026
@tenthirtyam tenthirtyam force-pushed the feat/local-ovf-clone-source branch from 6224fa4 to 0df779b Compare July 8, 2026 18:35
@tenthirtyam tenthirtyam marked this pull request as draft July 8, 2026 18:41
@tenthirtyam tenthirtyam changed the title feat: add local ovf/ova source support [wip] feat: add local ovf/ova source support Jul 8, 2026
@tenthirtyam tenthirtyam changed the title [wip] feat: add local ovf/ova source support feat: add local ovf/ova source support Jul 8, 2026
@tenthirtyam tenthirtyam marked this pull request as ready for review July 8, 2026 19:06
@tenthirtyam tenthirtyam force-pushed the feat/local-ovf-clone-source branch 3 times, most recently from 0c3bd42 to 8b01d3c Compare July 9, 2026 13:52
Extends the `vsphere-clone` builder's `ovf_source` block to support local OVF/OVA files using `path`, alongside the existing remote OVF/OVA using `url` and related arguments..

Local OVF/OVA support lets users deploy virtual machines from `.ovf` (with sibling disks) or `.ova` archives on the host filesystem.

- Adds `path` to `ovf_source`, mutually exclusive with `url`.
- Requires the file to exist at prepare time; reject auth/TLS options when using `path`.
- Adds shared OVF archive abstraction (remote + local) used by deploy and options validation.
- Emits `ource_ovf_path` artifact metadata for local sources.
- Updates documentation and related scripts on in-repo documentation.
- Moves all OVF helper tests alongside the code in `ovf_*_test.go` files.

Ref: #567

Signed-off-by: Ryan Johnson <ryan@tenthirtyam.org>
@tenthirtyam tenthirtyam force-pushed the feat/local-ovf-clone-source branch from 8b01d3c to 7c291aa Compare July 9, 2026 17:02
@tenthirtyam tenthirtyam removed the needs-review Needs Review label Jul 9, 2026
@tenthirtyam tenthirtyam merged commit 56ccb94 into main Jul 9, 2026
11 checks passed
@tenthirtyam tenthirtyam deleted the feat/local-ovf-clone-source branch July 9, 2026 17:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation enhancement Enhancement size/xl Relative Sizing: Extra-Large

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Extend the vsphere-clone builder to support using local OVF and OVA files as clone sources

1 participant