{"id":14970084,"url":"https://github.com/hashicorp/packer-plugin-vsphere","last_synced_at":"2025-04-13T08:57:41.985Z","repository":{"id":37848072,"uuid":"356315097","full_name":"hashicorp/packer-plugin-vsphere","owner":"hashicorp","description":"Packer plugin for VMware vSphere Builder","archived":false,"fork":false,"pushed_at":"2025-03-28T19:21:14.000Z","size":2275,"stargazers_count":109,"open_issues_count":21,"forks_count":96,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-03-30T04:05:23.742Z","etag":null,"topics":["packer","packer-plugin","vmware-vsphere","vsphere"],"latest_commit_sha":null,"homepage":"https://www.packer.io/docs/builders/vsphere","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hashicorp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-09T15:22:05.000Z","updated_at":"2025-03-20T20:27:52.000Z","dependencies_parsed_at":"2023-11-28T18:25:25.797Z","dependency_job_id":"a1510020-8820-42d7-9671-813a11d34a7e","html_url":"https://github.com/hashicorp/packer-plugin-vsphere","commit_stats":{"total_commits":1050,"total_committers":133,"mean_commits":7.894736842105263,"dds":0.8219047619047619,"last_synced_commit":"623ba0a7b88dd47d2c0fea4215201a4a56931aca"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":"hashicorp/packer-plugin-scaffolding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fpacker-plugin-vsphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fpacker-plugin-vsphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fpacker-plugin-vsphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fpacker-plugin-vsphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hashicorp","download_url":"https://codeload.github.com/hashicorp/packer-plugin-vsphere/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247436282,"owners_count":20938533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["packer","packer-plugin","vmware-vsphere","vsphere"],"created_at":"2024-09-24T13:43:01.221Z","updated_at":"2025-04-06T05:10:22.602Z","avatar_url":"https://github.com/hashicorp.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Packer Plugin for VMware vSphere\n\nThe Packer Plugin for VMware vSphere is a multi-component plugin can be used with\n[HashiCorp Packer][packer] to create virtual machine images for [VMware vSphere][docs-vsphere]®.\n\nThe plugin includes three builders and two post-processors which are able to create images,\ndepending on your desired strategy:\n\n**Builders**\n\n- `vsphere-iso` - This\n  builder starts from an ISO file and uses the vSphere API to build a virtual machine image on\n  an ESXi host.\n\n- `vsphere-clone` -\n  This builder clones a virtual machine from an existing template using the uses the vSphere API and\n  then modifies and saves it as a new template.\n\n- `vsphere-supervisor` -\n  This builder deploys and publishes new virtual machine to a vSphere Supervisor cluster using VM\n  Service.\n\n**Post-Processors**\n\n- `vsphere` - This post-processor uploads an artifact to a vSphere endpoint. The artifact must be a\n  VMX, OVA, or OVF file.\n\n- `vsphere-template` - This post-processor uses an artifact from the `vmware-iso` builder with an\n  ESXi host or an artifact from the [vSphere](/packer/plugins/post-processors/vsphere/vsphere)\n  post-processor. It then marks the virtual machine as a template and moves it to your specified\n  path.\n\n## Differences from the Packer Plugin for VMware\n\nWhile both this plugin and the `packer-plugin-vmware` are designed to create virtual machine images,\nthere are some key differences:\n\n- **Platforms**: This plugin is specifically developed to utilize the VMware vSphere API,\n  facilitating the creation of virtual machine images by integrating with VMware vCenter Server and the\n  VMware vSphere Hypervisor. On the other hand, `packer-plugin-vmware` supports a variety of\n  platforms including VMware vSphere Hypervisor and desktop virtualization products such as VMware\n  Fusion, VMware Workstation, and VMware Player, though it does not utilize the vSphere API for its\n  operations.\n\n- **Focus**: This plugin is purpose-built with a focus on VMware vSphere, offering capabilities such\n  as creating virtual machine images, cloning and modifying base virtual machine images, and\n  exporting artifacts in specified locations and formats. In contrast, `packer-plugin-vmware`\n  includes builders that operate on both VMware vSphere Hypervisor and the aforementioned desktop\n  virtualization products, providing a different set of functionalities, including support for\n  Vagrant.\n\nPlease refer to the documentation for each plugin to understand the specific capabilities and configuration options.\n\n## Requirements\n\n- [VMware vSphere][docs-vsphere]\n\n    The plugin supports versions in accordance with the [Broadcom Product Lifecycle][product-lifecycle].\n\n- [Go 1.22.8][golang-install]\n\n    Required if building the plugin.\n\n## Installation\n\n### Using Pre-built Releases\n\n#### Automatic Installation\n\nPacker v1.7.0 and later supports the `packer init` command which enables the automatic installation\nof Packer plugins. For more information, see the [Packer documentation][docs-packer-init].\n\nTo install this plugin, copy and paste this code (HCL2) into your Packer configuration and run\n`packer init`.\n\n```hcl\npacker {\n  required_version = \"\u003e= 1.7.0\"\n  required_plugins {\n    vsphere = {\n      version = \"\u003e= 1.4.2\"\n      source  = \"github.com/hashicorp/vsphere\"\n    }\n  }\n}\n```\n\n#### Manual Installation\n\nYou can download [pre-built binary releases][releases-vsphere-plugin] of the plugin on GitHub. Once\nyou have downloaded the latest release archive for your target operating system and architecture,\nextract the release archive to retrieve the plugin binary file for your platform.\n\nTo install the downloaded plugin, please follow the Packer documentation on [installing a plugin][docs-packer-plugin-install].\n\n### Using the Source\n\nIf you prefer to build the plugin from sources, clone the GitHub repository locally and run the\ncommand `go build` from the repository root directory. Upon successful compilation, a\n`packer-plugin-vsphere` plugin binary file can be found in the root directory.\n\nTo install the compiled plugin, please follow the Packer documentation on [installing a plugin][docs-packer-plugin-install].\n\n### Configuration\n\nFor more information on how to configure the plugin, please see the [plugin documentation][docs-vsphere-plugin].\n\n- `vsphere-iso` [builder documentation][docs-vsphere-iso]\n\n- `vsphere-clone` [builder documentation][docs-vsphere-clone]\n\n- `vsphere-supervisor` [builder documentation][docs-vsphere-supervisor]\n\n## Contributing\n\n- If you think you've found a bug in the code or you have a question regarding the usage of this\n  software, please reach out to us by opening an issue in this GitHub repository.\n\n- Contributions to this project are welcome: if you want to add a feature or a fix a bug, please do\n  so by opening a pull request in this GitHub repository. In case of feature contribution, we kindly\n  ask you to open an issue to discuss it beforehand.\n\n[docs-packer-init]: https://developer.hashicorp.com/packer/docs/commands/init\n[docs-packer-plugin-install]: https://developer.hashicorp.com/packer/docs/plugins/install-plugins\n[docs-vsphere]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere.html\n[docs-vsphere-clone]: https://developer.hashicorp.com/packer/plugins/builders/vsphere/vsphere-clone\n[docs-vsphere-iso]: https://developer.hashicorp.com/packer/plugins/builders/vsphere/vsphere-iso\n[docs-vsphere-supervisor]: https://developer.hashicorp.com/packer/plugins/builders/vsphere/vsphere-supervisor\n[docs-vsphere-plugin]: https://developer.hashicorp.com/packer/plugins/builders/vsphere\n[golang-install]: https://golang.org/doc/install\n[packer]: https://www.packer.io\n[releases-vsphere-plugin]: https://github.com/hashicorp/packer-plugin-vsphere/releases\n[product-lifecycle]: https://support.broadcom.com/group/ecx/productlifecycle\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fpacker-plugin-vsphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhashicorp%2Fpacker-plugin-vsphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fpacker-plugin-vsphere/lists"}