# Pulumi Native ESXi Provider
This repository crates a VMWare ESXi provider to provision VMs directly on an ESXi hypervisor without a need for vCenter or vSphere.
The repository is created based on the Terraform Provider [terraform-provider-esxi](https://github.com/josenk/terraform-provider-esxi/tree/master).
Thanks to the wonderful work done there by [@josenk](https://github.com/josenk), I was able to build this provider for Pulumi users.
## IMPORTANT NOTES!
**Note for Pull Requests (PRs)**: When creating a pull request, please do it onto the **MAIN branch** which is
the consolidated work-in-progress branch. Do not request it onto another branch.
> **PLEASE** Read our [branch guide](branch-guide.md) to know about our branching policy
>
> ### CONTRIBUTING
>
> **IMPORTANT:** The contribution details are stated [here](CONTRIBUTING.md)
## Requirements
- The VMware [ovftool](https://customerconnect.vmware.com/downloads/get-download?downloadGroup=OVFTOOL443) is required to be installed in the workstation where pulumi will be executed.
> **NOTE:** `ovftool` installer for windows doesn't put ovftool.exe in your path.
You will need to manually set your path.
- You MUST enable ssh access on your ESXi hypervisor.
> Google 'How to enable ssh access on esxi'
>- In general, you should know how to use terraform, esxi and some networking...
* You will most likely need a DHCP server on your primary network if you are deploying VMs with public OVF/OVA/VMX images. (Sources that have unconfigured primary interfaces.)
- The source OVF/OVA/VMX images must have open-vm-tools or vmware-tools installed to properly import an IPAddress. (you need this to run provisioners)
## Features and Compatibility
* Source image can be a clone of a VM or local vmx, ovf, ova file. This provider uses ovftool, so there should be a wide compatibility.
* Supports adding your VM to Resource Pools to partition CPU and memory usage from other VMs on your ESXi host.
* Pulumi will Create, Destroy, Update & Import Resource Pools.
* Pulumi will Create, Destroy, Update & Import Virtual Machines.
* Pulumi will Create, Destroy, Update & Import Virtual Disks.
* Pulumi will Create, Destroy, Update & Import Virtual Switches.
* Pulumi will Create, Destroy, Update & Import Port Groups.
## Why this provider?
If you do not have a vCenter or vSphere, especially if you are running a home lab, these services are expensive, and maybe you cannot have them, but the ESXi is free, so that is the reason behind it!
## How to install
TODO: Details will be added here
## How to use and configure
TODO: Details will be added here
## Available resources
TODO: Details will be added here
## Known issues with vmware_esxi
* Using a local source vmx files should not have any networks configured. There is very limited network interface mapping abilities in packer for vmx files.
It's best to simply clean out all network information from your vmx file. The plugin will add network configuration to the destination vm guest as required.
* pulumi import cannot import the guest disk type (thick, thin, etc.) if the VM is powered on and cannot import the guest `ipAddress` if it's powered off.
* Only `numVCpus` are supported, `numCores` is not.
* Doesn't support CD-ROM or floppy.
* Doesn't support Shared bus Interfaces, or Shared disks.
* Using an incorrect password could lockout your account using default esxi pam settings.
* Don't set `startupTimeout` or `shutdownTimeout` to 0 (zero). It's valid, however it will be changed to default values.
Raw data
{
"_id": null,
"home_page": "https://github.com/pulumiverse/pulumi-esxi-native",
"name": "pulumiverse-pulumi-esxi-native",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "esxi esxi-native vsphere infrastructure on-prem",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/96/69/077cc028f1456b1e06ce03e61c242d34996ca6ce2455f20e9e37b994f7c6/pulumiverse_pulumi-esxi-native-0.0.1.tar.gz",
"platform": null,
"description": "# Pulumi Native ESXi Provider\n\nThis repository crates a VMWare ESXi provider to provision VMs directly on an ESXi hypervisor without a need for vCenter or vSphere.\n\nThe repository is created based on the Terraform Provider [terraform-provider-esxi](https://github.com/josenk/terraform-provider-esxi/tree/master).\nThanks to the wonderful work done there by [@josenk](https://github.com/josenk), I was able to build this provider for Pulumi users.\n\n## IMPORTANT NOTES!\n\n**Note for Pull Requests (PRs)**: When creating a pull request, please do it onto the **MAIN branch** which is\nthe consolidated work-in-progress branch. Do not request it onto another branch.\n\n> **PLEASE** Read our [branch guide](branch-guide.md) to know about our branching policy\n>\n> ### CONTRIBUTING\n>\n> **IMPORTANT:** The contribution details are stated [here](CONTRIBUTING.md)\n\n## Requirements\n- The VMware [ovftool](https://customerconnect.vmware.com/downloads/get-download?downloadGroup=OVFTOOL443) is required to be installed in the workstation where pulumi will be executed. \n > **NOTE:** `ovftool` installer for windows doesn't put ovftool.exe in your path. \n You will need to manually set your path.\n- You MUST enable ssh access on your ESXi hypervisor.\n > Google 'How to enable ssh access on esxi'\n >- In general, you should know how to use terraform, esxi and some networking...\n* You will most likely need a DHCP server on your primary network if you are deploying VMs with public OVF/OVA/VMX images. (Sources that have unconfigured primary interfaces.)\n- The source OVF/OVA/VMX images must have open-vm-tools or vmware-tools installed to properly import an IPAddress. (you need this to run provisioners)\n\n## Features and Compatibility\n\n* Source image can be a clone of a VM or local vmx, ovf, ova file. This provider uses ovftool, so there should be a wide compatibility.\n* Supports adding your VM to Resource Pools to partition CPU and memory usage from other VMs on your ESXi host.\n* Pulumi will Create, Destroy, Update & Import Resource Pools.\n* Pulumi will Create, Destroy, Update & Import Virtual Machines.\n* Pulumi will Create, Destroy, Update & Import Virtual Disks.\n* Pulumi will Create, Destroy, Update & Import Virtual Switches.\n* Pulumi will Create, Destroy, Update & Import Port Groups.\n\n## Why this provider?\n\nIf you do not have a vCenter or vSphere, especially if you are running a home lab, these services are expensive, and maybe you cannot have them, but the ESXi is free, so that is the reason behind it!\n\n## How to install\n\nTODO: Details will be added here\n\n## How to use and configure\n\nTODO: Details will be added here\n\n## Available resources\n\nTODO: Details will be added here\n\n## Known issues with vmware_esxi\n\n* Using a local source vmx files should not have any networks configured. There is very limited network interface mapping abilities in packer for vmx files. \n It's best to simply clean out all network information from your vmx file. The plugin will add network configuration to the destination vm guest as required.\n* pulumi import cannot import the guest disk type (thick, thin, etc.) if the VM is powered on and cannot import the guest `ipAddress` if it's powered off.\n* Only `numVCpus` are supported, `numCores` is not.\n* Doesn't support CD-ROM or floppy.\n* Doesn't support Shared bus Interfaces, or Shared disks.\n* Using an incorrect password could lockout your account using default esxi pam settings.\n* Don't set `startupTimeout` or `shutdownTimeout` to 0 (zero). It's valid, however it will be changed to default values.\n\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "VMWare ESXi provider to provision VMs directly on an ESXi hypervisor without a need for vCenter or vSphere.",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/pulumiverse/pulumi-esxi-native",
"Repository": "https://github.com/pulumiverse/pulumi-esxi-native"
},
"split_keywords": [
"esxi",
"esxi-native",
"vsphere",
"infrastructure",
"on-prem"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9669077cc028f1456b1e06ce03e61c242d34996ca6ce2455f20e9e37b994f7c6",
"md5": "f22f2616312908c19d18f80971c25d68",
"sha256": "69e0b44021a2bd86243ebd48e7c4cc404cc2ce12d8ed30910f17095af95ac689"
},
"downloads": -1,
"filename": "pulumiverse_pulumi-esxi-native-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "f22f2616312908c19d18f80971c25d68",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 20109,
"upload_time": "2023-08-04T09:32:43",
"upload_time_iso_8601": "2023-08-04T09:32:43.388431Z",
"url": "https://files.pythonhosted.org/packages/96/69/077cc028f1456b1e06ce03e61c242d34996ca6ce2455f20e9e37b994f7c6/pulumiverse_pulumi-esxi-native-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-04 09:32:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pulumiverse",
"github_project": "pulumi-esxi-native",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pulumiverse-pulumi-esxi-native"
}
JSON
